Enable-PSRemoting

Artigo
10/30/2009

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

Nenhum

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.

Consulte também

Conceitos

about_Remote
about_Session_Configurations
Disable-PSRemoting
Get-PSSessionConfiguration
Enable-PSSessionConfiguration
Disable-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
WSMan Provider

Compartilhar via