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
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 CIM
Este exemplo recupera todas as sessões CIM disponíveis no computador local usando o cmdlet Get-CimSession e as remove usando o Remove-CimSession.
Get-CimSession | Remove-CimSession
Exemplo 2: Remover uma sessão CIM específica
Este exemplo remove a sessão CIM que tem um Id com um valor 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 o que aconteceria se fosse feita.
Remove-CimSession -Name a* -WhatIf
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: | |
| 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 uma matriz de nomes de computadores. Remove as sessões que se conectam aos computadores especificados. Você pode especificar um nome de domínio totalmente qualificado (FQDN) ou um nome NetBIOS.
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 um ou mais IDs separados por vírgulas ou use o operador de intervalo (..) para especificar um intervalo de IDs. Um Id é um número inteiro que identifica exclusivamente a sessão CIM 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
Não é possível canalizar objetos para este cmdlet.
Saídas
Object
Este cmdlet retorna um objeto que contém informações de sessão do CIM.
Notas
O PowerShell inclui os seguintes aliases para Remove-CimSession:
- Windows:
rcms
Este cmdlet só está disponível em plataformas Windows.