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

Get-MsolGroup

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

Возвращает группы из Azure Active Directory.

Синтаксис

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Описание

Командлет Get-MsolGroup получает группы из Azure Active Directory. Этот командлет можно использовать для возврата одной группы, если указан параметр ObjectId , или для поиска во всех группах.

Примеры

Пример 1. Получение группы с помощью идентификатора

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Эта команда возвращает объект группы с указанным идентификатором.

Пример 2. Получение всех групп

PS C:\> Get-MsolGroup

Эта команда возвращает весь набор групп для клиента, вплоть до 250 результатов по умолчанию.

Пример 3. Получение группы с помощью имени участника-пользователя

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Данная команда возвращает агентские группы, членом которых является пользователь. Применяется только для компаний с партнерскими привилегиями.

Параметры

-All

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

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

-GroupType

Указывает тип групп, которые требуется получить. Допустимые значения: Security, MailEnabledSecurity и DistributionList.

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

-HasErrorsOnly

Указывает, что этот командлет возвращает только группы с ошибками проверки.

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

-HasLicenseErrorsOnly

Указывает, возвращает ли этот командлет только группы безопасности с ошибками лицензии.

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

-IsAgentRole

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

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

-MaxResults

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

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

-ObjectId

Указывает уникальный идентификатор объекта получаемой группы.

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

-SearchString

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

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

-TenantId

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

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

-UserObjectId

Указывает уникальный идентификатор пользователя. Этот командлет возвращает группы безопасности, к которым принадлежит этот пользователь. Этот параметр необходимо использовать вместе с параметром IsAgentRole .

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

-UserPrincipalName

Указывает имя участника-пользователя пользователя. Этот командлет возвращает группы безопасности, к которым принадлежит этот пользователь. Этот параметр необходимо использовать вместе с параметром IsAgentRole .

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

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

Microsoft.Online.Administration.Group

Этот командлет возвращает список групп, включающих следующие сведения:

  • CommonName. Общее имя группы.

  • Описание. Описание группы.

  • DisplayName. Отображаемое имя группы.

  • Emailaddress. Адреса электронной почты группы. Не возвращается для групп безопасности.

  • Ошибки. Список ошибок для группы.

  • GroupType. Тип группы. Типы могут быть SecurityGroup, DistributionList или MailEnabledSecurityGroup.

  • IsSystem. Является ли эта группа системной группой (созданной Azure Active Directory). Эти группы могут обновляться или удаляться.

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

  • Managedby. Владелец группы.

  • Objectid. Уникальный идентификатор объекта группы.

  • Прокси-адреса. Прокси-адреса, связанные с этой группой (только для групп с поддержкой почты).

  • ValidationStatus. Имеет ли группа ошибки или нет.