Remove-WmiObject

Sintaxe

class (Default)

Remove-WmiObject
    [-Class] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

object

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

path

Remove-WmiObject
    -Path <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WQLQuery

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

query

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

list

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: fechar todas as instâncias de um processo do Win32

notepad
$np = Get-WmiObject -Query "select * from Win32_Process where name='notepad.exe'"
$np | Remove-WmiObject

Exemplo 2: excluir uma pasta

$a = Get-WmiObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
$a | Remove-WmiObject

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.

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 do 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-CimInstance.

Quando você usa o parâmetro AsJob, o comando retorna um objeto que representa o trabalho em segundo plano e exibe o prompt de comando. Você pode continuar a trabalhar na sessão enquanto o trabalho é concluído. Se Remove-WmiObject for usado em um computador remoto, o trabalho será criado no computador local e os resultados de computadores remotos serão retornados automaticamente para o computador local. Para gerenciar o trabalho, use os cmdlets que contêm o substantivo Job (os cmdlets de Trabalho ). 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, confira about_Remote_Requirements.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-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: Predefinição.
• 1: Nenhum. Nenhuma autenticação em execução.
• 2: Conectar. A autenticação é executada somente quando o cliente estabelece uma relação com o aplicativo.
• 3: Chamada. A autenticação é executada somente no início de cada chamada quando o aplicativo recebe a solicitação.
• 4: Pacote. 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Authority

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 o 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 ao se conectar ao computador local.

Propriedades do parâmetro

Conjuntos de parâmetros

-Class

Especifica o nome de uma classe WMI que esse cmdlet exclui.

Propriedades do parâmetro

Conjuntos de parâmetros

-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 se o computador não estiver configurado para executar comandos remotos.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-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 do parâmetro

Conjuntos de parâmetros

-EnableAllPrivileges

Indica que esse cmdlet habilita todas as permissões do usuário atual antes do comando que ele faz a chamada WMI.

Propriedades do parâmetro

Conjuntos de parâmetros

-Impersonation

Especifica o nível de representação a ser usado. Os valores aceitáveis para este parâmetro são:

• 0: Predefinição. Lê o registro local para o nível de representação padrão, que geralmente é definido como 3: Representação.
• 1: Anônimo. Oculta as credenciais do chamador.
• 2: identificar. Permite que os objetos consultem as credenciais do chamador.
• 3: Representar. Permite que os objetos usem as credenciais do chamador.
• 4: Delegado. Permite que os objetos permitam que outros objetos usem as credenciais do chamador.

Propriedades do parâmetro

Conjuntos de parâmetros

-InputObject

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Locale

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Namespace

Especifica o namespace do repositório WMI em que a classe WMI referenciada está localizada quando é usada com o parâmetro classe .

Propriedades do parâmetro

Conjuntos de parâmetros

-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 do parâmetro

Conjuntos de parâmetros

-ThrottleLimit

Especifica o número máximo de conexões simultâneas que podem ser estabelecidas para executar esse comando. Esse parâmetro é usado junto com o parâmetro asJob . O limite de limitação se aplica somente ao comando atual, não à sessão ou ao computador.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

ManagementObject

Saídas

None, System.Management.Automation.RemotingJob

Observações

Links Relacionados

• Get-WmiObject
• Invoke-WmiMethod
• Set-WmiInstance