Feedback Bearbeiten

Gruppen-Ressourcentyp

  • Artikel
  • 18 Minuten Lesedauer

Namespace: microsoft.graph

Stellt eine Azure Active Directory-Gruppe (Azure AD-Gruppe) dar, bei der es sich um eine Microsoft 365-Gruppe oder eine Sicherheitsgruppe handeln kann. Diese Ressource ist ein offener Typ, mit dem andere Eigenschaften übergeben werden können.

Erbt von directoryObject.

Aus Leistungsgründen geben die Vorgänge create, get und list standardmäßig nur eine Teilmenge häufig verwendeter Eigenschaften zurück. Diese Standard eigenschaften werden im Abschnitt Eigenschaften aufgeführt. Zum Abrufen von Eigenschaften, die nicht standardmäßig zurückgegeben werden, geben sie diese in einer OData-Abfrageoption $select an.

Diese Ressource unterstützt Folgendes:

Methoden

Methode Rückgabetyp Beschreibung
Gruppenverwaltung
Gruppe erstellen group Create a new group. It can be a Microsoft 365 group, dynamic group, or security group.
Gruppe abrufen Gruppe Liest die Eigenschaften eines Gruppenobjekts.
Gruppen auflisten Gruppensammlung Listet Gruppenobjekte und deren Eigenschaften auf.
Gruppe aktualisieren Keine Aktualisiert die Eigenschaften eines Gruppenobjekts.
Gruppe löschen Keiner Löscht das Gruppenobjekt.
delta group-Sammlung Dient zum Abrufen inkrementeller Änderungen für Gruppen.
Mitglieder hinzufügen Keine Fügen Sie dieser Gruppe einen Benutzer oder eine Gruppe durch eine Veröffentlichung in der Navigationseigenschaft Mitglieder hinzu (wird nur für Sicherheitsgruppen und Microsoft 365 Gruppen unterstützt).
Besitzer hinzufügen Keine Fügen Sie einen neuen Besitzer für die Gruppe durch eine Veröffentlichung in der Navigationseigenschaft Besitzer hinzu (wird nur für Sicherheitsgruppen und Microsoft 365 Gruppen unterstützt).
Einstellung erstellen groupSetting Erstellen Sie eine Einstellungsobjekt basierend auf einer groupSettingTemplate. Die POST-Anforderung muss settingValues für alle Einstellungen bereitstellen, die in der Vorlage definiert sind. Für diesen Vorgang können nur gruppenspezifische Vorlagen verwendet werden.
Einstellung löschen Keine Löscht ein Einstellungsobjekt.
Einstellung abrufen groupSetting Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.
List groupLifecyclePolicies groupLifecyclePolicy-Sammlung Dient zum Auflisten der Gruppenlebenszyklusrichtlinien.
Mitglieder auflisten directoryObject-Sammlung Rufen Sie die direkten Mitglieder dieser Gruppe aus der members-Navigationseigenschaft ab.
Besitzer auflisten directoryObject-Sammlung Ruft die Besitzer der Gruppe aus der owners-Navigationseigenschaft ab.
Einstellungen auflisten groupSetting-Sammlung Listet Eigenschaften aller Einstellungsobjekte auf.
Transitive Mitglieder auflisten directoryObject-Sammlung Ruft die Benutzer, Gruppen und Geräte ab, die Mitglieder sind, einschließlich der geschachtelten Mitglieder dieser Gruppe.
Transitive memberOf auflisten directoryObject-Sammlung Gruppen auflisten, bei denen diese Gruppe Mitglied ist. Dieser Vorgang ist transitiv und schließt die Gruppen ein, in denen diese Gruppe ein geschachteltes Mitglied.
Mitglied entfernen Keine Entfernen Sie ein Mitglied aus einer Microsoft 365-Gruppe oder einer Sicherheitsgruppe über die members-Navigationseigenschaft.
Besitzer entfernen Keiner Entfernen Sie einen Besitzer aus einer Microsoft 365-Gruppe oder einer Sicherheitsgruppe über die owners-Navigationseigenschaft.
Einstellung aktualisieren groupSetting Aktualisiert ein Einstellungsobjekt.
assignLicense group Add or remove subscriptions for the group. You can also enable and disable specific plans associated with a subscription.
Renew Boolescher Wert Renews a group's expiration. When a group is renewed, the group expiration is extended by the number of days defined in the policy.
validateProperties JSON Überprüften, ob der Anzeigename oder E-Mail-Spitzname einer Microsoft 365-Gruppe den Benennungsrichtlinien entspricht.
App-Rollenzuweisungen
List appRoleAssignments appRoleAssignment-Auflistung Apps und App-Rollen abrufen, die dieser Gruppe zugeordnet wurden.
appRoleAssignment hinzufügen appRoleAssignment Dieser Gruppe eine App-Rolle zuweisen.
appRoleAssignment entfernen Keine. Eine App-Rollenzuweisung aus dieser Gruppe entfernen.
Calendar
Ereignis erstellen Ereignis Erstellt ein neues Ereignis durch Veröffentlichen in der Ereignissammlung.
Ereignis abrufen Ereignis Liest die Eigenschaften eines Ereignisobjekts.
Ereignisse auflisten event-Sammlung Ruft eine Ereignisobjektsammlung ab.
Ereignis aktualisieren Keine Dient zum Aktualisieren der Eigenschaften eines Ereignisobjekts.
Ereignis löschen Keine Löscht das Ereignisobjekt.
calendarView auflisten Ereignissammlung Ruft eine Auflistung der Ereignisse in einem angegebenen Zeitfenster ab.
Unterhaltungen
Unterhaltung erstellen Unterhaltung Erstellt eine neue Unterhaltung durch Veröffentlichung in der Unterhaltungssammlung.
Unterhaltung abrufen Unterhaltung Dient zum Lesen der Eigenschaften eines Unterhaltungsobjekts.
Unterhaltungen auflisten Unterhaltungssammlung Ruft eine Unterhaltungsobjektsammlung ab.
Unterhaltung löschen Keine Löscht ein Unterhaltungsobjekt.
Thread erstellen conversationThread Erstellt einen neuen Unterhaltungsthread.
Thread abrufen conversationThread Liest die Eigenschaften eines Threadobjekts.
Threads auflisten conversationThread-Sammlung Ruft alle Threads einer Gruppe ab.
Thread aktualisieren Keine Aktualisiert die Eigenschaften eines Threadobjekts.
Thread löschen Keine Löscht das Threadobjekt.
acceptedSenders auflisten directoryObject collection Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der accepted-senders für diese Gruppe befinden.
acceptedSender hinzufügen directoryObject Fügt einen Benutzer oder eine Gruppe zur acceptSenders-Sammlung hinzu.
acceptedSender entfernen directoryObject Entfernt einen Benutzer oder eine Gruppe aus der acceptedSenders-Sammlung.
rejectedSenders auflisten directoryObject collection Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der rejected-senders für diese Gruppe befinden.
rejectedSender hinzufügen directoryObject Fügt einen neuen Benutzer oder eine neue Gruppe zur rejectedSender-Sammlung hinzu.
rejectedSender entfernen directoryObject Entfernt einen Benutzer oder eine neue Gruppe aus der rejectedSenders-Sammlung.
Einstellung erstellen groupSetting Erstellen Sie eine Einstellungsobjekt basierend auf einer groupSettingTemplate. Die POST-Anforderung muss settingValues für alle Einstellungen bereitstellen, die in der Vorlage definiert sind. Für diesen Vorgang können nur gruppenspezifische Vorlagen verwendet werden.
Verzeichnisobjekte
Gelöschte Gruppen auflisten directoryObject-Sammlung Rufen Sie die Gruppen ab, die in den letzten 30 Tagen im Mandanten gelöscht wurden.
Auflisten der gelöschten Gruppen im Besitz eines Benutzers directoryObject-Sammlung Rufen Sie die Gruppen ab, die in den letzten 30 Tagen im Mandanten gelöscht wurden und sich im Besitz eines Benutzers befinden.
Gelöschte Gruppe abrufen directoryObject-Sammlung Rufen Sie eine gelöschte Gruppe nach ID ab.
Gelöschte Gruppe wiederherstellen directoryObject-Sammlung Stellen Sie eine Gruppe wieder her, die in den letzten 30 Tagen im Mandanten gelöscht wurde.
Gruppe dauerhaft löschen directoryObject-Sammlung Löschen Sie eine gelöschte Gruppe dauerhaft aus dem Mandanten.
checkMemberGroups Zeichenfolgenauflistung Sucht nach einer Mitgliedschaft in einer Liste von Gruppen. Die Funktion ist transitiv.
getMemberGroups String collection Gibt alle Gruppen zurück, bei denen die Gruppe Mitglied ist. Die Funktion ist transitiv.
checkMemberObjects String-Sammlung Überprüfen Sie die Mitgliedschaft in einer Liste von Gruppen, Verzeichnisrollen- oder Verwaltungseinheitsobjekten. Die Funktion ist transitiv.
getMemberObjects Zeichenfolgenauflistung Gibt alle Gruppen und administrativen Einheiten zurück, in denen der Benutzer Mitglied ist. Die Funktion ist transitiv.
Gruppeneinstellungen
Einstellung abrufen groupSetting Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.
Einstellungen auflisten groupSetting-Sammlung Listet Eigenschaften aller Einstellungsobjekte auf.
Einstellung aktualisieren Keine Aktualisiert ein Einstellungsobjekt.
Einstellung löschen Keine Löscht ein Einstellungsobjekt.
Abrufen der Einstellungsvorlage Keine Liest Eigenschaften einer Einstellungsvorlage.
Auflisten der Einstellungsvorlage Keine Listet Eigenschaften aller Einstellungsvorlagen auf.
Offene Erweiterungen
Offene Erweiterung erstellen openTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.
Schemaerweiterungen
Schemaerweiterungswerte hinzufügen Keine Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.
Andere Gruppenressourcen
Fotos auflisten profilePhoto-Sammlung Ruft eine Sammlung von Profilfotos für die Gruppe ab.
plannerPlans auflisten plannerPlan-Sammlung Ruft Plannerer-Pläne im Besitz der Gruppe ab.
Benutzereinstellungen
addFavorite Keine Add the group to the list of the signed-in user's favorite groups. Supported for only Microsoft 365 groups.
removeFavorite Keine Remove the group from the list of the signed-in user's favorite groups. Supported for only Microsoft 365 groups.
List memberOf directoryObject-Sammlung Ruft anhand der Navigationseigenschaft memberOf die Gruppen und administrativen Einheiten ab, bei denen dieser Benutzer direktes Mitglied ist.
subscribeByMail Keiner Legt die „isSubscribedByMail“-Eigenschaft auf true fest. Aktiviert den angemeldeten Benutzer für den Erhalt von E-Mail-Unterhaltungen. Wird nur für Microsoft 365-Gruppen unterstützt.
unsubscribeByMail Keiner Legt die „isSubscribedByMail“-Eigenschaft auf false fest. Der angemeldete Benutzer wird für den Empfang von E-Mail-Unterhaltungen deaktiviert. Wird nur für Microsoft 365 Gruppen unterstützt.
resetUnseenCount Keine Reset the unseenCount to 0 of all the posts that the signed-in user has not seen since their last visit. Supported for only Microsoft 365 groups.

Eigenschaften

Wichtig

Die spezifische Verwendung von $filter und des Abfrageparameters $search wird nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual und $count festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Azure AD-Verzeichnisobjekte.

Eigenschaft Typ Beschreibung
allowExternalSenders Boolescher Wert Gibt an, ob Personen außerhalb der Organisation Nachrichten an die Gruppe senden können. Der Standardwert ist false.

Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID})
assignedLabels assignedLabel-Sammlung Die Liste der Vertraulichkeitsbezeichnungspaare (Bezeichnungs-ID, Bezeichnungsname), die einer Office 365-Gruppe zugeordnet sind.

Wird nur auf $select zurückgegeben. Schreibgeschützt.
assignedLicenses assignedLicense-Sammlung Die Lizenzen, die der Gruppe zugewiesen sind.

Wird nur für $select zurückgegeben. Unterstützt $filter (eq). Schreibgeschützt.
autoSubscribeNewMembers Boolean Gibt an, ob neue Mitglieder, die der Gruppe hinzugefügt werden, automatisch für E-Mail-Benachrichtigungen abonniert sind. Sie können diese Eigenschaft in einer PATCH-Anforderung für die Gruppe festlegen. Legen Sie sie nicht in der anfänglichen POST-Anforderung fest, die die Gruppe erstellt. Der Standardwert ist false.

Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID})
classification Zeichenfolge Beschreibt eine Klassifizierung für die Gruppe (z. B. niedrige, mittlere oder hohe geschäftliche Auswirkungen). Gültige Werte für diese Eigenschaft werden durch die Erstellung eines ClassificationList-setting-Werts basierend auf der Vorlagendefinition erstellt.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, startsWith).
createdDateTime DateTimeOffset Zeitstempel der Gruppenerstellung. Der Wert kann nicht geändert werden und wird automatisch ausgefüllt, wenn die Gruppe erstellt wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.

Standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in). Schreibgeschützt.
deletedDateTime DateTimeOffset Bei einigen Azure Active Directory-Objekten (Benutzer, Gruppe, Anwendung) wird das gelöschte Objekt zunächst logisch gelöscht, und diese Eigenschaft wird mit Datum und Uhrzeit der Löschung des Objekts aktualisiert. Andernfalls ist diese Eigenschaft null. Wenn das Objekt wiederhergestellt wird, wird diese Eigenschaft auf null aktualisiert.
description String Eine optionale Beschreibung für die Gruppe.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, startsWith) und $search.
displayName Zeichenfolge Der Anzeigename der Gruppe. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht gelöscht werden. Die maximale Länge beträgt 256 Zeichen.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte), $search und $orderBy.
expirationDateTime DateTimeOffset Zeitstempel des festgelegten Ablaufs der Gruppe. Der Wert kann nicht geändert werden und wird automatisch ausgefüllt, wenn die Gruppe erstellt wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.

Standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in). Schreibgeschützt.
groupTypes Zeichenfolgensammlung Gibt den Typ und die Mitgliedschaft der Gruppe an.

If the collection contains Unified, the group is a Microsoft 365 group; otherwise, it's either a security group or distribution group. For details, see groups overview.

Wenn die Sammlung DynamicMembership enthält, verfügt die Gruppe über eine dynamische Mitgliedschaft, andernfalls ist die Mitgliedschaft statisch.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, not).
hasMembersWithLicenseErrors Boolesch Gibt an, ob es in dieser Gruppe Mitglieder mit Lizenzfehlern aus ihrer gruppenbasierten Lizenzzuweisung gibt.

This property is never returned on a GET operation. You can use it as a $filter argument to get groups that have members with license errors (that is, filter for this property being true). See an example.

Unterstützt $filter (eq).
hideFromAddressLists Boolescher Wert TRUE, wenn die Gruppe nicht in bestimmten Teilen der Outlook-Benutzeroberfläche angezeigt wird: Das Adressbuch, Adresslisten zum Auswählen von Nachrichtenempfängern und das Dialogfeld Gruppen durchsuchen zum Durchsuchen von Gruppen; andernfalls FALSE. Der Standardwert ist false.

Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID})
hideFromOutlookClients Boolesch „True“, wenn die Gruppe nicht in Outlook-Clients wie Outlook für Windows und Outlook im Web angezeigt wird; andernfalls „false“. Der Standardwert ist false.

Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID})
id Zeichenfolge Eindeutiger Bezeichner für die Gruppe.

Wird standardmäßig zurückgegeben. Geerbt von directoryObject. Key. Lässt keine Nullwerte zu. Schreibgeschützt.

Unterstützt $filter (eq, ne, not, in).
isArchived Boolesch Wenn eine Gruppe mit einem Team verknüpft ist, bestimmt diese Eigenschaft, ob sich das Team im schreibgeschützten Modus befindet.
Verwenden Sie zum Lesen dieser Eigenschaft den Endpunkt /group/{groupId}/team oder die API Team abrufen. Verwenden Sie zum Aktualisieren dieser Eigenschaft die APIsarchiveTeam und unarchiveTeam.
isAssignableToRole Boolesch Gibt an, ob diese Gruppe einer Azure Active Directory Rolle zugewiesen werden kann oder nicht. Optional.

Diese Eigenschaft kann nur beim Anlegen der Gruppe eingestellt werden und ist unveränderlich. Bei Festlegung auf true muss die securityEnabled-Eigenschaft ebenfalls auf true festgelegt werden und die Gruppe darf keine dynamische Gruppe sein (d. h. groupTypes darf nicht DynamicMembership enthalten). Nur Aufrufer in den Rollen "Globaler Administrator" und "Administrator mit privilegierten Rollen" können diese Eigenschaft festlegen. Dem aufrufenden Benutzer muss die RoleManagement.ReadWrite.Directory-Genehmigung zugewiesen werden, damit diese Eigenschaft festgelegt und die Mitgliedschaft solcher Gruppen aktualisiert werden kann. Weitere Informationen finden Sie unter Verwendung einer Gruppe zur Verwaltung von Azure AD-Rollenzuweisungen.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not).
isSubscribedByMail Boolesch Gibt an, ob der angemeldete Benutzer E-Mail-Unterhaltungen abonniert hat. Der Standardwert ist true.

Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID})
licenseProcessingState Zeichenfolge Zeigt den Status der Gruppenlizenzzuweisung an alle Mitglieder der Gruppe an. Der Standardwert ist false. Schreibgeschützt. Mögliche Werte: QueuedForProcessing, ProcessingInProgress, und ProcessingComplete.

Wird nur auf $select zurückgegeben. Schreibgeschützt.
mail Zeichenfolge Die SMTP-Adresse für die Gruppe, z. B. „serviceadmins@contoso.onmicrosoft.com“.

Wird standardmäßig zurückgegeben. Schreibgeschützt. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
mailEnabled Boolesch Gibt an, ob die Gruppe E-Mail-fähig ist. Erforderlich.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not).
mailNickname String Der E-Mail-Alias für die Gruppe, eindeutig für Microsoft 365-Gruppen in der Organisation. Die maximale Länge beträgt 64 Zeichen. Diese Eigenschaft darf nur Zeichen im ASCII-Zeichensatz 0 bis 127 mit Ausnahme der folgenden enthalten: @ () \ [] " ; : . <> , SPACE.

Erforderlich. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
membershipRule Zeichenfolge Die Regel, die Mitglieder dieser Gruppe bestimmt, wenn die Gruppe eine dynamische Gruppe ist (groupTypes enthält DynamicMembership). Weitere Informationen zur Syntax der Mitgliedschaftsregel finden Sie unter Regeln für eine dynamische Mitgliedschaft.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, startsWith).
membershipRuleProcessingState Zeichenfolge Gibt an, ob die Verarbeitung der dynamischen Mitgliedschaft aktiv ist oder angehalten wurde. Mögliche Werte: On oder Paused.

Identifiziert die der Gruppe zugeordneten Informationssegmente. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, in, ).
onPremisesLastSyncDateTime DateTimeOffset Gibt den Zeitpunkt an, zu dem die Gruppe zuletzt mit dem lokalen Verzeichnis synchronisiert wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.

Wird standardmäßig zurückgegeben. Schreibgeschützt. Unterstützt $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors onPremisesProvisioningError-Sammlung Fehler bei Verwendung eines Microsoft-Synchronisierungsprodukts während der Bereitstellung.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, not).
onPremisesSamAccountName String Enthält den lokalen SAM-Kontonamen, der aus dem lokalen Verzeichnis synchronisiert wird. Die Eigenschaft wird nur bei Kunden ausgefüllt, die ihr lokales Verzeichnis über Azure AD Connect mit Azure Active Directory synchronisieren.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith). Schreibgeschützt.
onPremisesSecurityIdentifier Zeichenfolge Enthält die lokale Sicherheits-ID (SID) für die Gruppe, die von der lokalen Bereitstellung in der Cloud synchronisiert wurde.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq auch für null-Werte). Schreibgeschützt.
onPremisesSyncEnabled Boolean true, wenn diese Gruppe aus einem lokalen Verzeichnis synchronisiert wird; false, wenn die Gruppe ursprünglich aus einem lokalen Verzeichnis synchronisiert wurde, aber nicht mehr synchronisiert wird; NULL, wenn dieses Objekt nie aus einem lokalen Verzeichnis synchronisiert wurde (Standard).

Wird standardmäßig zurückgegeben. Schreibgeschützt. Unterstützt $filter (eq, ne, not, in und eq für null-Werte).
preferredDataLocation String Der bevorzugte Datenspeicherort für die Microsoft 365-Gruppe. Standardmäßig erbt die Gruppe den bevorzugten Datenspeicherort des Gruppenerstellers. Um diese Eigenschaft festzulegen, muss dem aufrufenden Benutzer eine der folgenden Azure AD-Rollen zugewiesen sein:
  • Globaler Administrator
  • Benutzerkontoadministrator
  • Verzeichnisschreibberechtigter
  • Exchange-Administrator
  • SharePoint-Administrator

Weitere Informationen zu dieser Eigenschaft finden Sie unter OneDrive Online Multi-Geo.

Nullwerte zulassend. Wird standardmäßig zurückgegeben.
preferredLanguage Zeichenfolge Die bevorzugte Sprache für eine Microsoft 365-Gruppe. Sollte im ISO 639-1-Code angegeben werden, beispielsweise en-US.

Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte).
proxyAddresses Zeichenfolgenauflistung E-Mail-Adressen für die Gruppe, die in das gleiche Gruppenpostfach umgeleitet werden sollen. Zum Beispiel: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Der any-Operator ist für Filterausdrücke für mehrwertige Eigenschaften erforderlich.

Wird standardmäßig zurückgegeben. Schreibgeschützt. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, not, ge, le, startsWith, endsWithund zählen leere Auflistungen).
renewedDateTime DateTimeOffset Zeitstempel der letzten Verlängerung der Gruppe. Dies kann nicht direkt geändert werden und wird nur über die Aktion zum Verlängern des Diensts aktualisiert. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.

Standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, ge, le, in). Schreibgeschützt.
resourceBehaviorOptions String-Sammlung Gibt die Gruppenverhalten an, die für eine Microsoft 365-Gruppe während deren Erstellung festgelegt werden können. Dies kann nur bei der Erstellung (POST) festgelegt werden. Mögliche Werte sind: AllowOnlyMembersToPost, HideGroupInOutlook, SubscribeNewGroupMembers, WelcomeEmailDisabled. Weitere Informationen finden Sie unter Festlegen der Gruppenverhaltensweisen und Bereitstellungsoptionen für Microsoft 365.
resourceProvisioningOptions String-Sammlung Gibt die Gruppenressourcen an, die als Teil der Microsoft 365-Gruppenerstellung bereitgestellt werden, die normalerweise nicht Bestandteil der standardmäßigen Gruppenerstellung sind. Möglicher Wert: Team. Weitere Informationen finden Sie unter Festlegen der Gruppenverhaltensweisen und Bereitstellungsoptionen für Microsoft 365.
securityEnabled Boolean Gibt an, ob die Gruppe eine Sicherheitsgruppe ist. Erforderlich.

Identifiziert die der Gruppe zugeordneten Informationssegmente. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, not, in, ).
securityIdentifier Zeichenfolge Sicherheits-ID der Gruppe, verwendet in Windows-Szenarios.

Wird standardmäßig zurückgegeben.
theme Zeichenfolge Gibt das Farbdesign einer Microsoft 365-Gruppe an. Mögliche Werte sind Teal, Purple, Green, Blue, Pink, Orange oder Red.

Wird standardmäßig zurückgegeben.
unseenCount Int32 Die Anzahl von Unterhaltungen, die neue Beiträge erhalten haben, da der angemeldete Benutzer die Gruppe zuletzt besucht hat.

Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID})
visibility Zeichenfolge Legt die Gruppenbeitrittsrichtlinie und die Sichtbarkeit von Gruppeninhalten für Gruppen fest. Mögliche Werte: Private, Public oder HiddenMembership. HiddenMembership kann für Microsoft 365-Gruppen nur während der Erstellung der Gruppen festgelegt werden. Die Einstellung kann später nicht mehr aktualisiert werden. Andere Werte für die Sichtbarkeit können nach der Gruppenerstellung aktualisiert werden.
Wird bei der Erstellung der Gruppe in Microsoft Graph kein Sichtbarkeitswert angegeben, wird eine Sicherheitsgruppe standardmäßig als Private erstellt, und die Microsoft 365-Gruppe ist Public. Gruppen, die Rollen zugewiesen werden können, sind immer Private. Weitere Informationen finden Sie unter Sichtbarkeitsoptionen für Gruppen.

Wird standardmäßig zurückgegeben. Nullwerte zulassend.

Sichtbarkeitsoptionen für Gruppen

Wert Beschreibung
Öffentlich Jeder kann der Gruppe beitreten, ohne dass die Berechtigung „Besitzer“ erforderlich ist.
Jeder kann die Attribute der Gruppe anzeigen.
Jeder kann die Mitglieder der Gruppe sehen.
Privat Die Berechtigung „Besitzer“ ist erforderlich, um der Gruppe beizutreten.
Nichtmitglieder können die Attribute der Gruppe nicht anzeigen.
Jeder kann die Mitglieder der Gruppe sehen.
HiddenMembership Die Berechtigung „Besitzer“ ist erforderlich, um der Gruppe beizutreten.
Nichtmitglieder können die Attribute der Gruppe nicht anzeigen.
Nichtmitglieder können die Mitglieder der Gruppe nicht sehen.
Administratoren (global, Unternehmen, Benutzer und Helpdesk) können die Mitgliedschaft der Gruppe anzeigen.
Die Gruppe wird im globalen Adressbuch (GAL) angezeigt.

Beziehungen

Beziehung Typ Beschreibung
acceptedSenders directoryObject-Sammlung Die Liste der Benutzer oder Gruppen, die berechtigt sind, Beiträge oder Kalenderereignisse in dieser Gruppe zu erstellen. Wenn diese Liste nicht leer ist, dürfen nur die hier aufgeführten Benutzer oder Gruppen Beiträge schreiben.
appRoleAssignments appRoleAssignment-Auflistung Stellt die App-Rollen dar, die eine Gruppe für eine Anwendung gewährt bekommen hat. Unterstützt $expand.
Kalender Kalender Der Kalender der Gruppe. Schreibgeschützt.
calendarView Ereignissammlung Die Kalenderansicht für den Kalender. Schreibgeschützt.
conversations Unterhaltungssammlung Die Unterhaltungen der Gruppe
createdOnBehalfOf directoryObject Der Benutzer (bzw. die Anwendung), der/die Gruppe erstellt hat. HINWEIS: Dies ist nicht festgelegt, wenn der Benutzer ein Administrator ist. Schreibgeschützt.
Laufwerk drive Das Standardlaufwerk der Gruppe. Schreibgeschützt.
drives drive-Sammlung Die Laufwerke der Gruppe. Schreibgeschützt.
events Ereignissammlung Die Kalenderereignisse der Gruppe.
extensions extension-Sammlung Die Sammlung der für die Gruppe definierten offenen Erweiterungen. Schreibgeschützt. Nullwerte zulassend.
groupLifecyclePolicies groupLifecyclePolicy-Sammlung Die Sammlung der Lebenszyklusrichtlinien für diese Gruppe. Schreibgeschützt. Nullwerte zulässig.
memberOf directoryObject collection Gruppen, denen diese Gruppe angehört. HTTP-Methoden: GET (für alle Gruppen unterstützt). Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
members directoryObject collection Die Mitglieder dieser Gruppe, wobei es sich um Benutzer, Geräte, andere Gruppen oder Dienstprinzipale handeln kann. Unterstützt die Vorgänge Mitglieder auflisten, Mitglieder hinzufügen und Mitglieder entfernen. Lässt NULL-Werte zu.
Unterstützt $expand einschließlich verschachtelter $select. Beispiel: /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName).
membersWithLicenseErrors User-Sammlung Eine Liste von Gruppenmitgliedern mit Lizenzfehlern aus dieser gruppenbasierten Lizenzzuweisung. Schreibgeschützt.
onenote Onenote Schreibgeschützt.
owners directoryObject collection Die Besitzer der Gruppe. Limitiert auf 100 Besitzer. Nullwerte zulassend. Wenn diese Eigenschaft beim Erstellen einer Microsoft 365-Gruppe nicht angegeben wird, wird der anrufende Benutzer automatisch als Gruppenbesitzer zugewiesen.
Unterstützt $expand einschließlich verschachtelter $select. Beispiel: /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
permissionGrants resourceSpecificPermissionGrant Die Berechtigung, die einer Gruppe für eine bestimmte Anwendung erteilt wurde. Unterstützt $expand.
photo profilePhoto Das Profilfoto der Gruppe.
Fotos profilePhoto-Sammlung Die Profilfotos im Besitz der Gruppe. Schreibgeschützt. Lässt Nullwerte zu.
planner plannerGroup Einstiegspunkt der Planner-Ressource, die möglicherweise für eine einheitliche Gruppe vorhanden ist.
rejectedSenders directoryObject-Sammlung Die Liste der Benutzer oder Gruppen, die nicht berechtigt sind, Beiträge oder Kalenderereignisse in dieser Gruppe zu erstellen. Lässt NULL-Werte zu
Einstellungen groupSetting-Sammlung Einstellungen, die das Verhalten dieser Gruppe steuern können, z. B. ob Mitglieder Gastbenutzer zur Gruppe einladen können. Nullwerte zulassend.
sites site-Sammlung Die Liste der SharePoint-Websites in dieser Gruppe. Der Zugriff auf die Standardwebsite erfolgt mit „/sites/root“.
team channel-Sammlung Das dieser Gruppe zugeordnete Team.
threads conversationThread-Sammlung Die Unterhaltungs-Threads der Gruppe. Lässt NULL-Werte zu.
transitiveMemberOf directoryObject collection Die Gruppen, in denen eine Gruppe Mitglied ist, entweder direkt und über eine geschachtelte Mitgliedschaft. Nullwerte zulassend.
transitiveMembers directoryObject collection Die direkten und transitiven Mitglieder einer Gruppe. Nullwerte zulassend.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "allowExternalSenders": false,
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "autoSubscribeNewMembers": true,
  "classification": "String",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "groupTypes": ["String"],
  "hasMembersWithLicenseErrors": "Boolean",
  "hideFromAddressLists": false,
  "hideFromOutlookClients": false,
  "id": "String (identifier)",
  "isSubscribedByMail": true,
  "isAssignableRole": false,
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": true,
  "mailNickname": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": true,
  "securityIdentifier": "String",
  "unseenCount": 1024,
  "visibility": "String",
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }]
}

Siehe auch