Compartilhar via

Set-WSManQuickConfig

  • Referência
Módulo:
Microsoft.WSMan.Management

Configura o computador local para gerenciamento remoto.

Sintaxe

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O Set-WSManQuickConfig cmdlet configura o computador para receber comandos remotos do PowerShell que são enviados usando a tecnologia WS-Management (Serviços Web para Gerenciamento).

Set-WSManQuickConfig executa as seguintes ações:

  • Verifica se o serviço WinRM está em execução. Se o serviço WinRM não estiver em execução, o serviço será iniciado.
  • Define o tipo de inicialização do serviço WinRM como automático.
  • Cria um ouvinte para aceitar solicitações em qualquer endereço IP. O transporte padrão é HTTP.
  • Habilita uma exceção de firewall para o tráfego do WinRM.

Para executar Set-WSManQuickConfigo , inicie o PowerShell com a opção Executar como administrador .

Exemplos

Exemplo 1: Habilitar o gerenciamento remoto do computador local por HTTP

Este exemplo define a configuração necessária para habilitar o gerenciamento remoto do computador local. Por padrão, esse comando cria um listener WS-Management em HTTP.

Set-WSManQuickConfig

Exemplo 2: Habilitar o gerenciamento remoto do computador local por HTTPS

Este exemplo define a configuração necessária para habilitar o gerenciamento remoto do computador local. O parâmetro UseSSL especifica que o HTTPS é usado para se comunicar com o computador.

Set-WSManQuickConfig -UseSSL

Observação

O HTTPS requer configuração manual. Para obter mais informações, consulte a descrição do parâmetro UseSSL .

Parâmetros

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SkipNetworkProfileCheck

Configura versões do cliente Windows para comunicação remota quando o computador está em uma rede pública. Este parâmetro habilita uma regra de firewall para redes públicas que permite o acesso remoto somente por meio de computadores na mesma sub-rede local.

Esse parâmetro não tem efeito nas versões de servidor do 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 na versão do servidor do Windows, Enable-PSRemoting ela será reativada, 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 Set-NetFirewallRule cmdlet no módulo NetSecurity .

Esse parâmetro foi introduzido no PowerShell 3.0.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseSSL

Especifica que o protocolo SSL (Secure Sockets Layer) é usado para estabelecer uma conexão com o computador remoto. Por padrão, o SSL não é usado.

O WS-Management criptografa todo o conteúdo do PowerShell transmitido pela rede. O parâmetro UseSSL permite especificar a proteção adicional de HTTPS em vez de HTTP. Se você usar esse parâmetro e o SSL não estiver disponível na porta usada para a conexão, o comando falhará.

O HTTPS requer configuração manual do WinRM e regras de firewall. Para obter mais informações, consulte Como configurar o WINRM para HTTPS.

Tipo:SwitchParameter
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 canalizar objetos para esse cmdlet.

Saídas

String

Esse cmdlet retorna uma mensagem como um objeto String que descreve o estado da configuração após a operação.