Get-AzureADMSGroup

  • Odwołanie
Moduł:
AzureAD

Pobiera informacje o grupach w identyfikatorze Microsoft Entra (za pośrednictwem programu MS Graph).

Składnia

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

Opis

Polecenie cmdlet Get-AzureADMSGroup pobiera informacje o grupach w identyfikatorze Microsoft Entra przy użyciu programu Microsoft Graph. Aby uzyskać grupę, określ parametr Id. Określ parametr SearchString lub Filter, aby znaleźć określone grupy. Jeśli nie określisz żadnych parametrów, to polecenie cmdlet pobierze wszystkie grupy.

Przykłady

Przykład 1. Pobieranie wszystkich grup

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

To polecenie pobiera wszystkie grupy w identyfikatorze Microsoft Entra.

Przykład 2. Pobieranie określonej grupy przy użyciu identyfikatora

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

To polecenie pobiera informacje dla grupy, która ma określony identyfikator.

Parametry

-All

Jeśli wartość true, zwróć wszystkie grupy. Jeśli wartość false, zwróć liczbę obiektów określonych przez parametr Top

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

-Filter

Określa ciąg filtru oData w wersji 3.0, aby był zgodny z zestawem grup.

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

-Id

Określa identyfikator grupy, którą pobiera to polecenie cmdlet.

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

-SearchString

Określa ciąg wyszukiwania. To polecenie cmdlet pobiera grupy, które mają atrybuty DisplayName lub Description zgodne z ciągiem wyszukiwania.

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

-Top

Określa maksymalną liczbę rekordów pobieranych przez program cmldet. Wartość domyślna to 100.

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

Dane wejściowe

String

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

Dane wyjściowe

Object

Uwagi

Zobacz przewodnik migracji dla polecenia Get-AzureADMSGroup do programu Microsoft Graph PowerShell.

To polecenie cmdlet jest obecnie dostępne w publicznej wersji zapoznawczej. Chociaż polecenie cmdlet jest dostępne w publicznej wersji zapoznawczej, możemy wprowadzić zmiany w poleceniu cmdlet, które może mieć nieoczekiwane skutki. Zalecamy, aby to polecenie cmdlet nie było używane w środowisku produkcyjnym.