TEMA

about_Session_Configurations
DESCRIPCIN BREVE
Describe las configuraciones de sesin, que determinan los
usuarios que pueden establecer conexin con el equipo de forma
remota y los comandos que pueden ejecutar.
DESCRIPCIN DETALLADA
Una configuracin de sesin es un grupo de valores en el equipo
local que definen el entorno de las sesiones de Windows PowerShell
que se crean cuando usuarios remotos se conectan al equipo local.
Los administradores del equipo pueden utilizar las configuraciones
de sesin para proteger el equipo y definir entornos
personalizados para los usuarios que se conectan al equipo.
Los administradores tambin pueden utilizar las configuraciones
de sesin a fin de determinar los permisos necesarios para
conectarse de forma remota al equipo. De manera predeterminada,
solo los miembros del grupo Administradores tienen permiso para
usar la configuracin de sesin a fin de conectarse de forma
remota. Sin embargo, se puede cambiar la configuracin
predeterminada de modo que todos los usuarios o determinados
usuarios puedan conectarse de forma remota al equipo.
Las configuraciones de sesin son una caracterstica de la
comunicacin remota de Windows PowerShell basada en Web Services for
Management (WS-Management).
Se utilizan nicamente cuando se usa el cmdlet New-PSSession,
Invoke-Command o Enter-PSSession para establecer una conexin con
un equipo remoto.
Nota: para administrar las configuraciones de sesin en un equipo
en el que se ejecuta Windows Vista, Windows Server 2008 o una
versin posterior de Windows, inicie Windows PowerShell con la
opcin "Ejecutar como administrador".
Acerca de las configuraciones de sesin
Cada sesin de Windows PowerShell utiliza una configuracin de
sesin. Esto tambin se aplica a las sesiones persistentes que se
crean mediante el cmdlet New-PSSession o Enter-PSSession as como
a las sesiones temporales creadas por Windows PowerShell cuando
se usa el parmetro ComputerName de un cmdlet que utiliza la
tecnologa de comunicacin remota basada en WS-Management, como
Invoke-Command.
Los administradores pueden utilizar las configuraciones de sesin
para proteger los recursos del equipo y crear entornos
personalizados para los usuarios que se conectan al equipo. Por
ejemplo, pueden utilizar una configuracin de sesin para limitar
el tamao de los objetos que el equipo recibe en la sesin,
definir el modo de lenguaje de la sesin y especificar los
cmdlets, proveedores y funciones que estn disponibles en la sesin.
Al configurar el descriptor de seguridad de una configuracin de
sesin, se determina quin puede utilizar la configuracin de
sesin para conectarse al equipo. Los usuarios deben disponer del
permiso de ejecucin de una configuracin de sesin a fin de

poder utilizarla en una sesin.

Si un usuario no tiene los permisos necesarios para utilizar las
configuraciones de sesin en un equipo, no podr conectarse de
forma remota al equipo.
De manera predeterminada, solo los administradores del equipo
tienen permiso para usar las configuraciones de sesin predeterminadas.
Sin embargo, se pueden cambiar los descriptores de seguridad de modo
que todos los usuarios, ningn usuario o determinados usuarios puedan
usar las configuraciones de sesin en el equipo.

Configuraciones de sesin predeterminadas.

Windows PowerShell incluye una configuracin de sesin integrada,
denominada Microsoft.PowerShell. En los equipos en los que se
ejecutan versiones de 64 bits de Windows, Windows PowerShell
tambin proporciona Microsoft.PowerShell32, una configuracin de
sesin de 32 bits.
Estas configuraciones de sesin se utilizan de forma
predeterminada para las sesiones, es decir, cuando un comando
para crear una sesin no incluye el parmetro ConfigurationName
del cmdlet New-PSSession, Enter-PSSession o Invoke-Command.
Los descriptores de seguridad de las configuraciones de sesin
predeterminadas solo permiten a los miembros del grupo Administradores
en el equipo local utilizar dichas configuraciones. Como tal, solo los
miembros del grupo Administradores pueden conectarse de forma remota al
equipo, a menos que se modifique la configuracin predeterminada.
Las configuraciones de sesin predeterminadas se pueden modificar
mediante la variable de preferencia $PSSessionConfigurationName.
Para obtener ms informacin, vea about_Preference_Variables.

Ver las configuraciones de sesin en el equipo local Para obtener

las configuraciones de sesin en el equipo local, utilice el cmdlet GetPSSessionConfiguration.
Por ejemplo, escriba:
C:\PS> get-pssessionconfiguration | format-list -property name, permissi
on
Name
: microsoft.powershell
Permission : BUILTIN\Administrators AccessAllowed
Name
: microsoft.powershell32
Permission : BUILTIN\Administrators AccessAllowed
Tambin puede usar el proveedor de WS-Management en Windows
PowerShell para ver las configuraciones de sesin. Este proveedor
crea una unidad WSMAN: en la sesin.
En la unidad WSMAN:, las configuraciones de sesin estn en el
nodo Plugin. (Todas las configuraciones de sesin estn en el
nodo Plugin, pero algunos elementos de este nodo no son

configuraciones de sesin.)
Por ejemplo, para ver las configuraciones de sesin en el equipo
local, escriba:
C:\PS> dir wsman:\localhost\plugin\microsoft*
WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plu
gin
Name
---microsoft.powershell

Type
---Container

Keys
---{Name=microsoft.powershe

microsoft.powershell32

Container

{Name=microsoft.powershe

ll}
ll}
Ver las configuraciones de sesin en un equipo remoto Para ver las
configuraciones de sesin en un equipo remoto, utilice el cmdlet
Connect-WSMan a fin de agregar un nodo para el equipo remoto a la
unidad WSMAN: en el equipo local y, a continuacin, use la unidad
WSMAN: para ver las configuraciones de sesin.
Por ejemplo, el comando siguiente agrega un nodo para el equipo
remoto Servidor01 a la unidad WSMAN: en el equipo local.
C:\PS> connect-wsman servidor01.corp.fabrikam.com
Cuando se completa el comando, se puede navegar hasta el nodo del
equipo Servidor01 para ver las configuraciones de sesin.
Por ejemplo:
C:\PS> cd wsman:
PS WSMan:\> dir
ComputerName
-----------localhost
servidor01.corp.fabrikam.com

Type
---Container
Container

PS WSMan:\> dir servidor01*\plugin\*

WSManConfig: Microsoft.WSMan.Management\WSMan::servidor01.corp.fa
brikam.com\Plugin
Name
---microsoft.powershell

Type
---Container

Keys
---{Name=microsoft.powershel

microsoft.powershell32

Container

{Name=microsoft.powershel

l}
l32}

Cambiar el descriptor de seguridad de una configuracin de sesin De

forma predeterminada, los miembros del grupo Administradores en el

equipo disponen de permisos de ejecucin para las configuraciones de
sesin predeterminadas. Sin embargo, se pueden modificar los
descriptores de seguridad de las configuraciones de sesin
predeterminadas y de cualquier configuracin de sesin que se cree.
Para que otros usuarios tengan permiso para conectarse de forma
remota al equipo, use el cmdlet Set-PSSessionConfiguration a fin
de agregar para esos usuarios permisos de ejecucin a los
descriptores de seguridad de las configuraciones de sesin
Microsoft.PowerShell y Microsoft.PowerShell32.
Por ejemplo, el comando siguiente abre una pgina de propiedades
que permite cambiar el descriptor de seguridad de la
configuracin de sesin predeterminada Microsoft.PowerShell.
C:\PS> set-pssessionConfiguration -name Microsoft.PowerShell -showSecuri
tyDescriptorUI
Si desea denegar a todos los usuarios el permiso para todas las
configuraciones de sesin en el equipo, utilice la funcin
Disable-PSRemoting o el cmdlet Disable-PSSessionConfiguration.
Por ejemplo, el comando siguiente agrega la entrada "Denegar
todo" a todas las configuraciones de sesin en el equipo.
C:\PS> disable-psremoting
Para agregar la entrada "Denegar todo" a una configuracin de
sesin concreta, utilice el cmdlet Disable-PSSessionConfiguration.
Por ejemplo, los comandos siguientes agregan la entrada "Denegar
todo" a la configuracin de sesin Microsoft.PowerShell.
C:\PS> disable-pssessionConfiguration -name Microsoft.PowerShell
Para quitar la entrada "Denegar todo" de todas las configuraciones
de sesin, utilice el cmdlet Enable-PSRemoting o Enable-PSSession
Configuration. Por ejemplo, el comando siguiente quita la entrada
"Denegar todo" de las configuraciones de sesin predeterminadas.
C:\PS> enable-pssessionConfiguration -name Microsoft.Power*
Para realizar otros cambios en el descriptor de seguridad de una
configuracin de sesin, utilice el cmdlet Set-PSSessionConfigurat
ion. Use el parmetro SecurityDescriptorSDDL para enviar un valor
de cadena de SDDL. Utilice el parmetro ShowSecurityDescriptorUI
para que se muestre una hoja de propiedades de la interfaz de
usuario que le ayuda a crear un nuevo SDDL.
Por ejemplo:
C:\PS> set-pssessionConfiguration -name Microsoft.PowerShell -showSecuri
tyDescriptorUI

Crear una nueva configuracin de sesin

Para crear una nueva configuracin de sesin en el equipo local,

utilice el cmdlet Register-PSSessionConfiguration. Para definir

la nueva configuracin de sesin, puede usar un ensamblado de C#,
un script de Windows PowerShell y los parmetros del cmdlet RegisterPSSessionConfiguration.
Por ejemplo, el comando siguiente crea una configuracin de
sesin que es idntica a la configuracin de sesin
Microsoft.PowerShell, salvo en que limita a 20 MB los datos
recibidos de un comando remoto. (El valor predeterminado es 50 MB.)
c:\PS> register-psSessionConfiguration -name NewConfig --MaximumReceived
DataSizePerCommandMB 20
Cuando se crea una configuracin de sesin, se puede
administrarla usando los otros cmdlets de configuracin de sesin
y la configuracin de sesin creada aparece en la unidad WSMAN:.
Para obtener ms informacin, vea Register-PSSessionConfiguration.

Quitar una configuracin de sesin

Para quitar una configuracin de sesin del equipo local, utilice
el cmdlet Unregister-PSSessionConfiguration. Por ejemplo, el comando
siguiente quita la configuracin de sesin NewConfig del equipo.
c:\PS> unregister-psSessionConfiguration -name NewConfig
Para obtener ms informacin, vea Unregister-PSSessionConfiguration.

Seleccionar una configuracin de sesin

Para seleccionar una configuracin de sesin concreta para una
sesin, utilice el parmetro ConfigurationName de New-PSSession,
Enter-PSSession o Invoke-Command.
Por ejemplo, este comando utiliza el cmdlet New-PSSession para
iniciar una PSSession en el equipo Servidor01. El comando utiliza
el parmetro ConfigurationName para seleccionar la configuracin
WithProfile en el equipo Servidor01.
C:\PS> new-pssession -computername Servidor01 -configurationName WithPro
file
Este comando solo se ejecutar correctamente si el usuario actual
tiene permiso para usar la configuracin de sesin WithProfile o
puede proporcionar las credenciales de un usuario con los
permisos necesarios.
Asimismo, puede usar la variable de preferencia $PSSessionConfigur
ationName para cambiar la configuracin de sesin predeterminada
en el equipo. Para obtener ms informacin sobre la variable de
preferencia $PSSessionConfigurationName, vea about_Preference_Variables.

VEA TAMBIN
about_Preference_Variables
about_PSSession

about_Remote
New-PSSession
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration