Compartilhar via

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

Habilitar a comunicação remota do PowerShell

Para habilitar a comunicação remota do PowerShell, execute o Enable-PSRemoting cmdlet em uma sessão elevada do PowerShell. Executar Enable-PSRemoting configura um ponto de extremidade remoto para a versão específica de instalação na qual você está executando o cmdlet. Por exemplo, quando você executa Enable-PSRemoting ao executar o PowerShell 7.4, o PowerShell cria um ponto de extremidade de comunicação remota que executa o PowerShell 7.4. 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.4.
  • O outro nome de configuração contém o número de versão completo. Por exemplo, PowerShell.7.4.7.

Você pode se conectar à versão mais recente da versão de 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.

Comunicação remota com versões anteriores do Windows

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

  • Instale o WMF (Windows Management Framework) 5.1 (conforme necessário). Saiba mais sobre o WMF em Visão geral do WMF.
  • Instale o Runtime Universal C em versões do Windows anteriores ao Windows 10. Ele está disponível por meio do download direto ou do Windows Update. Sistemas totalmente corrigidos já têm esse pacote instalado.

Não há suporte para WSMan remoting em plataformas que não são do Windows.

Desde o lançamento do PowerShell 6, o suporte para comunicação remota por WS-Management (WSMan) em plataformas não Windows só está disponível para um conjunto limitado de distribuições do Linux. Em sistemas não Windows, o WSMan dependia do projeto OMI (Open Management Infrastructure). O cliente OMI WSMan depende do OpenSSL 1.0. Todas as distribuições do Linux usam o OpenSSL 2.0, que não é compatível com versões anteriores. Não há distribuições com suporte que tenham as dependências necessárias para que o cliente OMI WSMan funcione.

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.

Leitura adicional

  • Last updated on