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 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.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. 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 de OpenSSL 1.0. A maioria das distribuições do Linux migraram para OpenSSL 2.0, que não é retrocompatível. 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.
Nota
Os usuários podem fazer com que a comunicação remota do WSMan funcione usando o módulo PSWSMan. Este módulo não tem suporte ou é mantido pela Microsoft.