Udostępnij za pośrednictwem

Get-AzureADMSGroup

  • Odwołanie
Moduł:
AzureAD

Pobiera informacje o grupach w identyfikatorze Entra firmy Microsoft (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 ID 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 parametrów, to polecenie cmdlet pobiera 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 Entra firmy Microsoft.

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Filter

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Id

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SearchString

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Top

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

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 w programie 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.