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 innerhalb aller Gruppen suchen möchten.

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 die angegebene ID aufweist.

Beispiel 2: Abrufen aller Gruppen

PS C:\> Get-MsolGroup

Dieser Befehl gibt den gesamten Satz von Gruppen 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 Ergebnisse zurückgibt, die sie findet. Geben Sie diesen Parameter und den MaxResults-Parameter nicht an.

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

-GroupType

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

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

-HasErrorsOnly

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

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

-HasLicenseErrorsOnly

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

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

-IsAgentRole

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

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

-MaxResults

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

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

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

-SearchString

Gibt eine Zeichenfolge an. Dieses Cmdlet gibt Sicherheitsgruppen zurück, die über einen Anzeigenamen verfügen, der mit dieser Zeichenfolge beginnt.

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

-TenantId

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

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

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

-UserPrincipalName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Ob diese Gruppe eine Systemgruppe ist (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 Proxyadressen, die dieser Gruppe zugeordnet sind (nur für E-Mail-aktivierte Gruppen).

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