Get-PSSessionCapability

  • Referencia
Módulo:
Microsoft.PowerShell.Core

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

Syntax

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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

Especifica el usuario cuyas funcionalidades está inspeccionando.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Salidas

AliasInfo

FunctionInfo

InitialSessionState