Remove-ItemProperty
Exclui a propriedade e seu valor de um item.
Remove-ItemProperty
[-Path] <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Remove-ItemProperty
-LiteralPath <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
O Remove-ItemProperty
cmdlet exclui uma propriedade e seu valor de um item.
Você pode usá-lo para excluir valores do Registro e os dados que eles armazenam.
Este comando elimina o valor de registo "SmpProperty" e os seus dados da subchave "SmpApplication" da chave de registo "HKEY_LOCAL_MACHINE\Software".
Como o comando é emitido a partir de uma unidade do sistema de arquivos (PS C:\>
), ele inclui o caminho totalmente qualificado da subchave "SmpApplication", incluindo a unidade HKLM:
e a chave "Software".
Ele usa o parâmetro Name para identificar o valor do Registro que está sendo excluído.
Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"
Esses comandos excluem o valor do Registro "Opções" e seus dados da subchave "MyApp" de "HKEY_CURRENT_USER\Software\MyCompany".
O primeiro comando usa o Set-Location
cmdlet para alterar o local atual para a unidade HKEY_CURRENT_USER (HKCU:
) e a subchave "Software\MyCompany\MyApp".
O segundo comando é usado Remove-ItemProperty
para remover o valor do Registro "Options" e seus dados da subchave "MyApp".
Como Path é necessário, o comando usa um ponto ('.') para indicar o local atual.
Ele usa Name para especificar qual valor do Registro deve ser excluído.
Ele usa o parâmetro Confirm para solicitar um prompt do usuário antes de excluir o valor.
PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm
Este comando elimina o valor de registo "NoOfEmployees" e os seus dados da chave de registo "HKLM\Software\MyCompany".
O comando usa o Get-Item
cmdlet para obter um item que representa a chave do Registro.
Ele usa um operador de pipeline (|
) para enviar o objeto para Remove-ItemProperty
.
Em seguida, ele usa o parâmetro Name de Remove-ItemProperty
para especificar o nome do valor do Registro.
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees
Solicita a sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Nota
Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.
Tipo: | PSCredential |
Position: | Named |
Default value: | Current user |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica os itens que este cmdlet omite. O valor desse parâmetro qualifica o parâmetro Path . Insira um elemento ou padrão de caminho, como "*.txt". Caracteres curinga são permitidos.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | True |
Especifica um filtro no formato ou idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path .
A sintaxe do filtro, incluindo o uso de caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros, porque o provedor os aplica quando o cmdlet obtém os objetos em vez de fazer com que o PowerShell filtre os objetos depois que eles são recuperados.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | True |
Força o cmdlet a remover uma propriedade de um objeto que não pode ser acessado pelo usuário de outra forma. A implementação varia de fornecedor para fornecedor. Para obter mais informações, consulte about_Providers.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor desse parâmetro qualifica o parâmetro Path . Insira um elemento ou padrão de caminho, como "*.txt". Caracteres curinga são permitidos.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | True |
Especifica o caminho para o local atual da propriedade. Ao contrário do parâmetro Path , o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.
Tipo: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica os nomes das propriedades a serem removidas. Caracteres curinga são permitidos.
Tipo: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | True |
Especifica o caminho do item cujas propriedades estão sendo removidas. Caracteres curinga são permitidos.
Tipo: | String[] |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | True |
Inclui o comando na transação ativa. Este parâmetro é válido somente quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Tipo: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Você pode canalizar uma cadeia de caracteres que contém um caminho, mas não um caminho literal, para esse cmdlet.
None
Este cmdlet não retorna nenhuma saída.
O Windows PowerShell inclui os seguintes aliases para Remove-ItemProperty
:
rp
No provedor do Registro do PowerShell, os valores do Registro são considerados propriedades de uma chave ou subchave do Registro. Você pode usar os cmdlets ItemProperty para gerenciar esses valores.
Remove-ItemProperty
é projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider
. Para obter mais informações, consulte about_Providers.
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: