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

Get-SCUserRole

  • Ссылка
Модуль:
VirtualMachineManager

Возвращает роль пользователя VMM.

Синтаксис

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Описание

Командлет Get-SCUserRole получает одну или несколько ролей пользователя Virtual Machine Manager (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"

Эта команда получает объект роли пользователя с именем "Администратор". Команда отображает сведения об этой роли пользователя.

Пример 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
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Указывает имя роли пользователя VMM, которую получает этот командлет.

Тип:String
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного этим параметром.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной этим параметром.

Тип:UserRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserRoleProfile

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

  • ДелегированныйAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Тип:Profile
Допустимые значения:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMMServer

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

Тип:ServerConnection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

UserRole

Этот командлет возвращает объект UserRole.