Leer en inglés

Compartir a través de

Disable-PSSessionConfiguration

  • Referencia
Módulo:
Microsoft.PowerShell.Core

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

Sintaxis

PowerShell 
Disable-PSSessionConfiguration
       [[-Name] <String[]>]
       [-Force]
       [-NoServiceRestart]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Disable-PSSessionConfiguration deshabilita las configuraciones de sesión en el equipo local, lo que impide que todos los usuarios usen las configuraciones de sesión para crear sesiones administradas por el usuario (PSSessions) en el equipo local. Este es un cmdlet avanzado diseñado para que lo usen los administradores del sistema para administrar configuraciones de sesión personalizadas para sus usuarios.

A partir de PowerShell 3.0, el cmdlet Disable-PSSessionConfiguration establece el valor de Enabled de la configuración de sesión (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) en False.

En PowerShell 2.0, el cmdlet Disable-PSSessionConfiguration agrega una entrada Deny_All al descriptor de seguridad de una o varias configuraciones de sesión registradas.

Sin parámetros, Disable-PSSessionConfiguration deshabilita la configuración de microsoft.PowerShell, la configuración predeterminada que se usa para las sesiones. A menos que el usuario especifique una configuración diferente, los usuarios locales y remotos no podrán crear sesiones que se conecten al equipo.

Para deshabilitar todas las configuraciones de sesión en el equipo, use Disable-PSRemoting.

Ejemplos

Ejemplo 1: Deshabilitar la configuración predeterminada

En este ejemplo se deshabilita la configuración de sesión de microsoft.PowerShell.

PowerShell 
Disable-PSSessionConfiguration

Ejemplo 2: Deshabilitar todas las configuraciones de sesión registradas

En este ejemplo se deshabilitan todas las configuraciones de sesión registradas en el equipo.

PowerShell 
Disable-PSSessionConfiguration -Name *

Ejemplo 3: Deshabilitar las configuraciones de sesión por nombre

En este ejemplo se deshabilitan todas las configuraciones de sesión que tienen nombres que comienzan por Microsoft. El parámetro Force suprime todas las solicitudes de usuario del cmdlet.

PowerShell 
Disable-PSSessionConfiguration -Name Microsoft* -Force

Ejemplo 4: Deshabilitar las configuraciones de sesión mediante la canalización

En este ejemplo se deshabilitan las configuraciones de sesión de de MaintenanceShell y AdminShell. El operador de canalización (|) envía los resultados de un Get-PSSessionConfiguration a Disable-PSSessionConfiguration.

PowerShell 
Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

Ejemplo 5: Efectos de deshabilitar una configuración de sesión

En este ejemplo se muestran los permisos antes y después de ejecutar Disable-PSSessionConfiguration y el efecto de deshabilitar una configuración de sesión.

PowerShell 
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message : Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed

Nota

Deshabilitar la configuración no impide que cambie la configuración mediante el cmdlet Set-PSSessionConfiguration. Solo impide el uso de la configuración.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica una matriz de nombres de configuraciones de sesión que se van a deshabilitar. Escriba uno o varios nombres de configuración. Se permiten 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 para Disable-PSSessionConfiguration.

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

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-NoServiceRestart

Se usa para evitar el reinicio del servicio WSMan. No es necesario reiniciar el servicio para deshabilitar la configuración.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 ninguna salida.

Notas

Este cmdlet solo está disponible en plataformas Windows.

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