Set-WSManQuickConfig

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

Configura o computador local para gerenciamento remoto.

Syntax

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 (Web Services for 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

Observaçã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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

Configura as versões de cliente do 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 de servidor do Windows, Enable-PSRemoting reative-a, 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-NetFirewallRulecmdlet no módulo NetSecurity .

Esse parâmetro foi introduzido no PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 que é 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 de WinRM e regras de firewall. Para obter mais informações, consulte Como: Configurar WINRM para HTTPS.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

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

Saídas

String

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