Remove-CimSession
Remove uma ou mais sessões CIM.
Sintaxe
CimSessionSet (Default)
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
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
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.
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 o nome do computador ao qual as sessões CIM são conectadas. Caracteres curinga são permitidos.
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.
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 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. 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.
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
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.