Gruppe erstellen

Verwenden Sie diese API zum Erstellen einer neuen Gruppe gemäß der Angabe im Anforderungstext. Sie können drei Typen von Gruppen erstellen:

  • Office 365-Gruppe (einheitliche Gruppe)
  • Dynamische Gruppe
  • Sicherheitsgruppe

Hinweis: Microsoft Teams basiert zwar auf Office 365-Gruppen, über diese API kann derzeit aber kein Team erstellt werden. Sie können die anderen Gruppen-APIs verwenden, um ein Team zu verwalten, das in der Microsoft Teams-Benutzeroberfläche erstellt wurde.

Voraussetzungen

Der folgende Bereich ist erforderlich, um diese API auszuführen: Group.ReadWrite.All

HTTP-Anforderung

POST /groups

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer . Required.

Anforderungstext

Die folgende Tabelle zeigt die Eigenschaften der Gruppe Ressource, die Sie zumindest angeben müssen, wenn Sie eine Gruppe erstellen.

Eigenschaft Typ Beschreibung
displayName string Der Name der Gruppe, der im Adressbuch angezeigt wird.
mailEnabled Boolescher Wert true für E-Mail-aktivierte Gruppen. true, wenn eine Office 365-Gruppe erstellt wird. false, wenn dynamische oder Sicherheitsgruppe erstellt wird.
mailNickname string Der E-Mail-Alias für die Gruppe.
securityEnabled Boolescher Wert true für Gruppen mit aktivierter Sicherheit. true, wenn dynamische oder eine Sicherheitsgruppe erstellt wird. false, wenn eine Office 365-Gruppe erstellt wird.

Geben Sie die groupTypes Eigenschaft an, wenn Sie eine Office 365 oder eine dynamische Gruppe erstellen, wie unten beschrieben.

Art der Gruppe groupTypes-Eigenschaft
Office 365 (auch einheitliche Gruppe genannt) „Unified“
Dynamisch "DynamicMembership"
Sicherheit Nicht festlegen.

Geben Sie bei Bedarf andere beschreibbare Eigenschaften für Ihre Gruppe an. Weitere Informationen finden Sie in Themen zu Eigenschaften der group-Ressource.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201, Created und das group-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Hier ist ein Beispiel für eine Anforderung, die eine Office 365-Gruppe erstellt.

POST https://graph.microsoft.com/v1.0/groups
Content-type: application/json
Content-length: 244

{
  "description": "Self help community for library",
  "displayName": "Library Assist",
  "groupTypes": [
    "Unified"
  ],
  "mailEnabled": true,
  "mailNickname": "library",
  "securityEnabled": false
}
Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden mehr Eigenschaften zurückgegeben.

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 244

{
  "description": "Self help community for library",
  "displayName": "Library Assist",
  "groupTypes": [
    "Unified"
  ],
  "mail": "library@contoso.onmicrosoft.com",
  "mailEnabled": true,
  "mailNickname": "library",
  "securityEnabled": false
}