Set-WSManQuickConfig
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 de Serviços Web para Gerenciamento (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 WinRM.
Para executar Set-WSManQuickConfig, 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 do
Parâmetros
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SkipNetworkProfileCheck
Configura as versões do cliente Windows para comunicação remota quando o computador está em uma rede pública. Esse parâmetro habilita uma regra de firewall para redes públicas que permite o acesso remoto somente 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 a habilitará novamente, 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
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 a configuração manual do WinRM e das regras de firewall. Para obter mais informações, consulte Como configurar o WINRM para HTTPS.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 transferir objetos para esse cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
