Remove-WmiObject

Exclui uma instância de classe WMI (Instrumentação de Gerenciamento do Windows) existente.

Sintaxe

Remove-WmiObject [-Class] <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject -InputObject <ManagementObject> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject -Path <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Remove-WmiObject exclui uma instância de uma classe WMI existente.

Parâmetros

-AsJob

Executa o comando como um trabalho em segundo plano. Use esse parâmetro para executar comandos que demoram a ser concluídos.

Executa o comando como um trabalho em segundo plano. Use este parâmetro para executar comandos que demoram a ser concluídos.

Quando você usa o parâmetro AsJob, o comando retorna um objeto que representa o trabalho de segundo plano e, em seguida, exibe o prompt de comando. É possível continuar a trabalhar na sessão enquanto o trabalho é concluído. Se Remove-WmiObject for usado em relação a um computador remoto, o trabalho será criado no computador local e os resultados dos computadores remotos serão automaticamente retornados para o computador local. Para gerenciar o trabalho, use os cmdlets que contêm o nome Job (os cmdlets Job). Para obter os resultados do trabalho, use o cmdlet Receive-Job.

Observação: para usar esse parâmetro com computadores remotos, os computadores local e remoto deverão ser configurados para comunicação remota. Além disso, você precisa iniciar o Windows PowerShell usando a opção "Executar como administrador" no Windows Vista e em versões mais recentes do Windows. Para obter mais informações, consulte about_Remote_Requirements.

Para obter mais informações sobre os trabalhos em segundo plano do Windows PowerShell, consulte about_Jobs e about_Remote_Jobs.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Authentication <AuthenticationLevel>

Especifica o nível de autenticação a ser usado com a conexão WMI. Os valores válidos são:

-1: Unchanged

0: Default

1: None (nenhuma autenticação é executada)

2: Connect (a autenticação é executada somente quando o cliente estabelece um relacionamento com o aplicativo)

3: Call (a autenticação é executada somente no início de cada chamada, quando o aplicativo recebe a solicitação)

4: Packet (a autenticação é executada 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)

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Authority <string>

Especifica a autoridade a ser usada para autenticar a conexão WMI. Você pode especificar a autenticação padrão NTLM ou Kerberos. Para usar NTLM, defina a configuração de autoridade como “ntlmdomain:<DomainName>”, em que <DomainName> identifica um nome de domínio NTLM válido. Para usar Kerberos, especifique “kerberos:<DomainName>\<ServerName>”. Você não pode incluir a configuração de autoridade quando estiver conectado ao computador local.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Class <string>

Especifica o nome de uma classe WMI a ser excluída.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-ComputerName <string[]>

Especifica o computador em relação ao qual você deseja executar a operação de gerenciamento. O valor pode ser um nome de domínio totalmente qualificado, um nome NetBIOS ou um endereço IP. Use o nome do computador local, o host local ou um ponto (.) para especificar o computador local. O padrão é o computador local. Quando o computador remoto está em um domínio diferente do usuário, um nome de domínio totalmente qualificado deve ser usado. Você pode definir o valor deste parâmetro enviando-o ao parâmetro.

Este parâmetro não se baseia na comunicação remota do Windows PowerShell, que usa WS-Management. Você pode usar o parâmetro ComputerName de Get-WmiObject mesmo que o seu computador não esteja configurado para executar comandos remotos do WS-Management.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Credential <PSCredential>

Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual. Digite um nome de usuário, como “User01”, “Domain01\User01” ou “User@Contoso.com”. Ou, insira um objeto PSCredential, como aquele retornado pelo cmdlet Get-Credential. Quando você digitar um nome de usuário, uma senha será solicitada.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-EnableAllPrivileges

Habilita todos os privilégios do usuário atual antes de o comando fazer a chamada WMI.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Impersonation <ImpersonationLevel>

Especifica o nível de representação a ser usado. Os valores válidos são:

0: Default (lê o Registro local para o nível de representação padrão, que é normalmente definido como "3: Impersonate")

1: Anonymous (oculta as credenciais do chamador)

2: Identify (permite que os objetos consultem as credenciais do chamador)

3: Impersonate (permite que os objetos usem as credenciais do chamador)

4: Delegate (permite que objetos autorizem outros objetos a usarem as credenciais do chamador)

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-InputObject <ManagementObject>

Especifica um objeto ManagementObject a ser usado como entrada. Quando este parâmetro é usado, todos os outros parâmetros são ignorados.

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Locale <string>

Especifica a localidade preferencial para objetos WMI. O parâmetro Locale é especificado como uma matriz do formato MS_<LCID> na ordem preferencial.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Namespace <string>

Quando usado com o parâmetro Class, esse parâmetro especifica o namespace do repositório WMI onde a classe WMI referenciada está localizada.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Path <string>

Especifica o caminho do objeto WMI de uma classe WMI ou de uma instância de uma classe WMI a ser excluída.

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-ThrottleLimit <int>

Permite que o usuário especifique um valor de limitação para o número de operações WMI que podem ser executadas simultaneamente. Este parâmetro é usado com o parâmetro AsJob. O limite se aplica somente ao comando atual, não à sessão ou ao computador.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	System.Management.ManagementObject É possível enviar um objeto de gerenciamento para o Remove-WmiObject.
Saídas	Nenhum ou System.Management.Automation.RemotingJob Quando você usa o parâmetro AsJob, esse cmdlet retorna um objeto de trabalho. Caso contrário, ele não gera nenhuma saída.

Exemplo 1

C:\PS>notepad   
C:\PS> $np = get-wmiobject -query "select * from win32_process where name='notepad.exe'"
C:\PS> $np | remove-wmiobject

Descrição
-----------
Esse comando fecha todas as instâncias 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 de Win32_Process que corresponde a Notepad.exe e as armazena na variável $np. 

O terceiro comando transmite o objeto na variável $np para o cmdlet Remove-WmiObject, que exclui todas as instâncias de Notepad.exe.

Exemplo 2

C:\PS>$a = Get-WMIObject -query "Select * From Win32_Directory Where Name ='C:\\Test'"
C:\PS> $a | Remove-WMIObject

Descrição
-----------
Esse comando exclui o diretório C:\Test.

O primeiro comando usa o cmdlet Get-WMIObject para consultar o diretório C:\Test e, em seguida, armazena o objeto na variável $a.

O segundo comando envia a variável $a para o Remove-WMIObject que exclui o diretório.

Consulte também

Conceitos

Get-WmiObject
Invoke-WmiMethod
Set-WmiInstance
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance