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

  • Artigo

Habilitar a comunicação remota do PowerShell

Para habilitar a comunicação remota do PowerShell, execute o cmdlet Enable-PSRemoting em uma sessão do PowerShell com privilégios elevados. Executar Enable-PSRemoting configura um ponto de extremidade de comunicação remota para a versão de instalação específica na qual você está executando o cmdlet. Por exemplo, quando você executa Enable-PSRemoting ao executar o PowerShell 7.3, o PowerShell cria um ponto de extremidade de comunicação remota que executa o PowerShell 7.3. Quando você executa Enable-PSRemoting ao executar o PowerShell 7-preview, o PowerShell cria um ponto de extremidade de comunicação remota que executa o PowerShell 7-preview. Você pode criar vários pontos de extremidade de comunicação remota para versões diferentes dessa execução lado a lado.

Executar Enable-PSRemoting cria dois pontos de extremidade para essa versão.

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

Você pode se conectar à versão mais recente da versão de host do PowerShell 7 usando o nome simples, PowerShell.7.3. 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.

Não há suporte para comunicação remota WSMan em plataformas não Windows

Desde o lançamento do PowerShell 6, o suporte para comunicação remota por WSMan (WS-Management) em plataformas que não são do Windows só está disponível para um conjunto limitado de distribuições do Linux. Todas as versões dessas distribuições com suporte do WSMan não são mais compatíveis com os fornecedores do Linux que as criaram.

No não Windows, o WSMan se baseava no projeto OMI (Open Management Infrastructure), que não dá mais suporte à comunicação remota do PowerShell. O cliente OMI WSMan depende do OpenSSL 1.0. A maioria das distribuições do Linux foi movida para OpenSSL 2.0, que não é compatível com versões anteriores. No momento, não há nenhuma distribuição com suporte 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 do Windows. A comunicação remota baseada em WSMan ainda tem suporte entre sistemas Windows. Há suporte para comunicação remota por SSH para todas as plataformas. Para obter mais informações, confira Comunicação remota do PowerShell por meio do SSH.

Observação

Os usuários podem fazer com que a comunicação remota do WSMan funcione usando o módulo PSWSMan. Esse módulo não tem suporte nem é mantido pela Microsoft.

Leitura adicional