Freigeben über

Get-UnifiedGroup

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Get-UnifiedGroup, um Microsoft 365-Gruppen in Ihrer cloudbasierten organization 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

Identity (Standard) 

Get-UnifiedGroup
    [[-Identity] <UnifiedGroupIdParameter>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

AnrSet 

Get-UnifiedGroup
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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 beim Erstellen eines Microsoft-Teams erstellt werden.

Parameter

-Anr

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AnrSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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.

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

Typ:UnifiedGroupIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Identity
Position:1
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Schalter IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames gibt an, ob die SMTP-Adressen und Anzeigenamen von AcceptMessagesOnlyFromSendersOrMembers-Empfängern in der AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames-Eigenschaft zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

Dieser Schalter wurde eingeführt, um lesbare Bezeichner in den Ergebnissen des Cmdlets wiederherzustellen. Wenn Sie diesen Schalter nicht verwenden, werden AcceptMessagesOnlyFromSendersOrMembers-Empfänger als GUIDs angezeigt, und die AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames-Eigenschaft ist leer.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeAllProperties

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Schalter IncludeBypassModerationFromSendersOrMembersWithDisplayNames gibt an, ob die SMTP-Adressen und Anzeigenamen der BypassModerationFromSendersOrMembers-Empfänger in der BypassModerationFromSendersOrMembersWithDisplayNames-Eigenschaft zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

Dieser Schalter wurde eingeführt, um lesbare Bezeichner in den Ergebnissen des Cmdlets wiederherzustellen. Wenn Sie diesen Schalter nicht verwenden, werden BypassModerationFromSendersOrMembers-Empfänger als GUIDs angezeigt, und die BypassModerationFromSendersOrMembersWithDisplayNames-Eigenschaft ist leer.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeGrantSendOnBehalfToWithDisplayNames

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der IncludeGrantSendOnBehalfToWithDisplayNames-Schalter gibt an, ob die SMTP-Adressen und Anzeigenamen von GrantSendOnBehalfTo-Empfängern in der GrantSendOnBehalfToWithDisplayNames-Eigenschaft zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

Dieser Schalter wurde eingeführt, um lesbare Bezeichner in den Ergebnissen des Cmdlets wiederherzustellen. Wenn Sie diesen Schalter nicht verwenden, werden GrantSendOnBehalfTo-Empfänger als GUIDs angezeigt, und die GrantSendOnBehalfToDisplayNames-Eigenschaft ist leer.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeModeratedByWithDisplayNames

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Schalter IncludeModeratedByWithDisplayNames gibt an, ob die SMTP-Adressen und Anzeigenamen von ModeratedBy-Empfängern in der ModeratedByWithDisplayNames-Eigenschaft zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

Dieser Schalter wurde eingeführt, um lesbare Bezeichner in den Ergebnissen des Cmdlets wiederherzustellen. Wenn Sie diesen Schalter nicht verwenden, werden ModeratedBy-Empfänger als GUIDs angezeigt, und die ModeratedByWithDisplayNames-Eigenschaft ist leer.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Schalter IncludeRejectMessagesFromSendersOrMembersWithDisplayNames gibt an, ob die SMTP-Adressen und Anzeigenamen von RejectMessagesFromSendersOrMembers-Empfängern in der RejectMessagesFromSendersOrMembersWithDisplayNames-Eigenschaft zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

Dieser Schalter wurde eingeführt, um lesbare Bezeichner in den Ergebnissen des Cmdlets wiederherzustellen. Wenn Sie diesen Schalter nicht verwenden, werden ModeratedBy-Empfänger als GUIDs angezeigt, und die RejectMessagesFromSendersOrMembersWithDisplayNames-Eigenschaft ist leer.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IncludeSoftDeletedGroups

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResultSize

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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.

Parametereigenschaften

Typ:Unlimited
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SortBy

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.