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

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.

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

-Filter

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

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

-Id

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

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

-SearchString

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

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

-Top

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

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

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

String

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

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

Object

Примечания

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

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