Set-WSManQuickConfig

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

Configura o computador local para gestão remota.

Syntax

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

Description

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

O Set-WSManQuickConfig cmdlet configura o computador para receber comandos remotos do PowerShell que são enviados através da tecnologia Serviços Web para Gestão (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 arranque do serviço WinRM como automático.
  • Cria um serviço de escuta para aceitar pedidos em qualquer endereço IP. O transporte predefinido é HTTP.
  • Ativa uma exceção de firewall para o tráfego WinRM.

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

Exemplos

Exemplo 1: Ativar a gestão remota do computador local através de HTTP

Este exemplo define a configuração necessária para ativar a gestão remota do computador local. Por predefinição, este comando cria um serviço de escuta WS-Management em HTTP.

Set-WSManQuickConfig

Exemplo 2: Ativar a gestão remota do computador local através de HTTPS

Este exemplo define a configuração necessária para ativar a gestão remota do computador local. O parâmetro UseSSL especifica que HTTPS é utilizado para comunicar com o computador.

Set-WSManQuickConfig -UseSSL

Nota

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

Parâmetros

-Force

Força o comando a ser executado sem pedir a confirmação do utilizador.

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

-SkipNetworkProfileCheck

Configura as versões do cliente Windows para remo quando o computador está numa 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 qualquer efeito nas versões de servidor do Windows que, por predefinição, têm uma regra de firewall de sub-rede local para redes públicas. Se a regra de firewall da sub-rede local estiver desativada na versão do servidor do Windows, Enable-PSRemoting reativa-a, independentemente do valor deste parâmetro.

Para remover a restrição de sub-rede local e ativar o acesso remoto a partir de todas as localizações em redes públicas, utilize o Set-NetFirewallRule cmdlet no módulo NetSecurity .

Este parâmetro foi introduzido no PowerShell 3.0.

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

-UseSSL

Especifica que o protocolo SSL (Secure Sockets Layer) é utilizado para estabelecer uma ligação ao computador remoto. Por predefinição, o SSL não é utilizado.

WS-Management encripta todo o conteúdo do PowerShell transmitido através da rede. O parâmetro UseSSL permite-lhe especificar a proteção adicional de HTTPS em vez de HTTP. Se utilizar este parâmetro e o SSL não estiver disponível na porta utilizada para a ligação, o comando falhará.

O HTTPS requer a configuração manual do WinRM e das regras de firewall. Para obter mais informações, veja How To: Configure WINRM for HTTPS (Como: Configurar o WINRM para HTTPS).

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

Entradas

None

Não pode encaminhar objetos para este cmdlet.

Saídas

String

Este cmdlet devolve uma mensagem como um objeto de Cadeia que descreve o estado da configuração após a operação.