Get-SCUserRole
Получает роль пользователя VMM.
Синтаксис
Default (по умолчанию)
Get-SCUserRole
[-VMMServer <ServerConnection>]
[[-Name] <String>]
[-UserRoleProfile <Profile>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Описание
Командлет Get-SCUserRole получает одну или несколько ролей пользователей диспетчера виртуальных машин (VMM). VMM использует безопасность на основе ролей для определения границ, в пределах которых могут работать члены данной роли пользователя, и набора разрешенных операций, которые могут выполнять члены роли пользователя.
Для получения сведений о создании ролей пользователей введите Get-Help New-SCUserRole.
Для получения сведений о настройке свойств роли пользователя, включая область для делегированных администраторов и администраторов, доступных только для чтения, а также область и действия для пользователей самообслуживания, введите Get-Help Set-SCUserRole.
Примеры
Пример 1: Получите все роли пользователей
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
Эта команда получает все роли пользователей VMM на сервере с именем VMMServer01.Contoso.com. Команда отображает информацию о каждой роли пользователя.
Пример 2: Получение роли пользователя по имени
PS C:\> Get-SCUserRole -Name "Administrator"
Эта команда получает объект роли пользователя с именем Administrator. Команда отображает информацию об этой роли пользователя.
Пример 3: Получение роли пользователя по профилю
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"
Эта команда получает роли пользователей на сервере VMMServer01, которые имеют профиль роли пользователя SelfServiceUser. Команда отображает информацию об этих ролях пользователей.
Пример 4: Отображение свойств и другой информации об объектах роли пользователя
PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member
Первая команда получает все объекты роли пользователя на сервере с именем VMMServer01, а затем сохраняет эти объекты в переменной $UserRoles.
Вторая команда передает каждый объект роли пользователя в $UserRoles командлету Select-Object, который затем отображает имя, профиль роли пользователя, роль родительского пользователя и облако для каждой роли пользователя
Последняя команда передает каждую роль пользователя в $UserRoles командлету Get-Member , который отображает тип .NET для каждой роли пользователя, а также методы и свойства, связанные с каждым типом роли пользователя.
Параметры
-ID
Указывает уникальный идентификатор для роли пользователя, которую получает этот командлет.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя роли пользователя VMM, которую получает этот командлет.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного в этом параметре.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.
Свойства параметра
| Тип: | UserRole |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserRoleProfile
Указывает тип профиля, который является основой для ролей пользователей, получаемых этим командлетом. Допустимые значения для этого параметра:
- Делегированный администратор
- ЧитатьOnlyAdmin
- Пользователь самообслуживания
Свойства параметра
| Тип: | Profile |
| Default value: | None |
| Допустимые значения: | Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMMServer
Указывает сервер VMM, на котором этот командлет получает роли пользователей.
Свойства параметра
| Тип: | ServerConnection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Выходные данные
UserRole
Этот командлет возвращает объект UserRole .