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

Sintaxis

Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Enable-PSSessionConfiguration vuelve a habilitar las configuraciones de sesión registradas que se han deshabilitado mediante el cmdlet Disable-PSSessionConfiguration. Es un cmdlet avanzado diseñado para que lo utilicen los administradores de sistemas a fin de administrar configuraciones de sesión personalizadas para sus usuarios.

Sin parámetros, Enable-PSSessionConfiguration vuelve a habilitar la configuración Microsoft.PowerShell, que es la configuración predeterminada que se utiliza para las sesiones.

Este cmdlet realiza las operaciones siguientes para cada configuración habilitada:

--Quita la opción de denegar todo del descriptor de seguridad de la configuración o reemplaza este último por otro especificado por el usuario.

--Activa el agente de escucha que acepta las solicitudes en cualquier dirección IP.

-- Reinicia el servicio WinRM.

El cmdlet Enable-PSSessionConfiguration llama al cmdlet Set-WSManQuickConfig. Sin embargo, no se debe utilizar para habilitar la comunicación remota en el equipo. En su lugar, utilice el cmdlet Enable-PSRemoting, más completo.

Parámetros

-Force

Elimina todas las confirmaciones de usuario y reinicia el servicio WinRM sin pedir confirmación. Al reiniciar el equipo surte efecto el cambio de configuración.

Para evitar un reinicio y suprimir la confirmación de reinicio, utilice el parámetro NoServiceRestart.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Name <string[]>

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

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

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

¿Requerido?

false

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

true

-SecurityDescriptorSDDL <string>

Reemplaza el descriptor de seguridad de la configuración de sesión por el descriptor de seguridad especificado.

Si se omite este parámetro, Enable-PSSessionConfiguration se limita a eliminar del descriptor de seguridad el elemento para denegar todo.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String

Se puede canalizar a Enable-PSSessionConfiguration un objeto de configuración de sesión o una cadena que contenga el nombre de esta última.

Salidas

Ninguno

Este cmdlet no devuelve objetos.

Notas

Para ejecutar este cmdlet en Windows Vista, Windows Server 2008 y versiones posteriores de Windows, se debe iniciar Windows PowerShell con la opción "Ejecutar como administrador".

Ejemplo 1

C:\PS>Enable-PSSessionConfiguration

Descripción
-----------
Este comando vuelve a habilitar la configuración de sesión predeterminada Microsoft.PowerShell en el equipo.






Ejemplo 2

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell

Descripción
-----------
Este comando vuelve a habilitar las configuraciones de sesión MaintenanceShell y AdminShell en el equipo.






Ejemplo 3

C:\PS>Enable-PSSessionConfiguration -name *

C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Descripción
-----------
Estos comandos vuelven a habilitar todas las configuraciones de sesión en el equipo. Los comandos son equivalentes, de modo que pueda utilizar cualquiera de ellos.

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






Ejemplo 4

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"

Descripción
-----------
Este comando vuelve a habilitar la configuración de sesión MaintenanceShell y especifica un nuevo descriptor de seguridad para ella.






Vea también




Tabla de contenido