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

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

Get-CimSession | Remove-CimSession

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

Exemplo 2: remover uma sessão cim específica

Remove-CimSession -Id 5

Esse comando remove a sessão CIM que tem um valor de ID 5.

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

Remove-CimSession -Name a* -WhatIf

Esse comando 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.

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 o nome do computador ao qual as sessões CIM são conectadas. Caracteres curinga são permitidos.

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.

Uma ID é um inteiro que identifica exclusivamente a sessão CIM na sessão atual do PowerShell. É mais fácil de lembrar e digitar do que InstanceId, mas é exclusivo apenas dentro da sessão atual do PowerShell.

Para obter mais informações sobre o operador de intervalo, 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. A InstanceId é exclusiva, mesmo quando você tem várias sessões em execução no PowerShell.

A InstanceId é armazenada 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

Esse cmdlet não aceita objetos de entrada.

Saídas

Object

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