Partilhar 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

Este 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 Web Services for Management (WS-Management).

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 ouvinte 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 HTTPS é usado para se comunicar com o computador.

Set-WSManQuickConfig -UseSSL

Nota

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 pedir a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SkipNetworkProfileCheck

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

Este 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
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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á.

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
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

String

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