Поделиться через


Get-PSSessionCapability

Возвращает возможности конкретного пользователя в конфигурации ограниченного сеанса.

Синтаксис

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

Описание

Командлет Get-PSSessionCapability получает возможности определенного пользователя в конфигурации ограниченного сеанса. Используйте этот командлет для аудита настроенных конфигураций сеансов для пользователей.

Начиная с Windows PowerShell 5.0, свойство RoleDefinitions можно использовать в файле конфигурации сеанса (PSSC). Использование этого свойства позволяет предоставлять пользователям различные возможности в одной ограниченной конечной точке в зависимости от членства в группе. Командлет Get-PSSessionCapability упрощает аудит этих конечных точек, позволяя определить точные возможности, предоставленные пользователю.

По умолчанию командлет Get-PSSessionCapability возвращает список команд, которые указанный пользователь может выполнять в указанной конечной точке. Это эквивалентно запуску командлета Get-Command в указанной конечной точке. При запуске с параметром Full этот командлет возвращает объект InitialSessionState . Этот объект содержит сведения о пространстве выполнения PowerShell, с которым будет взаимодействовать указанный пользователь для указанной конечной точки. Он содержит такие сведения, как языковой режим, политика выполнения и переменные среды.

Примеры

Пример 1. Получение команд, доступных для пользователя

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

В этом примере возвращаются команды, доступные пользователю CONTOSO\User при подключении к ограниченной конечной точке Endpoint1 на локальном компьютере.

Пример 2. Получение сведений о пространстве выполнения для пользователя

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

В этом примере возвращаются сведения о пространстве выполнения, с которым будет взаимодействовать пользователь CONTOSO\User при подключении к ограниченной конечной точке Endpoint1.

Параметры

-ConfigurationName

Указывает конфигурацию ограниченного сеанса (конечную точку), которую вы проверяете.

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

-Full

Указывает, что этот командлет возвращает все начальное состояние сеанса для указанного пользователя в указанной ограниченной конечной точке.

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

-Username

Указывает пользователя, возможности которого вы проверяете.

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

Выходные данные

AliasInfo

FunctionInfo

InitialSessionState