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

Habilitando a comunicação remota do PowerShell

Para habilitar a comunicação remota do PowerShell, execute o cmdlet em uma sessão elevada do Enable-PSRemoting PowerShell. A execução Enable-PSRemoting configura um ponto de extremidade remoto para a versão de instalação específica na qual você está executando o cmdlet. Por exemplo, quando você executa enquanto executa Enable-PSRemoting o PowerShell 7.3, o PowerShell cria um ponto de extremidade remoto que executa o PowerShell 7.3. Se você executar Enable-PSRemoting durante a execução do 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 dessa execução lado a lado.

A execução cria dois pontos de Enable-PSRemoting 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.3.
  • O outro nome de configuração contém o número da versão completa. 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 New-PSSession cmdlets e Enter-PSSession para se conectar a uma configuração nomeada.

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 comunicação remota sobre WS-Management (WSMan) em plataformas que não sejam Windows só está disponível para um conjunto 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 não-Windows, o WSMan dependia do projeto Open Management Infrastructure (OMI), que não suporta mais a comunicação remota do PowerShell. O cliente OMI WSMan depende do OpenSSL 1.0. A maioria das distribuições Linux mudou para OpenSSL 2.0, que não é compatível com versões anteriores. 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 Comunicação remota do PowerShell sobre SSH.

Nota

Os usuários podem conseguir 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