Partilhar via


Disconnect-WSMan

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

Sintaxe

Default (Predefinição)

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

Description

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

O cmdlet Disconnect-WSMan 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 session permanecerá na variável, mas o estado da sessão WS-Management será Closed. Você pode usar esse cmdlet no contexto do provedor WSMan para desconectar o cliente do serviço WinRM em um computador remoto. No entanto, você também pode usar esse cmdlet para se desconectar do serviço WinRM em computadores remotos antes de mudar 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: Eliminar uma ligação a 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

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

Esse cmdlet geralmente é usado no 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 ComputerName.

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, você deve usar um nome de domínio totalmente qualificado deve ser usado. Você pode canalizar um valor para esse parâmetro para o cmdlet.

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
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

None

Este cmdlet não retorna nenhuma saída.