Partilhar via

Set-WSManQuickConfig

Módulo:
Microsoft.WSMan.Management Module

Configura o computador local para gerenciamento remoto.

Sintaxe

All 

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

Description

O cmdlet Set-WSManQuickConfig 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-WSManQuickConfig, inicie o PowerShell com a opção Executar como administrador opção.

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 a reativará, 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 cmdlet Set-NetFirewallRule no módulo NetSecurity.

Esse parâmetro foi introduzido no PowerShell 3.0.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

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

Saídas

None

Este cmdlet não retorna nenhuma saída.