Get-PSSessionCapability

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

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

Синтаксис

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