Enable-PSRemoting
Configura o computador para receber comandos remotos.
Sintaxe
Enable-PSRemoting
[-Force]
[-SkipNetworkProfileCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Este cmdlet só está disponível na plataforma Windows.
O cmdlet Enable-PSRemoting configura o computador para receber comandos remotos do PowerShell que são enviados usando a tecnologia WS-Management. WS-Management comunicação remota baseada no PowerShell tem suporte apenas na plataforma Windows.
A comunicação remota do PowerShell é habilitada por padrão em plataformas do Windows Server. Você pode usar Enable-PSRemoting para habilitar a comunicação remota do PowerShell em outras versões com suporte do Windows e habilitar novamente a comunicação remota se ela for desabilitada.
Você precisa executar esse comando apenas uma vez em cada computador que receberá comandos. Você não precisa executá-lo em computadores que enviam apenas comandos. Como a configuração inicia os ouvintes a aceitar conexões remotas, é prudente executá-la somente onde for necessário.
Habilitar a comunicação remota do PowerShell em versões de cliente do Windows quando o computador estiver em uma rede pública normalmente não é permitido, mas você pode ignorar essa restrição usando o parâmetro SkipNetworkProfileCheck. Para obter mais informações, consulte a descrição do parâmetro SkipNetworkProfileCheck.
Várias instalações do PowerShell podem existir lado a lado em um único computador. Executar Enable-PSRemoting configurará um ponto de extremidade de comunicação remota para a versão de instalação específica na qual você está executando o cmdlet. Portanto, se você executar Enable-PSRemoting durante a execução do PowerShell 6.2, um ponto de extremidade de comunicação remota será configurado que executa o PowerShell 6.2. Se você executar Enable-PSRemoting durante a execução do PowerShell 7-preview, um ponto de extremidade de comunicação remota será configurado que executa o PowerShell 7-preview.
Enable-PSRemoting cria duas configurações de ponto de extremidade de comunicação remota conforme necessário. Se as configurações de ponto de extremidade já existirem, elas simplesmente serão habilitadas. As configurações criadas são idênticas, mas têm nomes diferentes. Um deles terá um nome simples correspondente à versão do PowerShell que hospeda a sessão. O outro nome de configuração contém informações mais detalhadas sobre a versão do PowerShell que hospeda a sessão. Por exemplo, ao executar Enable-PSRemoting no PowerShell 6.2, você obterá dois pontos de extremidade configurados chamados PowerShell.6, PowerShell.6.2.2. Isso permite que você crie uma conexão com a versão mais recente do host do PowerShell 6 usando o nome simples PowerShell.6. Ou você pode se conectar a uma versão específica do host do PowerShell usando o nome mais longo PowerShell.6.2.2.
Para usar os pontos de extremidade de comunicação remota recém-habilitados, especifique-os pelo nome com o parâmetro ConfigurationName ao criar uma conexão remota usando os cmdlets Invoke-Command,New-PSSessioneEnter-PSSession. Para obter mais informações, consulte o Exemplo 4.
O cmdlet Enable-PSRemoting executa as seguintes operações:
- Executa o cmdlet Set-WSManQuickConfig
, que executa as seguintes tarefas: - Inicia o serviço WinRM.
- Define o tipo de inicialização no serviço WinRM como Automático.
- Cria um ouvinte para aceitar solicitações em qualquer endereço IP.
- Habilita uma exceção de firewall para comunicações WS-Management.
- Cria as configurações de ponto de extremidade de sessão de nome simples e longo, se necessário.
- Habilita todas as configurações de sessão.
- Altera o descritor de segurança de todas as configurações de sessão para permitir o acesso remoto.
- Reinicia o serviço WinRM para tornar as alterações anteriores efetivas.
Para executar esse cmdlet na plataforma Windows, inicie o PowerShell usando a opção Executar como administrador. Esse cmdlet não está disponível nas versões linux ou MacOS do PowerShell.
Cuidado
Esse cmdlet não afeta as configurações de ponto de extremidade remoto criadas pelo Windows PowerShell.
Ele afeta apenas os pontos de extremidade criados com o PowerShell versão 6 e superior. Para habilitar e desabilitar pontos de extremidade de comunicação remota do PowerShell hospedados pelo Windows PowerShell, execute o cmdlet Enable-PSRemoting de dentro de uma sessão do Windows PowerShell.
Exemplos
Exemplo 1: configurar um computador para receber comandos remotos
Esse comando configura o computador para receber comandos remotos.
Enable-PSRemoting
WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and
does not affect Windows PowerShell remoting configurations. Run this cmdlet in Windows
PowerShell to affect all PowerShell remoting configurations.Exemplo 2: configurar um computador para receber comandos remotos sem um prompt de confirmação
Esse comando configura o computador para receber comandos remotos. O parâmetro Force suprime os prompts do usuário.
Enable-PSRemoting -Force
WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and
does not affect Windows PowerShell remoting configurations. Run this cmdlet in Windows
PowerShell to affect all PowerShell remoting configurations.Exemplo 3: Permitir acesso remoto em clientes
Este exemplo mostra como permitir o acesso remoto de redes públicas em versões de cliente do sistema operacional Windows. O nome da regra de firewall pode ser diferente para versões diferentes do Windows.
Use Get-NetFirewallRule para ver uma lista de regras. Antes de habilitar a regra de firewall, exiba as configurações de segurança na regra para verificar se a configuração é apropriada para seu ambiente.
Get-NetFirewallRule -Name 'WINRM*' | Select-Object -Property Name
Name
----
WINRM-HTTP-In-TCP-NoScope
WINRM-HTTP-In-TCP
WINRM-HTTP-Compat-In-TCP-NoScope
WINRM-HTTP-Compat-In-TCP
Enable-PSRemoting -SkipNetworkProfileCheck -Force
Set-NetFirewallRule -Name 'WINRM-HTTP-In-TCP' -RemoteAddress AnyPor padrão, Enable-PSRemoting cria regras de rede que permitem o acesso remoto de redes privadas e de domínio. O comando usa o parâmetro SkipNetworkProfileCheck para permitir o acesso remoto de redes públicas na mesma sub-rede local. O comando especifica o parâmetro Force para suprimir mensagens de confirmação.
O parâmetro SkipNetworkProfileCheck não afeta as versões do servidor do sistema operacional Windows, que permitem o acesso remoto de redes públicas na mesma sub-rede local por padrão.
O cmdlet Set-NetFirewallRule no módulo NetSecurity adiciona uma regra de firewall que permite o acesso remoto de redes públicas de qualquer local remoto. Isso inclui locais em sub-redes diferentes.
Exemplo 4: Criar uma sessão remota para a configuração de ponto de extremidade recém-habilitada
Este exemplo mostra como habilitar a comunicação remota do PowerShell em um computador, localizar os nomes de ponto de extremidade configurados e criar uma sessão remota para um dos pontos de extremidade.
O primeiro comando habilita a comunicação remota do PowerShell no computador.
O segundo comando lista as configurações de ponto de extremidade.
O terceiro comando cria uma sessão remota do PowerShell para o mesmo computador, especificando o PowerShell.7 ponto de extremidade por nome. A sessão remota será hospedada com a versão mais recente do PowerShell 7 (7.3.0).
O último comando acessa a variável $PSVersionTable na sessão remota para exibir a versão do PowerShell que está hospedando a sessão.
Enable-PSRemoting -Force
Get-PSSessionConfiguration
$session = New-PSSession -ComputerName localhost -ConfigurationName PowerShell.7
Invoke-Command -Session $session -ScriptBlock { $PSVersionTable }
WARNING: PowerShell remoting has been enabled only for PowerShell Core configurations and
does not affect Windows PowerShell remoting configurations. Run this cmdlet in Windows
PowerShell to affect all PowerShell remoting configurations.
Name : PowerShell.7
PSVersion : 7.3
StartupScript :
RunAsUser :
Permission : NT AUTHORITY\INTERACTIVE AccessAllowed,
BUILTIN\Administrators AccessAllowed,
BUILTIN\Remote Management Users AccessAllowed
Name : PowerShell.7.3.0
PSVersion : 7.3
StartupScript :
RunAsUser :
Permission : NT AUTHORITY\INTERACTIVE AccessAllowed,
BUILTIN\Administrators AccessAllowed,
BUILTIN\Remote Management Users AccessAllowed
Name Value
---- -----
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
PSEdition Core
PSRemotingProtocolVersion 2.3
Platform Win32NT
SerializationVersion 1.1.0.1
GitCommitId 6.2.2
WSManStackVersion 3.0
PSVersion 6.2.2
OS Microsoft Windows 10.0.18363Nota
O nome da regra de firewall pode ser diferente dependendo da versão do Windows. Use o cmdlet Get-NetFirewallRule para listar os nomes das regras em seu sistema.
Parâmetros
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkipNetworkProfileCheck
Indica que esse cmdlet permite a comunicação remota em versões de cliente do sistema operacional Windows quando o computador está em uma rede pública. Esse parâmetro habilita uma regra de firewall para redes públicas que permite o acesso remoto somente de computadores na mesma sub-rede local.
Esse parâmetro não afeta as versões de servidor do sistema operacional Windows, que, por padrão, têm uma regra de firewall de sub-rede local para redes públicas. Se a regra de firewall de sub-rede local estiver desabilitada em uma versão do servidor, Enable-PSRemoting a habilitará novamente, independentemente do valor desse parâmetro.
Para remover a restrição de sub-rede local e habilitar o acesso remoto de todos os locais em redes públicas, use o cmdlet
Esse parâmetro foi introduzido no PowerShell 3.0.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Você não pode redirecionar objetos para este cmdlet.
Saídas
Esse cmdlet retorna cadeias de caracteres que descrevem seus resultados.
Observações
Esse cmdlet só está disponível em plataformas Windows.
Em versões de servidor do sistema operacional Windows, Enable-PSRemoting cria regras de firewall para redes privadas e de domínio que permitem acesso remoto e cria uma regra de firewall para redes públicas que permite acesso remoto somente de computadores na mesma sub-rede local.
Nas versões do cliente do sistema operacional Windows, Enable-PSRemoting cria regras de firewall para redes privadas e de domínio que permitem acesso remoto irrestrito. Para criar uma regra de firewall para redes públicas que permita o acesso remoto da mesma sub-rede local, use o parâmetro SkipNetworkProfileCheck.
Em versões de cliente ou servidor do sistema operacional Windows, para criar uma regra de firewall para redes públicas que remove a restrição de sub-rede local e permite o acesso remoto, use o cmdlet Set-NetFirewallRule no módulo NetSecurity para executar o seguinte comando: Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP-PUBLIC" -RemoteAddress Any
Enable-PSRemoting remove as configurações de Deny_All e Network_Deny_All. Isso fornece acesso remoto às configurações de sessão reservadas para uso local.