Remove-CimSession
Remove uma ou mais sessões CIM.
Syntax
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
Esse cmdlet só está disponível na plataforma Windows.
O Remove-CimSession
cmdlet 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 valor Id 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 gerar a saída do que aconteceria se ela fosse feita.
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 crie ou obtenha a sessão CIM, como os New-CimSession
cmdlets ou Get-CimSession
.
Para obter mais informações, consulte about_CimSessions.
Type: | CimSession[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 range (..
) 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 intervalo, consulte about_Operators.
Type: | UInt32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Especifica a ID da instância da sessão CIM a ser removida. InstanceId é um GUID (Identificador Globalmente 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.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica o nome amigável da sessão CIM a ser removida. Você pode usar caracteres curinga com esse parâmetro.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Não é possível canalizar objetos para esse cmdlet.
Saídas
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
Esse cmdlet só está disponível em plataformas Windows.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de