Enable-PSSessionConfiguration

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Habilita las configuraciones de sesión en el equipo local.

Syntax

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Enable-PSSessionConfiguration cmdlet habilita las configuraciones de sesión registradas que se han deshabilitado, como mediante el uso de los Disable-PSSessionConfiguration cmdlets o Disable-PSRemoting , o el parámetro AccessMode de Register-PSSessionConfiguration. Se trata de un cmdlet avanzado diseñado para que lo usen los administradores del sistema para administrar las configuraciones de sesión personalizadas para sus usuarios.

Sin parámetros, Enable-PSSessionConfiguration habilita la configuración de Microsoft.PowerShell , que es la configuración predeterminada que se usa para las sesiones.

Enable-PSSessionConfiguration quita la configuración de Deny_All del descriptor de seguridad de las configuraciones de sesión afectadas, activa el agente de escucha que acepta solicitudes en cualquier dirección IP y reinicia el servicio WinRM. A partir de PowerShell 3.0, Enable-PSSessionConfiguration también establece el valor de la propiedad Enabled de la configuración de sesión (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) en True. Sin embargo, Enable-PSSessionConfiguration no quita ni cambia la configuración del descriptor de seguridad de Network_Deny_All (AccessMode=Local) que permite que solo los usuarios del equipo local usen en la configuración de sesión.

Ejemplos

Ejemplo 1: Volver a habilitar la sesión predeterminada

En este ejemplo se vuelve a habilitar la configuración de sesión predeterminada de Microsoft.PowerShell en el equipo.

Enable-PSSessionConfiguration

Ejemplo 2: Volver a habilitar las sesiones especificadas

En este ejemplo se vuelven a habilitar las configuraciones de sesión de MaintenanceShell y Administración Shell en el equipo.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Ejemplo 3: Volver a habilitar todas las sesiones

En este ejemplo se vuelven a habilitar todas las configuraciones de sesión del equipo. Estos comandos son equivalentes. Por lo tanto, puede usar cualquiera de los dos.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration no genera un error si habilita una configuración de sesión que ya está habilitada.

Ejemplo 4: Volver a habilitar una sesión y especificar un nuevo descriptor de seguridad

En este ejemplo se vuelve a habilitar la configuración de la sesión de MaintenanceShell y se especifica un nuevo descriptor de seguridad para la configuración.

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Force

Indica que el cmdlet no le pide confirmación y reinicia el servicio WinRM sin preguntar. Al reiniciar el servicio la configuración surte efecto.

Para evitar un reinicio y suprimir el mensaje de reinicio, use el parámetro NoServiceRestart .

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

-Name

Especifica los nombres de las configuraciones de sesión que se van a habilitar. Escriba uno o más nombres de configuración. Se permite el uso de caracteres comodín.

También puede canalizar una cadena que contenga un nombre de configuración o un objeto de configuración de sesión a Enable-PSSessionConfiguration.

Si omite este parámetro, Enable-PSSessionConfiguration habilita la configuración de sesión de Microsoft.PowerShell .

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Indica que el cmdlet no reinicia el servicio.

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

-SecurityDescriptorSddl

Especifica un descriptor de seguridad con el que este cmdlet reemplaza el descriptor de seguridad en la configuración de sesión.

Si omite este parámetro, Enable-PSSessionConfiguration solo elimina el elemento deny all del descriptor de seguridad.

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

-SkipNetworkProfileCheck

Indica que este cmdlet habilita la configuración de sesión 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. De forma predeterminada, Enable-PSSessionConfiguration se produce un error en una red pública.

Este parámetro está diseñado para las versiones de cliente del sistema operativo Windows. Las versiones de servidor del sistema operativo Windows tienen una regla de firewall de subred local para redes públicas. Sin embargo, si la regla de firewall de subred local está deshabilitada en una versión de servidor del sistema operativo Windows, este parámetro lo vuelve a habilitar.

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. Para obtener más información, vea Enable-PSRemoting.

Este parámetro se introdujo en PowerShell 3.0.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Puede canalizar un objeto de configuración de sesión a este cmdlet.

String

Puede canalizar una cadena que contenga el nombre de una configuración de sesión a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Este cmdlet solo está disponible en plataformas Windows.

Para usar este cmdlet, debe iniciar PowerShell mediante la opción Ejecutar como administrador .