Compartilhar via


Disconnect-WSMan

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

Nenhum

Este cmdlet não aceita entrada.

Saídas

Nenhum

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.





Consulte também

Conceitos

Connect-WSMan
Disable-WSManCredSSP
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan