Freigeben über

Get-MsolGroup

  • Referenz
Modul:
MSOnline

Ruft Gruppen aus Azure Active Directory ab.

Syntax

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-MsolGroup ruft Gruppen aus Azure Active Directory ab. Dieses Cmdlet kann verwendet werden, um eine einzelne Gruppe zurückzugeben, wenn Sie den ObjectId-Parameter angeben, oder um innerhalb aller Gruppen zu suchen.

Beispiele

Beispiel 1: Abrufen einer Gruppe mithilfe einer ID

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Dieser Befehl gibt das Gruppenobjekt zurück, das über die angegebene ID verfügt.

Beispiel 2: Abrufen aller Gruppen

PS C:\> Get-MsolGroup

Dieser Befehl gibt den gesamten Gruppensatz für den Mandanten zurück, bis zu den Standardergebnissen von 250.

Beispiel 3: Abrufen einer Gruppe mithilfe eines Benutzerprinzipalnamens

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Dieser Befehl gibt die Agent-Gruppen zurück, in denen der Benutzer Mitglied ist. Dies gilt nur für Unternehmen, die über Partnerberechtigungen verfügen.

Parameter

-All

Gibt an, dass dieses Cmdlet alle gefundenen Ergebnisse zurückgibt. Geben Sie diesen Parameter und den MaxResults-Parameter nicht an.

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

-GroupType

Gibt den Typ der abzurufenden Gruppen an. Gültige Werte sind Security, MailEnabledSecurity und DistributionList.

Typ:GroupType
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HasErrorsOnly

Gibt an, dass dieses Cmdlet nur Gruppen zurückgibt, die Überprüfungsfehler aufweisen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HasLicenseErrorsOnly

Gibt an, ob dieses Cmdlet nur Sicherheitsgruppen zurückgibt, die Lizenzfehler aufweisen.

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

-IsAgentRole

Gibt an, dass dieses Cmdlet nur Agentgruppen zurückgibt. Dieser Wert gilt nur für Partnerbenutzer.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxResults

Gibt die maximale Anzahl von Ergebnissen an, die dieses Cmdlet zurückgibt. Der Standardwert ist 250.

Typ:Int32
Position:Named
Standardwert:250
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ObjectId

Gibt die eindeutige Objekt-ID der gruppe an, die abgerufen werden soll.

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

-SearchString

Gibt eine Zeichenfolge an. Dieses Cmdlet gibt Sicherheitsgruppen mit einem Anzeigenamen zurück, der mit dieser Zeichenfolge beginnt.

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

-TenantId

Gibt die eindeutige ID des Mandanten an, für den der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

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

-UserObjectId

Gibt die eindeutige ID eines Benutzers an. Dieses Cmdlet gibt Sicherheitsgruppen zurück, zu denen dieser Benutzer gehört. Dieser Parameter muss zusammen mit dem Parameter IsAgentRole verwendet werden.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserPrincipalName

Gibt den Benutzerprinzipalnamen eines Benutzers an. Dieses Cmdlet gibt Sicherheitsgruppen zurück, zu denen dieser Benutzer gehört. Dieser Parameter muss zusammen mit dem Parameter IsAgentRole verwendet werden.

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

Ausgaben

Microsoft.Online.Administration.Group

Dieses Cmdlet gibt eine Liste von Gruppen zurück, die die folgenden Informationen enthalten:

  • CommonName. Der allgemeine Name (CN) der Gruppe.

  • Beschreibung Eine Beschreibung der Gruppe.

  • DisplayName. Der Anzeigename der Gruppe.

  • Emailaddress. Die E-Mail-Adressen der Gruppe. Diese Angabe wird für Sicherheitsgruppen nicht zurückgegeben.

  • Fehler. Eine Liste der Fehler für die Gruppe.

  • Ein GroupType. Der Typ der Gruppe. Typen können SecurityGroup, DistributionList oder MailEnabledSecurityGroup sein.

  • IsSystem. Gibt an, ob es sich bei dieser Gruppe um eine Systemgruppe handelt (erstellt von Azure Active Directory). Diese Gruppen können nicht aktualisiert oder entfernt werden.

  • LastDirSyncTime. Das Datum und die Uhrzeit der letzten Synchronisierung der Gruppe.

  • Managedby. Der Besitzer der Gruppe.

  • Objectid. Die eindeutige Objekt-ID der Gruppe.

  • Proxyadressen. Die dieser Gruppe zugeordneten Proxyadressen (nur für E-Mail-aktivierte Gruppen).

  • Ein ValidationStatus. Gibt an, ob für die Gruppe Fehler aufgetreten sind.