Compartilhar via

Remove-CimInstance

  • Referência
Módulo:
CimCmdlets

Remove uma instância cim de um computador.

Sintaxe

Remove-CimInstance
      [-ResourceUri <Uri>]
      [-ComputerName <String[]>]
      [-OperationTimeoutSec <UInt32>]
      [-InputObject] <CimInstance>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      -CimSession <CimSession[]>
      [-ResourceUri <Uri>]
      [-OperationTimeoutSec <UInt32>]
      [-InputObject] <CimInstance>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      -CimSession <CimSession[]>
      [[-Namespace] <String>]
      [-OperationTimeoutSec <UInt32>]
      [-Query] <String>
      [-QueryDialect <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimInstance
      [-ComputerName <String[]>]
      [[-Namespace] <String>]
      [-OperationTimeoutSec <UInt32>]
      [-Query] <String>
      [-QueryDialect <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Este cmdlet só está disponível na plataforma Windows.

Esse cmdlet remove uma instância cim de um servidor CIM. Você pode especificar a instância cim a ser removida usando um objeto de instância CIM recuperado pelo cmdlet Get-CimInstance ou especificando uma consulta.

Se o parâmetro InputObject não for especificado, o cmdlet funcionará de uma das seguintes maneiras:

  • Se nem o parâmetro ComputerName nem o parâmetro CimSession for especificado, esse cmdlet funcionará na WMI (Instrumentação de Gerenciamento do Windows) local usando uma sessão COM (Component Object Model).
  • Se o parâmetro ComputerName ou o parâmetro CimSession for especificado, esse cmdlet funcionará no servidor CIM especificado pelo parâmetro ComputerName ou o parâmetro CimSession.

Exemplos

Exemplo 1: remover a instância do CIM

Este exemplo usa o parâmetro de consulta para remover instâncias CIM da classe chamada Win32_Environment que começam com a cadeia de caracteres testvar.

Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'

Exemplo 2: remover a instância cim usando o objeto de instância CIM

Este exemplo recupera os objetos da instância cim filtrados pelo parâmetro Query e os armazena em uma variável chamada $var usando o cmdlet Get-CimInstance. Em seguida, o conteúdo da variável é passado para o cmdlet Remove-CimInstance, que remove as instâncias de CIM.

notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var

Parâmetros

-CimSession

Executa o comando usando a sessão CIM especificada. Insira uma variável que contenha a sessão CIM ou um comando que cria ou obtém a sessão CIM, como os cmdlets New-CimSession ou Get-CimSession. Para obter mais informações, consulte about_CimSession.

Tipo:CimSession[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ComputerName

Especifica o nome do computador no qual você deseja executar a operação CIM. Você pode especificar um FQDN (nome de domínio totalmente qualificado) ou um nome NetBIOS.

Se você especificar esse parâmetro, o cmdlet criará uma sessão temporária para o computador especificado usando o protocolo WsMan.

Se você não especificar esse parâmetro, o cmdlet executará a operação no computador local usando COM (Component Object Model).

Se várias operações estiverem sendo executadas no mesmo computador, conectar-se usando uma sessão CIM oferecerá melhor desempenho.

Tipo:String[]
Aliases:CN, ServerName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de instância CIM a ser removido do servidor CIM. O objeto passado para o cmdlet não é alterado, apenas a instância no servidor CIM é removida.

O parâmetro InputObject não enumera em coleções. Se uma coleção for passada, um erro será gerado. Ao trabalhar com coleções, redirecione a entrada para enumerar os valores.

Tipo:CimInstance
Aliases:CimInstance
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Namespace

Especifica o namespace para a operação CIM. O namespace padrão é root/cimv2. Você pode usar a conclusão da guia para procurar a lista de namespaces, pois o PowerShell obtém uma lista de namespaces do servidor WMI local para fornecer a lista de namespaces.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OperationTimeoutSec

Especifica a quantidade de tempo que o cmdlet aguarda uma resposta do computador. Por padrão, o valor desse parâmetro é 0, o que significa que o cmdlet usa o valor de tempo limite padrão para o servidor.

Se o parâmetro OperationTimeoutSec for definido como um valor menor que o tempo limite de repetição de conexão robusto de 3 minutos, as falhas de rede que duram mais do que o valor do parâmetro OperationTimeoutSec não serão recuperáveis, pois a operação no servidor atinge o tempo limite antes que o cliente possa se reconectar.

Tipo:UInt32
Aliases:OT
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Query

Especifica uma consulta a ser executada no servidor CIM. Você pode especificar o dialeto de consulta usando o parâmetro QueryDialect.

Se o valor especificado contiver aspas duplas ("), aspas simples (') ou uma barra invertida (\), você deverá escapar desses caracteres prefixando-os com o caractere de barra invertida (\). Se o valor especificado usar o operador LIKE WQL, você deverá escapar dos seguintes caracteres colocando-os entre colchetes ([]): porcentagem (%), sublinhado (_) ou abrir colchete ([).

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-QueryDialect

Especifica a linguagem de consulta usada para o parâmetro De consulta. Os valores aceitáveis para esse parâmetro são: WQL ou CQL. O valor padrão é WQL.

Tipo:String
Cargo:Named
Valor padrão:WQL
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceUri

Especifica o URI (identificador de recurso) uniforme do recurso da classe de recurso ou instância. O URI é usado para identificar um tipo específico de recurso, como discos ou processos, em um computador.

Um URI consiste em um prefixo e um caminho para um recurso. Por exemplo:

  • http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
  • http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Por padrão, se você não especificar esse parâmetro, o URI de recurso padrão DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ será usado e o nome da classe será acrescentado a ele.

O ResourceURI só pode ser usado com sessões CIM criadas usando o protocolo WSMan ou ao especificar o parâmetro ComputerName, que cria uma sessão CIM usando o WSMan. Se você especificar esse parâmetro sem especificar o parâmetro ComputerName ou se especificar uma sessão CIM criada usando o protocolo DCOM, receberá um erro, pois o protocolo DCOM não dá suporte ao parâmetro ResourceURI.

Se o parâmetro ResourceUri e o parâmetro Filter forem especificados, o parâmetro de filtro de será ignorado.

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Você não pode redirecionar objetos para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O PowerShell inclui os seguintes aliases para Remove-CimInstance:

  • Windows:
    • rcim

Esse cmdlet só está disponível em plataformas Windows.