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. Geben Sie zum Abrufen einer Gruppe 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

Dieser Befehl ruft alle Gruppen in der Microsoft Entra-ID ab.

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

Gibt bei true alle Gruppen zurück. Gibt bei false die Anzahl von Objekten zurück, die durch den Top-Parameter angegeben wird.

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

-Filter

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

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

-Id

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

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

-SearchString

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

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

-Top

Gibt die maximale Anzahl von Datensätzen an, die von diesem cmldet abgerufen werden. Der Standardwert ist 100.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.