Get-PSSessionConfiguration

Obtiene las configuraciones de sesión registradas en el equipo.

Sintaxis

Get-PSSessionConfiguration [[-Name] <string[]>] [<CommonParameters>]

Descripción

El cmdlet Get-PSSessionConfiguration obtiene las configuraciones de sesión registradas en el equipo local. 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.

Para crear y registrar una configuración de sesión, se utiliza el cmdlet Register-PSSessionConfiguration.

Parámetros

-Name <string[]>

Obtiene únicamente las configuraciones de sesión con el nombre o patrón de nombre especificado. Escriba uno o varios nombres de configuración de sesión. Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

All session configurations on the local computer

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

true

<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

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Notas

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

Para ver las configuraciones de sesión en el equipo, el usuario debe ser miembro del grupo Administradores en el equipo.

Para ejecutar un comando Get-PSSessionConfiguration en un equipo remoto, debe estar habilitada la autenticación de proveedor de servicios de seguridad de credenciales (CredSSP) en la configuración del cliente en el equipo local (mediante el cmdlet Enable-WSManCredSSP) y en la configuración del servicio en el equipo remoto; además, se debe usar el valor CredSSP del parámetro Authentication al establecer la sesión remota. De lo contrario, se denegará el acceso.

Ejemplo 1

C:\PS>get-pssessionconfiguration

Descripción
-----------
Este comando obtiene las configuraciones de sesión del equipo.





Ejemplo 2

C:\PS>get-pssessionconfiguration -name Microsoft*

Name                      PSVersion  StartupScript        Permission
----                      ---------  -------------        ----------
microsoft.powershell      2.0                             BUILTIN\Administrators AccessAll...
microsoft.powershell32    2.0                             BUILTIN\Administrators AccessAll...

Descripción
-----------
Este comando utiliza el parámetro Name de Get-PSSessionConfiguration para obtener únicamente las configuraciones de sesión cuyos nombres comienzan con "Microsoft".

Este comando obtiene las dos configuraciones de sesión predeterminadas que se incluyen con Windows PowerShell.





Ejemplo 3

C:\PS>Get-PSSessionConfiguration -name microsoft.powershell | get-member



   TypeName: Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Name                   MemberType     Definition
----                   ----------     ----------
Equals                 Method         bool Equals(System.Object obj)
GetHashCode            Method         int GetHashCode()
GetType                Method         type GetType()
ToString               Method         string ToString()
Capability             NoteProperty   System.Object[] Capability=System.Object[]
ExactMatch             NoteProperty   System.String ExactMatch=False
Filename               NoteProperty   System.String Filename=%windir%\system32\pwrshplugin.dll
lang                   NoteProperty   System.String lang=en-US
Name                   NoteProperty   System.String Name=microsoft.powershell
PSVersion              NoteProperty   System.String PSVersion=2.0
ResourceUri            NoteProperty   System.String ResourceUri=https://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion             NoteProperty   System.String SDKVersion=1
SecurityDescriptorSddl NoteProperty   System.String SecurityDescriptorSddl=O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
SupportsOptions        NoteProperty   System.String SupportsOptions=true
Uri                    NoteProperty   System.String Uri=https://schemas.microsoft.com/powershell/microsoft.powershell
xmlns                  NoteProperty   System.String xmlns=https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
XmlRenderingType       NoteProperty   System.String XmlRenderingType=text
Permission             ScriptProperty System.Object Permission {get=trap { continue; }...


C:\PS> Get-PSSessionConfiguration -name microsoft.powershell | format-list -property *


Name                   : microsoft.powershell
Filename               : %windir%\system32\pwrshplugin.dll
SDKVersion             : 1
XmlRenderingType       : text
lang                   : en-US
PSVersion              : 2.0
ResourceUri            : https://schemas.microsoft.com/powershell/microsoft.powershell
SupportsOptions        : true
Capability             : {Shell}
Uri                    : https://schemas.microsoft.com/powershell/microsoft.powershell
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
ExactMatch             : False
xmlns                  : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Permission             : BUILTIN\Administrators AccessAllowed

Descripción
-----------
Estos comandos examinan el objeto PSSessionConfiguration que Get-PSSessionConfiguration devuelve.

El primer comando utiliza el cmdlet Get-PSSessionConfiguration para obtener la configuración predeterminada Microsoft.PowerShell.

El segundo comando usa un operador de canalización (|) para enviar el objeto que Get-PSSessionConfiguration devuelve al cmdlet Get-Member. El resultado muestra las propiedades y los métodos del objeto.

El tercer comando envía el mismo objeto al cmdlet Format-List. El parámetro Property con el valor de asterisco (*) (todo) indica a Format-List que muestre todas las propiedades y valores de propiedad del objeto en una lista.

El resultado de este comando incluye información de gran utilidad, como la ubicación del archivo .dll que implementa el tipo de configuración, el identificador uniforme de recursos (URI) de recurso del extremo que se crea y el Lenguaje de definición de descriptores de seguridad (SDDL) para la configuración.





Ejemplo 4

C:\PS>dir wsman:\localhost\plugin

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Name                      Type                 Keys
----                      ----                 ----
Event Forwarding Plugin   Container            {Name=Event Forwarding Plugin}
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}
WMI Provider              Container            {Name=WMI Provider}

Descripción
-----------
Este comando utiliza el cmdlet Get-ChildItem (alias = dir) en la unidad de proveedor WSMan: para examinar el contenido del nodo Plugin.

Se trata de otra manera de examinar las configuraciones de sesión en el equipo.

El nodo PlugIn contiene objetos ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement) que representan las configuraciones de sesión de Windows PowerShell registradas, junto con otros complementos para WS-Management.





Ejemplo 5

C:\PS>enable-wsmanCredSSP -delegate server02

C:\PS> connect-wsman server02

C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true

C:\PS> invoke-command -scriptblock {Get-PSSessionConfiguration} -computername Server02 -authentication CredSSP -credential Domain01\Admin01 

Name                      PSVersion  StartupScript        Permission                          PSComputerName
----                      ---------  -------------        ----------                          --------------
microsoft.powershell      2.0                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32    2.0                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell                2.0        c:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com

Descripción
-----------
En este ejemplo se muestra cómo ejecutar un comando Get-PSSessionConfiguration en un equipo remoto. El comando requiere que la delegación CredSSP esté habilitada en la configuración del cliente en el equipo local y en la configuración del servicio en el equipo remoto. Para ejecutar los comandos de este ejemplo, el usuario debe ser miembro del grupo Administradores en el equipo local y en el equipo remoto.

El primer comando utiliza el cmdlet Enable-WSManCredSSP para habilitar la delegación CredSSP desde el equipo local Server01 en el equipo remoto Server02. Con ello se establece la configuración del cliente de CredSSP en el equipo local.

El segundo comando usa el cmdlet Connect-WSMan para conectarse al equipo Server02. Esta acción agrega un nodo para el equipo Server02 a la unidad WSMan: del equipo local; esto permite ver y cambiar la configuración de WS-Management en el equipo Server02.

El tercer comando utiliza el cmdlet Set-Item para cambiar a True el valor del elemento CredSSP en el nodo Service del equipo Server02. Al hacerlo se establece la configuración del servicio en el equipo remoto.

El cuarto comando utiliza el cmdlet Invoke-Command para ejecutar un comando Get-PSSessionConfiguration en el equipo Server02. El comando utiliza el parámetro Credential y utiliza el parámetro Authentication con el valor CredSSP.





Ejemplo 6

C:\PS>(get-PSSessionConfiguration -name CustomShell).resourceURI

https://schemas.microsoft.com/powershell/microsoft.CustomShell

Descripción
-----------
Este comando utiliza el cmdlet Get-PSSessionConfiguration para obtener el identificador URI de recurso de una configuración de la sesión. 

Este comando resulta útil al establecer el valor de la variable de preferencia $PSSessionConfigurationName, que toma un identificador URI de recurso. 

La variable $PSSessionConfiguationName especifica la configuración predeterminada que se utiliza al crear una sesión. Esta variable se establece en el equipo local, pero especifica una configuración en el equipo remoto. Para obtener más información sobre la variable $PSSessionConfiguration, vea about_Preference_Variables.





Vea también

Conceptos

about_Session_Configurations
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider