Compartilhar via

Remove-CimSession

  • Referência
Módulo:
CimCmdlets

Remove uma ou mais sessões CIM.

Sintaxe

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

O cmdlet Remove-CimSession remove um ou mais objetos de sessão CIM da sessão local do PowerShell.

Exemplos

Exemplo 1: remover todas as sessões de CIM

Este exemplo recupera todas as sessões CIM disponíveis no computador local usando o cmdlet Get-CimSession e, em seguida, as remove usando o .

Get-CimSession | Remove-CimSession

Exemplo 2: Remover uma sessão CIM específica

Este exemplo remove a sessão CIM que tem um valor ID de 5.

Remove-CimSession -Id 5

Exemplo 3: Mostrar a lista de sessões CIM a serem removidas usando o parâmetro WhatIf

Este exemplo usa o parâmetro comum WhatIf para especificar que a remoção não deve ser feita, mas apenas gerará o que aconteceria se fosse feito.

Remove-CimSession -Name a* -WhatIf

Parâmetros

-CimSession

Especifica os objetos de sessão das sessões CIM a serem fechadas.

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_CimSessions.

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

-ComputerName

Especifica uma matriz de nomes de computadores. Remove as sessões que se conectam aos computadores especificados. Você pode especificar um FQDN (nome de domínio totalmente qualificado) ou um nome NetBIOS.

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

-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

-Id

Especifica a ID da sessão CIM a ser removida. Especifique uma ou mais IDs separadas por vírgulas ou use o operador de intervalo (..) para especificar um intervalo de IDs. Um Id é um inteiro que identifica exclusivamente a sessão CIM na sessão atual do PowerShell.

Para obter mais informações sobre o operador de alcance, consulte about_Operators.

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

-InstanceId

Especifica a ID da instância da sessão CIM a ser removida. InstanceId é um GUID (Identificador Global exclusivo) que identifica exclusivamente uma sessão CIM. O InstanceId é exclusivo, mesmo quando você tem várias sessões em execução no PowerShell.

O InstanceId é armazenado na propriedade InstanceId do objeto que representa uma sessão CIM.

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

-Name

Especifica o nome amigável da sessão CIM a ser removida. Você pode usar caracteres curinga com esse parâmetro.

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

-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

Object

Esse cmdlet retorna um objeto que contém informações de sessão CIM.

Observações

O PowerShell inclui os seguintes aliases para Remove-CimSession:

  • Windows:
    • rcms

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