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