O cmdlet Remove-WmiObject exclui uma instância de uma classe WMI (Instrumentação de Gerenciamento do Windows) existente.
Exemplos
Exemplo 1: Fechar todas as instâncias de um processo Win32
PS C:\> notepad
PS C:\> $np = Get-WmiObject -Query "select * from win32_process where name='notepad.exe'"
PS C:\> $np | Remove-WmiObject
Este exemplo fecha todas as instâncias do Notepad.exe.
O primeiro comando inicia uma instância do Bloco de Notas.
O segundo comando usa o cmdlet Get-WmiObject para recuperar as instâncias do Win32_Process que correspondem a Notepad.exee, em seguida, armazena-as na variável $np.
O terceiro comando passa o objeto na variável $np para Remove-WmiObject, que exclui todas as instâncias de Notepad.exe.
Exemplo 2: Excluir uma pasta
PS C:\> $a = Get-WMIObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
PS C:\> $a | Remove-WMIObject
Este comando exclui a pasta C:\Test.
O primeiro comando usa Get-WMIObject para consultar a pasta C:\Test e, em seguida, armazena o objeto na variável $a.
O segundo comando canaliza a variável $a para Remove-WMIObject, que exclui a pasta.
Parâmetros
-AsJob
Indica que esse cmdlet é executado como um trabalho em segundo plano.
Use esse parâmetro para executar comandos que levam muito tempo para serem concluídos.
Os novos cmdlets CIM, introduzidos no Windows PowerShell 3.0, executam as mesmas tarefas que os cmdlets WMI.
Os cmdlets CIM estão em conformidade com os padrões WS-Management (WSMan) e com o padrão CIM (Common Information Model), que permite que os cmdlets usem as mesmas técnicas para gerenciar computadores que executam o sistema operacional Windows e aqueles que executam outros sistemas operacionais.
Em vez de usar Remove-WmiObject , considere usar o cmdlet Remove-CimInstancehttps://go.microsoft.com/fwlink/?LinkId=227964.
Quando você usa o parâmetro AsJob, o comando retorna um objeto que representa o trabalho em segundo plano e, em seguida, exibe o prompt de comando.
Você pode continuar a trabalhar na sessão enquanto o trabalho termina.
Se Remove-WmiObject for usado em um computador remoto, o trabalho será criado no computador local e os resultados dos computadores remotos serão retornados automaticamente ao computador local.
Para gerenciar o trabalho, use os cmdlets que contêm o substantivo Job (os cmdlets Job).
Para obter os resultados do trabalho, use o cmdlet Receive-Job.
Para usar esse parâmetro para computadores remotos, os computadores locais e remotos devem ser configurados para comunicação remota.
Inicie o Windows PowerShell usando a opção Executar como administrador.
Para obter mais informações, consulte about_Remote_Requirements.
Para obter mais informações sobre trabalhos em segundo plano do Windows PowerShell, consulte about_Jobs e about_Remote_Jobs.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Authentication
Especifica o nível de autenticação a ser usado para a conexão WMI.
Os valores aceitáveis para este parâmetro são:
-1: Inalterado.
0: Padrão.
1: Nenhuma.
Nenhuma autenticação em executada.
2: Conecte-se.
A autenticação é realizada somente quando o cliente estabelece um relacionamento com o aplicativo.
3: Ligue.
A autenticação é realizada somente no início de cada chamada, quando o aplicativo recebe a solicitação.
4: Pacote.
A autenticação é realizada em todos os dados recebidos do cliente.
5: PacketIntegrity.
Todos os dados transferidos entre o cliente e o aplicativo são autenticados e verificados.
6: PacketPrivacy.
As propriedades dos outros níveis de autenticação são usadas e todos os dados são criptografados.
Especifica a autoridade a ser usada para autenticar a conexão WMI.
Você pode especificar a autenticação NTLM ou Kerberos padrão.
Para usar NTLM, defina a configuração de autoridade como ntlmdomain:<DomainName>, onde <DomainName> identifica um nome de domínio NTLM válido.
Para usar Kerberos, especifique kerberos:<DomainName>\<ServerName>.
Não é possível incluir a configuração de autoridade quando você se conecta ao computador local.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
class
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
path
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
WQLQuery
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
query
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
list
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Class
Especifica o nome de uma classe WMI que esse cmdlet exclui.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
class
Position:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ComputerName
Especifica o nome do computador no qual esse cmdlet é executado.
O padrão é o computador local.
Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado de um ou mais computadores.
Para especificar o computador local, digite o nome do computador, um ponto (.) ou localhost.
Esse parâmetro não depende da comunicação remota do Windows PowerShell.
Você pode usar o parâmetro ComputerName mesmo que o computador não esteja configurado para executar comandos remotos.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
CN
Conjuntos de parâmetros
class
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
path
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
WQLQuery
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
query
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
list
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
False
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
Cf.
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Credential
Especifica uma conta de usuário que tem permissão para executar essa ação.
O padrão é o usuário atual.
Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential , como um gerado pelo cmdlet Get-Credential.
Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.
Propriedades dos parâmetros
Tipo:
PSCredential
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
class
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
path
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
WQLQuery
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
query
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
list
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-EnableAllPrivileges
Indica que esse cmdlet habilita todas as permissões do usuário atual antes do comando que ele faz a chamada WMI.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
class
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
path
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
WQLQuery
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
query
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
list
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Impersonation
Especifica o nível de representação a ser usado.
Os valores aceitáveis para este parâmetro são:
0: Padrão.
Lê o registro local para o nível de representação padrão, que geralmente é definido como 3: Representar.
1: Anônimo.
Oculta as credenciais do chamador.
2: Identificar.
Permite que os objetos consultem as credenciais do chamador.
3: Personificar.
Permite que os objetos usem as credenciais do chamador.
4: Delegar.
Permite que outros objetos usem as credenciais do chamador.
Especifica um ManagementObject objeto a ser usado como entrada.
Quando esse parâmetro é usado, todos os outros parâmetros são ignorados.
Propriedades dos parâmetros
Tipo:
ManagementObject
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
object
Position:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Locale
Especifica a localidade preferida para objetos WMI.
O parâmetro Locale é especificado como uma matriz no formato< LCID MS_>na ordem preferida.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
class
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
path
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
WQLQuery
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
query
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
list
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Namespace
Especifica o namespace do repositório WMI onde a classe WMI referenciada está localizada quando é usada com o parâmetro Class.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
NS
Conjuntos de parâmetros
class
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
path
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
WQLQuery
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
query
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
list
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Path
Especifica o caminho do objeto WMI de uma classe WMI ou especifica o caminho do objeto WMI de uma instância de uma classe WMI a ser excluída.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
path
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ThrottleLimit
Especifica o número máximo de conexões simultâneas que podem ser estabelecidas para executar esse comando.
Este parâmetro é usado em conjunto com o parâmetro AsJob.
O limite de aceleração aplica-se apenas ao comando atual, não à sessão ou ao computador.
Propriedades dos parâmetros
Tipo:
Int32
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
False
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
Wi
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.