Deniega el acceso a las configuraciones de sesión en el equipo local.

Sintaxis

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

Descripción

El cmdlet Disable-PSSessionConfiguration evita que todos los usuarios del equipo utilicen la configuración de la sesión de una sesión. 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.

El cmdlet Disable-PSSessionConfiguration agrega al descriptor de seguridad de una o más configuraciones de sesión registradas una entrada para denegar todo. En consecuencia, las configuraciones se pueden eliminar del Registro, ver y cambiar, pero no se pueden utilizar en una sesión.

Sin parámetros, Disable-PSSessionConfiguration deshabilita la configuración Microsoft.PowerShell, que es la configuración predeterminada que se utiliza para las sesiones. A menos que el usuario especifique una configuración diferente, evita de manera eficaz que tanto los usuarios locales como los remotos creen sesiones que se conecten al equipo.

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

Parámetros

-Force

Suprime todas las confirmaciones de usuario. De forma predeterminada, se le solicitará que confirme cada operación.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

False

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Name <string[]>

Especifica los nombres de las configuraciones de sesión que se van a deshabilitar. Escriba uno o varios nombres de configuración. Se permite el uso de caracteres comodín. También se puede canalizar a Disable-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, Disable-PSSessionConfiguration deshabilita la configuración de sesión Microsoft.PowerShell.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

Microsoft.PowerShell

¿Aceptar canalización?

true (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

true

-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 Disable-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>Disable-PSSessionConfiguration

Descripción
-----------
Este comando deshabilita la configuración de sesión Microsoft.PowerShell.






Ejemplo 2

C:\PS>disable-pssessionConfiguration -name *

Descripción
-----------
Este comando deshabilita todas las configuraciones de sesión registradas en el equipo.






Ejemplo 3

C:\PS>disable-pssessionConfiguration -name Microsoft* -force

Descripción
-----------
Este comando deshabilita todas las configuraciones de sesión cuyos nombres comienzan por "Microsoft". El comando utiliza el parámetro Force para suprimir todas las confirmaciones de usuario del comando.






Ejemplo 4

C:\PS>Get-PSSessionConfiguration -name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

Descripción
-----------
Este comando deshabilita las configuraciones de sesión MaintenanceShell y AdminShell. 

El comando usa un operador de canalización (|) para enviar los resultados de un comando Get-PSSessionConfiguration a Disable-PSSessionConfiguration.






Ejemplo 5

C:\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

C:\PS> Disable-PSSessionConfiguration -name MaintenanceShell -force

C:\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

C:\PS> Set-PSSessionConfiguration -name MaintenanceShell -MaximumReceivedDataSizePerCommandMB 60

ParamName            ParamValue
---------            ----------
psmaximumreceived... 60

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


C:\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_Troubl
eshooting Help topic.
    + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
    + FullyQualifiedErrorId : PSSessionOpenFailed

Descripción
-----------
En este ejemplo se muestra el efecto de deshabilitar una configuración de sesión.

El primer comando utiliza los cmdlets Get-SessionConfiguration y Format-Table para mostrar solamente las propiedades Permission y Name de los objetos de configuración de sesión. Este formato de tabla facilita la visualización de los valores de los objetos. Los resultados muestran que a los miembros del grupo Administradores se les permite utilizar las configuraciones de sesión.

El segundo comando utiliza el cmdlet Disable-PSSessionConfiguration para deshabilitar la configuración de sesión MaintenanceShell. El comando utiliza el parámetro Force para suprimir todas las confirmaciones de usuario.

El tercer comando repite el primero. El resultado muestra que sigue siendo posible obtener el objeto que representa la configuración de sesión MaintenanceShell aunque se haya denegado el acceso a ella a todos los usuarios. La entrada "AccessDenied" tiene precedencia sobre todas las demás entradas del descriptor de seguridad.

El cuarto comando utiliza el cmdlet Set-PSSessionConfiguration para aumentar a 60 el valor de MaximumDataSizePerCommandMB en la configuración de sesión MaintenanceShell. Los resultados muestran que el comando se ha ejecutado correctamente aunque se haya denegado el acceso a la configuración a todos los usuarios.

El quinto comando intenta utilizar la configuración de sesión MaintenanceShell en una sesión. Utiliza el cmdlet New-PSSession para crear una nueva sesión y el parámetro ConfigurationName para especificar la configuración MaintenanceShell. Los resultados muestran que se produce un error en el comando New-PSSession porque se deniega al usuario el acceso a la configuración.






Vea también




Tabla de contenido