Freigeben über

Get-AzureADMSGroup

  • Referenz
Modul:
AzureADPreview

Ruft Informationen zu Gruppen in Azure AD ab.

Syntax

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

Beschreibung

Das Cmdlet Get-AzureADMSGroup ruft Informationen zu Gruppen in Azure Active Directory (Azure AD) 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

Mit diesem Befehl werden alle Gruppen in Azure AD 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.

Beispiel 3: Abrufen von AssignedLabels- und DisplayName-Eigenschaftswerten für alle Gruppen

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

Mit diesem Befehl werden die Eigenschaftswerte AssignedLabels und DisplayName für alle Gruppen abgerufen.

Die AssignedLabels-Gruppeneigenschaft kann nur vom Select-Parameter abgerufen werden.

Beispiel 4: Abrufen von AssignedLabels- und DisplayName-Eigenschaftswerten für eine Gruppe

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

Mit diesem Befehl werden die Eigenschaftswerte AssignedLabels und DisplayName für eine bestimmte Gruppe abgerufen.

Die AssignedLabels-Gruppeneigenschaft kann nur vom Select-Parameter abgerufen werden.

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.

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

-Select

Gibt eine Liste der abzurufenden Gruppeneigenschaften an.

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

-Top

Gibt die maximale Anzahl von Datensätzen an, die von diesem cmldet abgerufen werden. 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

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.