Compartilhar via

Remove-CimSession

Módulo:
CimCmdlets Module

Remove uma ou mais sessões CIM.

Sintaxe

CimSessionSet (Padrão) 

Remove-CimSession
    [-CimSession] <CimSession[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerNameSet 

Remove-CimSession
    [-ComputerName] <String[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SessionIdSet 

Remove-CimSession
    [-Id] <UInt32[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstanceIdSet 

Remove-CimSession
    -InstanceId <Guid[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameSet 

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 com um valor de ID igual a 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.

Propriedades do parâmetro

Tipo:

CimSession[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CimSessionSet
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False
Aliases:China, Nome do Servidor

Conjuntos de parâmetros

ComputerNameSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

UInt32[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SessionIdSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 há várias sessões em execução no PowerShell.

A InstanceID é armazenada na propriedade InstanceID do objeto que representa uma sessão CIM.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

InstanceIdSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

NameSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Não é possível transferir objetos para esse 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

Este cmdlet está disponível apenas em plataformas Windows.