Set-WSManQuickConfig

  • Referencia
Módulo:
Microsoft.WSMan.Management

Configura el equipo local para la administración remota.

Syntax

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Set-WSManQuickConfig cmdlet configura el equipo para recibir comandos remotos de PowerShell que se envían mediante la tecnología servicios web para la administración (WS-Management).

Set-WSManQuickConfig lleva a cabo las acciones siguientes:

  • Comprueba si el servicio WinRM se está ejecutando. Si el servicio WinRM no se está ejecutando, se inicia el servicio.
  • Establece en automático el tipo de inicio del servicio WinRM.
  • Crea un agente de escucha para aceptar solicitudes en cualquier dirección IP. El transporte predeterminado es HTTP.
  • Habilita una excepción de firewall para el tráfico winRM.

Para ejecutar Set-WSManQuickConfig, inicie PowerShell con la opción Ejecutar como Administración istrator.

Ejemplos

Ejemplo 1: Habilitación de la administración remota del equipo local a través de HTTP

En este ejemplo se establece la configuración necesaria para habilitar la administración remota del equipo local. De forma predeterminada, este comando crea un agente de escucha WS-Management en HTTP.

Set-WSManQuickConfig

Ejemplo 2: Habilitación de la administración remota del equipo local a través de HTTPS

En este ejemplo se establece la configuración necesaria para habilitar la administración remota del equipo local. El parámetro UseSSL especifica que HTTPS se usa para comunicarse con el equipo.

Set-WSManQuickConfig -UseSSL

Nota:

HTTPS requiere configuración manual. Para obtener más información, consulte la descripción del parámetro UseSSL .

Parámetros

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-SkipNetworkProfileCheck

Configura las versiones de cliente de Windows para la comunicación remota cuando el equipo está en una red pública. Este parámetro habilita una regla de firewall para las redes públicas que permite el acceso remoto solo desde equipos en la misma subred local.

Este parámetro no tiene ningún efecto en las versiones de servidor de Windows, que, de forma predeterminada, tienen una regla de firewall de subred local para redes públicas. Si la regla de firewall de subred local está deshabilitada en la versión del servidor de Windows, Enable-PSRemoting vuelva a habilitarla, independientemente del valor de este parámetro.

Para quitar la restricción de subred local y habilitar el acceso remoto desde todas las ubicaciones de las redes públicas, use el Set-NetFirewallRule cmdlet en el módulo NetSecurity .

Este parámetro se introdujo en PowerShell 3.0.

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

-UseSSL

Especifica que el protocolo Capa de sockets seguros (SSL) se usa para establecer una conexión con el equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de PowerShell que se transmite a través de la red. El parámetro UseSSL permite especificar la protección adicional de HTTPS en lugar de HTTP. Si usa este parámetro y SSL no está disponible en el puerto que se usa para la conexión, se produce un error en el comando.

HTTPS requiere la configuración manual de las reglas de firewall y WinRM. Para obtener más información, vea Cómo: Configurar WINRM para HTTPS.

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

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

String

Este cmdlet devuelve un mensaje como un objeto String que describe el estado de la configuración después de la operación.