Configura o computador para receber comandos remotos.
Sintaxe
Enable-PSRemoting [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Enable-PSRemoting configura o computador para receber comandos remotos do Windows PowerShell que são enviados com a tecnologia WS-Management.
Você precisa executar o comando apenas uma vez em cada computador que receberá comandos. Não é necessário executá-lo em computadores que só enviam comandos. Como a configuração ativa escutas, é prudente executá-lo somente onde ele for necessário.
O cmdlet Enable-PSRemoting executa as seguintes operações:
--Executa o cmdlet Set-WSManQuickConfig, que executa as tarefas seguintes:
----- Inicia o serviço WinRM.
----- Define o tipo de inicialização no serviço WinRM como Automático.
----- Cria uma escuta para aceitar solicitações em qualquer endereço IP.
----- Habilita uma exceção de firewall para comunicações WS-Management.
-- Permite que todas as configurações de sessão registradas do Windows PowerShell recebam instruções de um computador remoto.
----- Registra a configuração de sessão "Microsoft.PowerShell", caso ela ainda não esteja registrada.
----- Registra a configuração de sessão "Microsoft.PowerShell32" em computadores de 64 bits, caso ela ainda não esteja registrada.
----- Remove a configuração "Negar Todos" do descritor de segurança para todas as configurações de sessão registradas.
----- Reinicia o serviço WinRM para tornar as alterações anteriores efetivas.
Para executar esse cmdlet no Windows Vista, no Windows Server 2008 e em versões mais recentes do Windows, inicie o Windows PowerShell com a opção "Executar como administrador".
Parâmetros
-Force
Suprime todos os avisos de usuário. Por padrão, você receberá um aviso para confirmar cada operação.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
False |
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
None Você não pode canalizar a entrada para este cmdlet. |
|
Saídas |
System.String Enable-PSRemoting retorna cadeias de caracteres que descrevem seus resultados. |
Exemplo 1
C:\PS>enable-psremoting Descrição ----------- Esse comando configura o computador para receber comandos remotos.
Exemplo 2
C:\PS>enable-psremoting -force Descrição ----------- Esse comando configura o computador para receber comandos remotos. Ele usa o parâmetro Force para suprimir os avisos de usuário.
See Also