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


Get-MsolRoleMember

Получает члены роли.

Синтаксис

Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Описание

Командлет Get-MsolRoleMember получает членов указанной роли.

Примеры

Пример 1. Получение членов роли

PS C:\> $Role = Get-MsolRole -RoleName "%Role Name%"
PS C:\> $RoleMembers = Get-MsolRoleMember -RoleObjectId $Role.ObjectId

Эта команда возвращает все члены указанной роли. Команда сохраняет результаты в переменной $RoleMembers.

Параметры

-All

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

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

-MaxResults

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

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

-MemberObjectTypes

Задает массив типов объектов-членов.

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

-RoleObjectId

Указывает уникальный идентификатор роли, из которой удаляются члены.

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

-SearchString

Указывает строку. Этот командлет возвращает объекты с отображаемым именем или адресом электронной почты, которые начинаются с этой строки. Строка для поиска.

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

-TenantId

Указывает уникальный идентификатор клиента, с которым выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям-партнерам.

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

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

Microsoft.Online.Administation.RoleMember

Этот командлет возвращает объекты-члены роли, которые содержат следующие сведения:

  • DisplayName. Отображаемое имя члена роли.

  • Emailaddress. Адрес электронной почты члена роли.

  • IsLicensed. Лицензирован пользователь или нет.

  • LastDirSyncTime. Дата и время последней синхронизации этого члена

  • Objectid. Уникальный идентификатор члена.

  • OverallProvisioningStatus. Состояние подготовки этого пользователя.

  • RoleMemberType. Тип члена роли. Сейчас поддерживается только "пользователь".

  • ValidationStatus. Существуют ли ошибки в этом члене группы.