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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GroupType

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

Type:GroupType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasLicenseErrorsOnly

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAgentRole

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

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

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserObjectId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.Online.Administration.Group

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

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

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

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

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

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

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

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

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

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

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

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

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