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

Get-AzureADMSGroup

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

Возвращает сведения о группах в идентификаторе Microsoft Entra (через MS Graph).

Синтаксис

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [<CommonParameters>]

Описание

Командлет Get-AzureADMSGroup получает сведения о группах в идентификаторе Microsoft Entra с помощью Microsoft Graph. Чтобы получить группу, укажите параметр Id. Укажите параметр SearchString или Filter, чтобы найти определенные группы. Если параметры не указаны, этот командлет получает все группы.

Примеры

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

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   :
ADSyncOperators
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : ADSyncOperators
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {}
MembershipRule                :
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

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

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

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

Эта команда получает сведения о группе с указанным идентификатором.

Параметры

-All

Если значение равно true, возвращаются все группы. Если задано значение false, возвращается количество объектов, указанное параметром Top.

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

-Filter

Указывает строку фильтра oData версии 3.0 для соответствия набору групп.

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

-Id

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

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

-SearchString

Указывает строку поиска. Этот командлет получает группы с атрибутами DisplayName или Description, которые соответствуют строке поиска.

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

-Top

Указывает максимальное количество записей, которые получает этот cmldet. По умолчанию используется значение 100.

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

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

String

System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

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

Object

Примечания

См. руководство по миграции get-AzureADMSGroup в Microsoft Graph PowerShell.

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