Freigeben über

Get-UnifiedGroup

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Online, Exchange Online Protection

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Get-UnifiedGroup, um Microsoft 365-Gruppen in Ihrer cloudbasierten Organisation anzuzeigen. Verwenden Sie das Cmdlet Get-UnifiedGroupLinks, um Mitglieder, Besitzer und Abonnenten für Microsoft 365-Gruppen anzuzeigen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-UnifiedGroup
   [[-Identity] <UnifiedGroupIdParameter>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]
Get-UnifiedGroup
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Beschreibung

Microsoft 365-Gruppen sind Gruppenobjekte, die in Microsoft 365-Diensten verfügbar sind.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Get-UnifiedGroup

In diesem Beispiel wird eine Zusammenfassungsliste aller Microsoft 365-Gruppen zurückgegeben.

Beispiel 2

Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType

In diesem Beispiel werden die folgenden Informationen zu allen Microsoft 365-Gruppen zurückgegeben:

  • Distinguished Name (DN)
  • E-Mail-Adresse
  • Beschreibung
  • Besitzer
  • Datenschutz

Beispiel 3

Get-UnifiedGroup -Identity "Marketing Department" | Format-List

In diesem Beispiel werden ausführliche Informationen zur Microsoft 365-Gruppe mit dem Namen Marketing Department zurückgegeben.

Beispiel 4

Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}

In diesem Beispiel werden Microsoft 365-Gruppen zurückgegeben, die keinen Besitzer haben.

Beispiel 5

Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}

In diesem Beispiel werden Microsoft 365-Gruppen zurückgegeben, die erstellt werden, wenn ein Microsoft Team erstellt wird.

Parameter

-Anr

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Filter

Der Parameter Filter verwendet die OPATH-Syntax, um die Ergebnisse nach den angegebenen Eigenschaften und Werten zu filtern. Das Suchkriterium verwendet die Syntax "Property -ComparisonOperator 'Value'".

  • Schließen Sie den gesamten OPATH-Filter in doppelte Anführungszeichen " ein. Wenn der Filter Systemwerte enthält (z. B. $true, $falseoder $null), verwenden Sie stattdessen einfache Anführungszeichen ''. Obwohl dieser Parameter eine Zeichenfolge ist (kein Systemblock), können Sie auch geschweifte Klammern { } verwenden, jedoch nur, wenn der Filter keine Variablen enthält.
  • Eigenschaft ist eine filterbare Eigenschaft. Weitere Informationen zu den filterbaren Eigenschaften in Exchange Server und Exchange Online finden Sie unter Filterbare Eigenschaften für den Filter-Parameter.
  • ComparisonOperator ist ein OPATH-Vergleichsoperator (z. B -eq . für gleich und -like für den Zeichenfolgenvergleich). Weitere Informationen über Vergleichsoperatoren finden Sie unter about_Comparison_Operators.
  • Wert ist der zu suchende Eigenschaftswert. Fügen Sie Textwerte und Variablen in einfache Anführungszeichen ('Value' oder '$Variable') ein. Wenn ein Variablenwert einfache Anführungszeichen enthält, müssen Sie die einfachen Anführungszeichen identifizieren (escape), um die Variable korrekt zu erweitern. Sie können z. B. '$($User -Replace "'","''")' anstelle von '$User' verwenden. Schließen Sie keine ganzen Zahlen oder Systemwerte in Anführungszeichen ein (verwenden Sie stattdessen beispielsweise 500$true, $false oder $null).

Sie können mehrere Suchkriterien mithilfe der logischen Operatoren -and und -or miteinander verketten. Zum Beispiel "Criteria1 -and Criteria2" oder "(Criteria1 -and Criteria2) -or Criteria3".

Ausführliche Informationen zu OPATH-Filtern in Exchange finden Sie unter Zusätzliche Informationen zur OPATH-Syntax.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Der Parameter Identity gibt die Microsoft 365-Gruppe an, die Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der die Microsoft 365-Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Alias
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • Kanonischer DN
  • GUID

Hinweis: Sie können den DisplayName-Wert verwenden, um die Microsoft 365-Gruppe zu identifizieren, aber die Ergebnisse sind nicht garantiert eindeutig. Wenn Sie ein einmaliges und eindeutiges Ergebnis zurückgeben müssen, verwenden Sie einen eindeutigen Bezeichner für die Microsoft 365-Gruppe.

Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IncludeAllProperties

Der IncludeAllProperties-Schalter gibt an, ob die Werte aller Eigenschaften in die Ergebnisse eingeschlossen werden sollen. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Schalter nicht verwenden, werden die Werte einiger Eigenschaften (z. B. CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl und PhotoUrl) möglicherweise leer angezeigt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IncludeSoftDeletedGroups

Der IncludeSoftDeletedGroups-Schalter gibt an, ob vorläufig gelöschte Microsoft 365-Gruppen in die Ergebnisse eingeschlossen werden sollen. Sie müssen bei dieser Option keinen Wert angeben.

Vorläufig gelöschte Microsoft 365-Gruppen sind gelöschte Gruppen, die noch wiederhergestellt werden können.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ResultSize

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SortBy

Der Parameter SortBy gibt die Eigenschaft an, nach der die Ergebnisse sortiert werden sollen. Sie können die Sortierung nur jeweils nach einer Eigenschaft vornehmen. Die Ergebnisse werden in absteigender Reihenfolge sortiert.

Wenn die Standardansicht die Eigenschaft, nach der Sie sortieren, nicht enthält, können Sie den Befehl mit | Format-Table -Auto Property1,Property2,...PropertyX anhängen. um eine neue Ansicht zu erstellen, die alle Eigenschaften enthält, die Sie sehen möchten. Platzhalter (*) in den Eigenschaftsnamen werden unterstützt.

Nach den folgende Eigenschaften kann sortiert werden:

  • Name
  • DisplayName
  • Alias
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection