Get-PSSessionCapability
Возвращает возможности конкретного пользователя в конфигурации ограниченного сеанса.
Синтаксис
Default (По умолчанию)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Описание
Командлет Get-PSSessionCapability извлекает возможности конкретного пользователя в ограниченной конфигурации сеанса. Используйте этот командлет для аудита настраиваемых конфигураций сеансов для пользователей.
Начиная с Windows PowerShell 5.0, можно использовать свойство RoleDefinitions в файле конфигурации сеанса (.pssc) . Это свойство позволяет предоставлять пользователям различные возможности для одной ограниченной конечной точки на основе членства в группах. Командлет Get-PSSessionCapability упрощает процесс аудита этих конечных точек, позволяя определить конкретные возможности, предоставленные пользователю.
По умолчанию командлет Get-PSSessionCapability возвращает список команд, которые указанный пользователь может выполнять в указанной конечной точке. Это эквивалентно тому, как если бы пользователь запускал Get-Command на указанной конечной точке. При запуске с параметром Full этот командлет возвращает объект InitialSessionState. Этот объект содержит сведения о пространстве выполнения Windows 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
Указывает конфигурацию ограниченного сеанса (конечную точку), которую вы проверяете.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Full
Указывает, что этот командлет возвращает все начальное состояние сеанса для указанного пользователя в указанной ограниченной конечной точке.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Username
Указывает пользователя, возможности которого проверяются.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
