Partilhar via

Usando a comunicação remota do WS-Management (WSMan) no PowerShell

  • Artigo

Ativar a comunicação remota do PowerShell

Para habilitar a comunicação remota do PowerShell, execute o cmdlet Enable-PSRemoting em uma sessão elevada do PowerShell. A execução de Enable-PSRemoting configura um ponto de extremidade remoto para a versão de instalação específica na qual está a executar o cmdlet. Por exemplo, quando você executa Enable-PSRemoting enquanto executa o PowerShell 7.4, o PowerShell cria um ponto de extremidade remoto que executa o PowerShell 7.4. Se você executar o Enable-PSRemoting enquanto executa o PowerShell 7-preview, o PowerShell criará um ponto de extremidade remoto que executa o PowerShell 7-preview. Você pode criar vários pontos de extremidade remotos para diferentes versões que funcionam lado a lado.

A execução Enable-PSRemoting cria dois pontos de extremidade para essa versão.

  • Um tem um nome simples correspondente à versão principal do PowerShell. que hospeda a sessão. Por exemplo, PowerShell.7.4.
  • O outro nome de configuração contém o número da versão completa. Por exemplo, PowerShell.7.4.7.

Você pode se conectar à versão mais recente do host do PowerShell 7 usando o nome simples, PowerShell.7.4. Você pode se conectar a uma versão específica do PowerShell usando o nome mais longo e específico da versão.

Use o parâmetro ConfigurationName com os cmdlets New-PSSession e Enter-PSSession para se conectar a uma configuração nomeada.

Conexão remota com versões mais antigas do Windows

Os pré-requisitos a seguir devem ser cumpridos para habilitar a comunicação remota do PowerShell sobre WSMan em versões mais antigas do Windows.

  • Instale o Windows Management Framework (WMF) 5.1 (conforme necessário). Para obter mais informações sobre o WMF, consulte Visão geral do WMF.
  • Instale o Universal C Runtime em versões do Windows anteriores ao Windows 10. Está disponível através de download direto ou Windows Update. Sistemas totalmente corrigidos já têm este pacote instalado.

A comunicação remota WSMan não é suportada em plataformas que não sejam Windows

Desde o lançamento do PowerShell 6, o suporte para acesso remoto via WS-Management (WSMan) em plataformas não Windows apenas está disponível para um número limitado de distribuições Linux. Todas as versões dessas distribuições que suportavam o WSMan não são mais suportadas pelos fornecedores do Linux que as criaram.

Em sistemas não-Windows, o WSMan baseava-se no projeto Open Management Infrastructure (OMI), que não suporta mais remoting no PowerShell. O cliente OMI WSMan depende de OpenSSL 1.0. A maioria das distribuições Linux mudou para OpenSSL 2.0, que não é retrocompatível. No momento, não há nenhuma distribuição suportada que tenha as dependências necessárias para que o cliente OMI WSMan funcione.

As bibliotecas desatualizadas e o código de suporte foram removidos para plataformas que não são Windows. A comunicação remota baseada em WSMan ainda é suportada entre sistemas Windows. A comunicação remota sobre SSH é suportada para todas as plataformas. Para obter mais informações, consulte PowerShell Remoting via SSH.

Observação

Os utilizadores podem conseguir fazer com que a comunicação remota do WSMan funcione usando o módulo PSWSMan. Este módulo não é suportado ou mantido pela Microsoft.

Leitura adicional