Compartir a través de

Get-PSSessionCapability

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Obtiene las funcionalidades de un usuario específico en una configuración de sesión restringida.

Sintaxis

Get-PSSessionCapability
   [-ConfigurationName] <String>
   [-Username] <String>
   [-Full]
   [<CommonParameters>]

Description

El Get-PSSessionCapability cmdlet obtiene las funcionalidades de un usuario específico en una configuración de sesión restringida. Use este cmdlet para auditar las configuraciones de sesión personalizadas para los usuarios.

A partir de Windows PowerShell 5.0, puede usar la propiedad RoleDefinitions en un archivo de configuración de sesión (.pssc). El uso de esta propiedad permite conceder a los usuarios distintas funcionalidades en un único punto de conexión restringido basado en la pertenencia a grupos. El Get-PSSessionCapability cmdlet reduce la complejidad al auditar estos puntos de conexión al permitirle determinar las funcionalidades exactas concedidas a un usuario.

De forma predeterminada, el Get-PSSessionCapability cmdlet devuelve una lista de comandos que el usuario especificado puede ejecutar en el punto de conexión especificado. Esto equivale al usuario que se ejecuta Get-Command en el punto de conexión especificado. Cuando se ejecuta con el parámetro Full , este cmdlet devuelve un objeto InitialSessionState . Este objeto contiene detalles sobre el espacio de ejecución de PowerShell con el que interactuaría el usuario especificado para el punto de conexión especificado. Incluye información como el modo de lenguaje, la directiva de ejecución y las variables de entorno.

Ejemplos

Ejemplo 1: Obtener comandos disponibles para un usuario

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'

En este ejemplo se devuelven los comandos disponibles para el usuario CONTOSO\User al conectarse al punto de conexión restringido Endpoint1 en el equipo local.

Ejemplo 2: Obtener detalles sobre un espacio de ejecución para un usuario

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

En este ejemplo se devuelven detalles sobre el espacio de ejecución con el que el usuario CONTOSO\User interactuaría al conectarse al punto de conexión restringido Endpoint1.

Parámetros

-ConfigurationName

Especifica la configuración de sesión restringida (punto de conexión) que está inspeccionando.

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

-Full

Indica que este cmdlet devuelve todo el estado de sesión inicial del usuario especificado en el punto de conexión restringido especificado.

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

-Username

Especifica el usuario cuyas funcionalidades está inspeccionando.

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

Salidas

AliasInfo

FunctionInfo

InitialSessionState