Remove-CimSession
Remove uma ou mais sessões CIM.
Sintaxe
CimSessionSet (Predefiniçã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
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 CIM
Get-CimSession | Remove-CimSession
Este comando recupera todas as sessões CIM disponíveis no computador local usando o cmdlet Get-CimSession e as remove usando o Remove-CimSession.
Exemplo 2: Remover uma sessão CIM específica
Remove-CimSession -Id 5
Este comando remove a sessão CIM que tem um valor de ID de 5.
Exemplo 3: Mostrar a lista de sessões CIM a serem removidas usando o parâmetro WhatIf
Remove-CimSession -Name a* -WhatIf
Este comando usa o parâmetro comum WhatIf para especificar que a remoção não deve ser feita, mas apenas o que aconteceria se fosse feita.
Parâmetros
-CimSession
Especifica os objetos de sessão das sessões CIM a serem encerradas.
Insira uma variável que contenha a sessão CIM ou um comando que crie ou obtenha a sessão CIM, como os cmdlets New-CimSession ou Get-CimSession.
Para obter mais informações, consulte about_CimSessions.
Propriedades dos parâmetros
| Tipo: | CimSession[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
CimSessionSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ComputerName
Especifica o nome do computador ao qual as sessões CIM serão conectadas. Caracteres coringa são permitidos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
| Aliases: | China, Nome do servidor |
Conjuntos de parâmetros
ComputerNameSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 número inteiro que identifica exclusivamente a sessão CIM na sessão atual do PowerShell. É mais fácil lembrar e digitar do que InstanceId, mas é exclusivo apenas na sessão atual do PowerShell.
Para obter mais informações sobre o operador de intervalo, consulte about_Operators.
Propriedades dos parâmetros
| Tipo: | UInt32[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SessionIdSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-InstanceId
Especifica o 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.
Propriedades dos parâmetros
| Tipo: | Guid[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InstanceIdSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome amigável da sessão CIM a ser removida. Você pode usar caracteres curinga com esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Este cmdlet não aceita objetos de entrada.
Saídas
Object
Este cmdlet retorna um objeto que contém informações de sessão do CIM.