Gruppen-Ressourcentyp

Stellt eine Azure Active Directory-Gruppe dar, bei der es sich um eine Office 365-Gruppe, eine dynamische Gruppe oder eine Sicherheitsgruppe handeln kann. Erbt von directoryObject.

Methoden

Methode Rückgabetyp Beschreibung
Gruppe erstellen Gruppe Erstellt eine neue Gruppe. Dabei kann es sich um eine Office 365-Gruppe, eine dynamische Gruppe oder eine Sicherheitsgruppe handeln.
Gruppe abrufen Gruppe Liest die Eigenschaften eines Gruppenobjekts.
Gruppen auflisten Gruppensammlung Listet Gruppenobjekte und deren Eigenschaften auf.
Gruppe aktualisieren Gruppe Aktualisiert die Eigenschaften eines Gruppenobjekts.
Gruppe löschen Keiner Löscht das Gruppenobjekt.
Mitglied hinzufügen Keiner Fügt dieser Gruppe einen Benutzer oder eine Gruppe durch Bereitstellung an die members-Navigationseigenschaft hinzu (wird nur für Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen unterstützt).
Mitglieder auflisten directoryObject-Sammlung Ruft die Benutzer und Gruppen, die direkte Mitglieder dieser Gruppe sind, aus der members-Navigationseigenschaft ab.
Mitglied entfernen Keine Entfernt ein Mitglied aus einer Office 365-Gruppe, einer Sicherheitsgruppe oder einer E-Mail-fähigen Sicherheitsgruppe anhand der members-Navigationseigenschaft. Sie können Benutzer oder andere Gruppen entfernen.
memberOf auflisten directoryObject-Sammlung Ruft die Gruppen, bei denen diese Gruppe direktes Mitglied ist, aus der memberOf-Navigationseigenschaft ab.
Besitzer hinzufügen Keiner Fügt einen neuen Besitzer zur Gruppe durch Bereitstellen an die owners-Navigationseigenschaft bereit (wird nur für Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen unterstützt).
Besitzer auflisten directoryObject-Sammlung Ruft die Eigentümer der Gruppe aus der owners-Navigationseigenschaft ab.
Besitzer entfernen Keiner Entfernt einen Besitzer aus einer Office 365-Gruppe, einer Sicherheitsgruppe oder einer E-Mail-fähigen Sicherheitsgruppe über die owners-Navigationseigenschaft.
checkMemberGroups String collection Prüft die Mitgliedschaft dieser Gruppe 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.
getMemberObjects String collection Gibt alle Gruppen zurück, bei denen die Gruppe Mitglied ist. Die Funktion ist transitiv.
Ereignis erstellen Event Erstellt ein neues Ereignis durch Veröffentlichen in der Ereignissammlung.
Ereignisse auflisten Ereignissammlung Ruft eine Ereignisobjektsammlung ab.
calendarView auflisten Ereignissammlung Ruft eine Auflistung der Ereignisse in einem angegebenen Zeitfenster ab.
Unterhaltung erstellen Unterhaltung Erstellt eine neue Unterhaltung durch Veröffentlichung in der Unterhaltungssammlung.
Unterhaltungen auflisten Unterhaltungssammlung Ruft eine Unterhaltungsobjektsammlung ab.
Threads auflisten conversationThread-Sammlung Ruft alle Threads einer Gruppe ab.
acceptedSenders auflisten directoryObject-Sammlung Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der acceptedSenders 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.
rejectedSender hinzufügen directoryObject Fügt einen neuen Benutzer oder eine neue Gruppe zur rejectedSender-Sammlung hinzu.
rejectedSenders auflisten directoryObject-Sammlung Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der rejectedSenders für diese Gruppe befinden.
rejectedSender entfernen directoryObject Entfernt einen neuen Benutzer oder eine neue Gruppe aus der rejectedSenders-Sammlung.
addFavorite Keine Fügt die Gruppe zu der Liste der Favoritengruppen des aktuellen Benutzers hinzu. Wird nur für Office 365-Gruppen unterstützt.
removeFavorite Keine Entfernt die Gruppe aus der Liste der Favoritengruppen des aktuellen Benutzers. Wird nur für Office 365-Gruppen unterstützt.
subscribeByMail Keine Legt die Eigenschaft „IsSubscribedByMail“ auf true fest. Aktiviert den aktuellen Benutzer für den Erhalt von E-Mail-Unterhaltungen. Wird nur für Office 365-Gruppen unterstützt.
unsubscribeByMail Keine Legt die Eigenschaft „isSubscribedByMail“ auf false fest. Deaktiviert den aktuellen Benutzer für den Erhalt von E-Mail-Unterhaltungen. Wird nur für Office 365-Gruppen unterstützt.
resetUnseenCount Keine Setzt das unseenCount-Element aller Beiträge, die der aktuelle Benutzer seit dem letzten Besuch noch nicht gesehen hat, auf 0 zurück. Wird nur für Office 365-Gruppen unterstützt.

Eigenschaften

Eigenschaft Typ Beschreibung
allowExternalSenders Boolescher Wert Der Standardwert ist false. Gibt an, ob Personen außerhalb der Organisation Nachrichten an die Gruppe senden können.
autoSubscribeNewMembers Boolean Der Standardwert ist false. Gibt an, ob neu zur Gruppe hinzugefügte Mitglieder automatisch E-Mail-Benachrichtigungen erhalten. 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, mit der die Gruppe erstellt wird.
description String Eine optionale Beschreibung für die Gruppe.
displayName String Der Anzeigename der Gruppe. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht deaktiviert werden. Unterstützt $Filter und $orderby.
groupTypes String collection Gibt den Typ der zu erstellenden Gruppe an. Mögliche Werte sind Unified zum Erstellen einer Office 365-Gruppe oder DynamicMembership für dynamische Gruppen. Legen Sie für alle anderen Gruppentypen wie Gruppen mit aktivierter Sicherheit und E-Mail-fähige Sicherheitsgruppen diese Eigenschaft nicht fest. Unterstützt $filter.
id String Eindeutiger Bezeichner für die Gruppe. Geerbt von directoryObject. Key. Lässt keine Nullwerte zu. Schreibgeschützt.
isSubscribedByMail Boolean Der Standardwert ist true. Gibt an, ob der aktuelle Benutzer den Erhalt von E-Mail-Unterhaltungen abonniert hat.
Mail String Die SMTP-Adresse für die Gruppe ein, z. B. „serviceadmins@contoso.onmicrosoft.com“. Schreibgeschützt. Unterstützt $filter.
mailEnabled Boolean Gibt an, ob es sich bei der Gruppe um eine E-Mail-fähige Gruppe handelt. Wenn die securityEnabled-Eigenschaft auch auf true festgelegt ist, handelt es sich bei der Gruppe um eine E-Mail-fähige Sicherheitsgruppe; andernfalls handelt es sich bei der Gruppe um eine Microsoft Exchange-Verteilergruppe.
mailNickname String Der E-Mail-Alias für die Gruppe. Diese Eigenschaft muss beim Erstellen einer Gruppe angegeben werden. Unterstützt $filter.
onPremisesLastSyncDateTime DateTimeOffset Gibt den Zeitpunkt der letzten Synchronisierung des Objekts mit dem lokalen Verzeichnis an. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Schreibgeschützt. Unterstützt $filter.
onPremisesSecurityIdentifier String Enthält die lokale Sicherheits-ID (SID) für die Gruppe, die von der lokalen Bereitstellung in der Cloud synchronisiert wurde. 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). Schreibgeschützt. Unterstützt $filter.
proxyAddresses String collection Der any-Operator ist für Filterausdrücke für mehrwertige Eigenschaften erforderlich. Schreibgeschützt. Lässt keine NULL-Werte zu. Unterstützt $filter.
securityEnabled Boolean Gibt an, ob es sich bei der Gruppe um eine Sicherheitsgruppe handelt. Wenn die mailEnabled-Eigenschaft auch auf „true“ festgelegt ist, handelt es sich bei der Gruppe um eine E-Mail-fähige Sicherheitsgruppe; andernfalls ist die Gruppe eine Sicherheitsgruppe. Muss für Office 365-Gruppen auf false festgelegt sein. Unterstützt $filter.
unseenCount Int32 Anzahl der Beiträge, die der aktuelle Benutzer seit seinem letzten Besuch nicht gesehen hat.
visibility String Gibt die Sichtbarkeit einer Office 365-Gruppe an. Die folgenden Werte sind möglich: Private, Public oder leer (als öffentlich interpretiert).

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.
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 Laufwerk Das Laufwerk der Gruppe. Schreibgeschützt.
events Ereignissammlung Die Kalenderereignisse der Gruppe.
memberOf directoryObject-Sammlung Gruppen, bei denen diese Gruppe Mitglied ist. HTTP-Methoden: GET (unterstützt für alle Gruppen). Schreibgeschützt. Lässt NULL-Werte zu.
Elemente directoryObject-Sammlung Benutzer und Gruppen, die Mitglieder dieser Gruppe sind. HTTP-Methoden: GET (unterstützt für alle Gruppen), POST (unterstützt für Office 365-Gruppen, Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen), DELETE (unterstützt für Office 365-Gruppen und Sicherheitsgruppen), lässt NULL-Werte zu.
owners directoryObject-Sammlung Die Besitzer der Gruppe. Bei den Besitzern handelt es sich um eine Reihe von Benutzern, die keine Administratoren sind und die berechtigt sind, dieses Objekt zu ändern. Beschränkt auf 10 Besitzer. HTTP-Methoden: GET (unterstützt für alle Gruppen), POST (unterstützt für Office 365-Gruppen, Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen), DELETE (unterstützt für Office 365-Gruppen und Sicherheitsgruppen). Lässt NULL-Werte zu.
Foto profilePhoto Das Profilfoto der Gruppe.
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
Threads conversationThread-Sammlung Die Unterhaltungs-Threads der Gruppe. Lässt NULL-Werte zu.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "allowExternalSenders": false,
  "autoSubscribeNewMembers": true,
  "description": "string",
  "displayName": "string",
  "groupTypes": ["string"],
  "id": "string (identifier)",
  "isSubscribedByMail": true,
  "mail": "string",
  "mailEnabled": true,
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "proxyAddresses": ["string"],
  "securityEnabled": true,
  "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" } ],
  "owners": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "rejectedSenders": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "threads": [ { "@odata.type": "microsoft.graph.conversationThread" }]
}