Disconnect-WSMan

  • Referência
Módulo:
Microsoft.WSMan.Management

Desconecta o cliente do serviço WinRM em um computador remoto.

Syntax

Disconnect-WSMan
          [[-ComputerName] <String>]
          [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O Disconnect-WSMan cmdlet desconecta o cliente do serviço WinRM em um computador remoto. Se você salvou a sessão WS-Management em uma variável, o objeto de sessão permanecerá na variável, mas o estado da sessão WS-Management será Fechado. Você pode usar este cmdlet dentro do contexto do provedor WSMan para desconectar o cliente do serviço WinRM em um computador remoto. No entanto, você também pode usar este cmdlet para desconectar o serviço do WinRM em computadores remotos antes de alterar para o provedor WSMan.

Para obter mais informações sobre como se conectar ao serviço WinRM em um computador remoto, consulte Connect-WSMan.

Exemplos

Exemplo 1: Excluir uma conexão com um computador remoto

PS C:\> Disconnect-WSMan -computer server01
PS C:\> cd WSMan:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container

Esse comando exclui a conexão com o computador remoto chamado server01.

Este cmdlet geralmente é usado dentro do contexto do provedor WSMan para se desconectar de um computador remoto, neste caso, o computador server01. No entanto, você também pode usar Disconnect-WSMan para remover conexões com computadores remotos antes de alterar para o provedor WSMan. Essas conexões não aparecem na lista NomeDoComputador.

Parâmetros

-ComputerName

Especifica o computador no qual executar a operação de gerenciamento. O valor pode ser um nome de domínio totalmente qualificado, um nome NetBIOS ou um endereço IP. Use o nome do computador local, use localhost ou use um ponto (.) para especificar o computador local. O computador local é o padrão. Quando o computador remoto está em um domínio diferente do usuário, deve-se usar um nome de domínio totalmente qualificado. É possível redirecionar um valor desse parâmetro para o cmdlet.

Não é possível se desconectar do host local. Ou seja, você não pode desconectar a conexão padrão para o computador local. No entanto, se você criar uma conexão separada com o computador local, por exemplo, usando o nome do computador.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Não é possível canalizar objetos para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.