Desconecta o cliente do serviço WinRM em um computador remoto.
Sintaxe
Disconnect-WSMan [-ComputerName <string>] [<CommonParameters>]
Descrição
O cmdlet Disconnect-WSMan desconecta o cliente do serviço WinRM em um computador remoto. Se você salvou a sessão do WS-Management em uma variável, o objeto da sessão permanece na variável, mas o estado da sessão do WS-Management é "Fechado". Você pode usar este cmdlet no contexto do provedor WS-Management para desconectar o cliente do serviço WinRM em um computador remoto. No entanto, você também pode usar este cmdlet para desconectar-se do serviço WinRM em computadores remotos antes de alterar para o provedor WS-Management.
Para obter mais informações sobre como conectar-se ao serviço WinRM em um computador remoto, consulte Connect-WSMan.
Parâmetros
-ComputerName <string>
Especifica o computador do qual você deseja desconectar-se. 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, o host local ou um ponto (.) para especificar o computador local. O padrão é o computador local. Quando o computador remoto está em um domínio diferente do usuário, um nome de domínio totalmente qualificado deve ser usado. É possível canalizar um valor para este parâmetro para o cmdlet.
Nota: você não pode desconectar-se do host local (a conexão padrão com o computador local). Porém, se uma conexão separada for feita com o computador local (por exemplo, usando o nome do computador), você poderá remover essa conexão usando o cmdlet Disconnect-WSMan.
Necessário? |
false |
Posição? |
named |
Valor padrão |
localhost |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
None Este cmdlet não aceita entrada. |
Saídas |
None Este cmdlet não gera saída. |
Exemplo 1
C:\PS>Disconnect-WSMan -computer server01 C:\PS> cd WSMan: PS WSMan:\> PS WSMan:\> dir WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan ComputerName Type ------------ ---- localhost Container Descrição ----------- Este comando exclui a conexão com o computador remoto server01. Este cmdlet é geralmente usado no contexto do provedor WS-Management para desfazer a conexão com um computador remoto, neste caso o computador server01. No entanto, você também pode usar o cmdlet Disconnect-WSMan para remover conexões com computadores remotos antes de alterar para o provedor WSMan. Essas conexões não aparecerão na lista de ComputerName.
See Also