Freigeben über

Get-AzureADMSGroup

  • Referenz
Modul:
AzureAD

Ruft Informationen zu Gruppen in der Microsoft Entra-ID ab (über MS Graph).

Syntax

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

Beschreibung

Das Cmdlet Get-AzureADMSGroup ruft Mithilfe von Microsoft Graph Informationen zu Gruppen in der Microsoft Entra-ID ab. Um eine Gruppe abzurufen, geben Sie den Id-Parameter an. Geben Sie den SearchString- oder Filter-Parameter an, um nach bestimmten Gruppen zu suchen. Wenn Sie keine Parameter angeben, ruft dieses Cmdlet alle Gruppen ab.

Beispiele

Beispiel 1: Abrufen aller Gruppen

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

Mit diesem Befehl werden alle Gruppen in der Microsoft Entra-ID abgerufen.

Beispiel 2: Abrufen einer bestimmten Gruppe mithilfe einer ID

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

Dieser Befehl ruft Informationen für die Gruppe ab, die über die angegebene ID verfügt.

Parameter

-All

Wenn true, geben Sie alle Gruppen zurück. Wenn false, geben Sie die Anzahl der Objekte zurück, die vom Top-Parameter angegeben sind.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Filter

Gibt eine oData v3.0-Filterzeichenfolge an, die mit einer Gruppe von Gruppen übereinstimmt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Id

Gibt die ID der Gruppe an, die dieses Cmdlet abruft.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SearchString

Gibt eine Suchzeichenfolge an. Dieses Cmdlet ruft Gruppen ab, die über DisplayName- oder Description-Attribute verfügen, die der Suchzeichenfolge entsprechen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Top

Gibt die maximale Anzahl von Datensätzen an, die dieser cmldet abruft. Der Standardwert ist 100.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

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

Ausgaben

Object

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für Get-AzureADMSGroup zu Microsoft Graph PowerShell.

Dieses Cmdlet befindet sich derzeit in der öffentlichen Vorschau. Während sich ein Cmdlet in der öffentlichen Vorschau befindet, nehmen wir möglicherweise Änderungen am Cmdlet vor, die unerwartete Auswirkungen haben können. Es wird empfohlen, dieses Cmdlet nicht in einer Produktionsumgebung zu verwenden.