Gruppe erstellenCreate group

Erstellen Sie eine neue Gruppe gemäß der Angabe im Anforderungstext.Create a new channel in a Microsoft Team, as specified in the request body. Sie können die folgenden Arten von Gruppen erstellen:You can use the New-DistributionGroup cmdlet to create the following types of groups:

  • Office 365-Gruppe (einheitliche Gruppe)Office 365 Group (unified group)
  • SicherheitsgruppeSecurity group

Dieser Vorgang gibt standardmäßig nur eine Teilmenge der Eigenschaften für jede Gruppe zurück.This operation returns by default only a subset of the properties for each group. Diese Standardeigenschaften werden im Abschnitt Eigenschaften aufgeführt.These default properties are noted in the Properties section.

Um Eigenschaften abzurufen, die nicht standardmäßig zurückgegeben werden, führen Sie eine GET-Operation aus, und geben Sie die Eigenschaften in einer OData-Abfrageoption $select an.To get properties that are not returned by default, do a GET operation and specify the properties in a $select OData query option. Sehen Sie sich das Beispiel an.See an example.

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.Note: Although Microsoft Teams is built on Office 365 Groups, you can't currently create a team via this API. You can use the other group APIs to manage a team that has been created in the Microsoft Teams UI.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Group.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllGroup.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All

HTTP-AnforderungHTTP request

POST /groups

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Die folgende Tabelle enthält die Eigenschaften der group-Ressource, die Sie beim Erstellen einer Gruppe angeben müssen.The following table shows the properties of the group resource to specify when you create a group.

EigenschaftProperty TypType BeschreibungDescription
displayNamedisplayName stringstring Der Name der Gruppe, der im Adressbuch angezeigt wird.The name to display in the address book for the group. Erforderlich.Required.
mailEnabledmailEnabled booleanboolean true für E-Mail-aktivierte Gruppen.Set to true for mail-enabled groups. Erforderlich.Required.
mailNicknamemailNickname stringstring Der E-Mail-Alias für die Gruppe.The mail alias for the group. Erforderlich.Required.
securityEnabledsecurityEnabled Boolescher Wertboolean True für Gruppen mit aktivierter Sicherheit, beispielsweise Office 365-Gruppen.Set to true for security-enabled groups, including Office 365 groups. Erforderlich.Required.
ownersowners Zeichenfolgenauflistungstring collection Diese Eigenschaft stellt die Besitzer für die Gruppe zum Zeitpunkt der Erstellung dar.This property represents the owners for the group at creation time. Optional.Optional.
membersmembers Zeichenfolgenauflistungstring collection Diese Eigenschaft stellt die Mitglieder der Gruppe zum Zeitpunkt der Erstellung dar.This property represents the members for the group at creation time. Optional.Optional.

Hinweis: Bei Gruppen, die mit dem Microsoft Azure-Portal erstellt wurden, ist securityEnabled anfänglich immer auf true festgelegt.Note: Groups created using the Microsoft Azure portal always have securityEnabled initially set to true.

Geben Sie bei Bedarf andere beschreibbare Eigenschaften für Ihre Gruppe an.Specify other writable properties as necessary for your group. Weitere Informationen finden Sie in Themen zu Eigenschaften der group-Ressource.For more information, see the properties of the group resource.

Hinweis: Beim programmgesteuerten Erstellen einer Office 365-Gruppe ohne Benutzerkontext und ohne Angabe von Besitzern wird die Gruppe anonym erstellt.Note: Creating an Office 365 Group programmatically without a user context and without specifying owners will create the group anonymously. Dies kann dazu führen, dass die zugehörige SharePoint Online-Website nicht automatisch erstellt wird und weitere manuelle Aktionen nötig sind.Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.

groupTypes-OptionengroupTypes options

Verwenden Sie die Eigenschaft groupTypes zum Steuern des Typs der Gruppe und ihrer Mitgliedschaft, wie unten dargestellt:Use the groupTypes property to control the type of group and its membership, as shown below:

Typ der GruppeType of group Zugeordnete MitgliedschaftAssigned membership Dynamische MitgliedschaftDynamic membership
Office 365 (auch einheitliche Gruppe genannt)Office 365 (aka unified group) ["Unified"] ["Unified","DynamicMembership"]
DynamischDynamic [] (null)Null ["DynamicMembership"]

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201 Created und das group-Objekt im Antworttext zurückgegeben.If successful, this method returns 201 Created response code and group object in the response body. Die Antwort enthält nur die Standardeigenschaften der Gruppe.The response includes only the default properties of the group.

BeispieleExamples

Beispiel 1: Erstellen einer Office 365-GruppeCreate an Office 365 group

Im folgenden Beispiel wird eine Office 365-Gruppe erstellt.The following example creates an Office 365 group.

AnforderungRequest

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
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

Hinweis:  Das hier gezeigte Antwortobjekt ist möglicherweise zur besseren Lesbarkeit gekürzt worden.Note: The response object shown here might be shortened for readability. Von einem tatsächlichen Aufruf werden alle Standardeigenschaften zurückgegeben.All the default properties are returned from an actual call.

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

{
    "id": "b320ee12-b1cd-4cca-b648-a437be61c5cd",
      "deletedDateTime": null,
      "classification": null,
      "createdDateTime": "2018-12-22T00:51:37Z",
      "creationOptions": [],
      "description": "Self help community for library",
      "displayName": "Library Assist",
      "groupTypes": [
          "Unified"
      ],
      "mail": "library7423@contoso.com",
      "mailEnabled": true,
      "mailNickname": "library",
      "onPremisesLastSyncDateTime": null,
      "onPremisesSecurityIdentifier": null,
      "onPremisesSyncEnabled": null,
      "preferredDataLocation": "CAN",
      "proxyAddresses": [
          "SMTP:library7423@contoso.com"
      ],
      "renewedDateTime": "2018-12-22T00:51:37Z",
      "resourceBehaviorOptions": [],
      "resourceProvisioningOptions": [],
      "securityEnabled": false,
      "visibility": "Public",
      "onPremisesProvisioningErrors": []
}

SDK-BeispielcodeSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var group = new Group
{
    Description = "Self help community for library",
    DisplayName = "Library Assist",
    GroupTypes = new List<String>()
    {
        "Unified"
    },
    MailEnabled = true,
    MailNickname = "library",
    SecurityEnabled = false
};

await graphClient.Groups
    .Request()
    .AddAsync(group);

In der SDK-Dokumentation finden Sie Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider -Instanz.Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Beispiel 2: Erstellen einer Gruppe mit Besitzern und MitgliedernExample 2: Create a group with owners and members

Im folgenden Beispiel wird eine Office 365-Gruppe mit einem angegebenen Besitzer und Mitgliedern erstellt.The second example request creates an Office 365 group with an owner and members specified.

AnforderungRequest

POST https://graph.microsoft.com/v1.0/groups
Content-Type: application/json

{
  "description": "Group with designated owner and members",
  "displayName": "Operations group",
  "groupTypes": [
    "Unified"
  ],
  "mailEnabled": true,
  "mailNickname": "operations2019",
  "securityEnabled": false,
  "owners@odata.bind": [
    "https://graph.microsoft.com/v1.0/users/26be1845-4119-4801-a799-aea79d09f1a2"
  ],
  "members@odata.bind": [
    "https://graph.microsoft.com/v1.0/users/ff7cb387-6688-423c-8188-3da9532a73cc",
    "https://graph.microsoft.com/v1.0/users/69456242-0067-49d3-ba96-9de6f2728e14"
  ]
}

AntwortResponse

Es folgt ein Beispiel für eine erfolgreiche Antwort.The following is an example of a successful response. Es enthält nur Standardeigenschaften.It includes only default properties. Sie können anschließend die owners- oder members-Navigationseigenschaft der Gruppe abrufen, um den Besitzer oder die Mitglieder zu überprüfen.You can subsequently get the owners or members navigation properties of the group to verify the owner or members.

Hinweis:  Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.Note: The response object shown here might be shortened for readability. Von einem tatsächlichen Aufruf werden alle Standardeigenschaften zurückgegeben.All the default properties are returned from an actual call.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
    "id": "502df398-d59c-469d-944f-34a50e60db3f",
    "deletedDateTime": null,
    "classification": null,
    "createdDateTime": "2018-12-27T22:17:07Z",
    "creationOptions": [],
    "description": "Group with designated owner and members",
    "displayName": "Operations group",
    "groupTypes": [
        "Unified"
    ],
    "mail": "operations2019@contoso.com",
    "mailEnabled": true,
    "mailNickname": "operations2019",
    "onPremisesLastSyncDateTime": null,
    "onPremisesSecurityIdentifier": null,
    "onPremisesSyncEnabled": null,
    "preferredDataLocation": "CAN",
    "proxyAddresses": [
        "SMTP:operations2019@contoso.com"
    ],
    "renewedDateTime": "2018-12-27T22:17:07Z",
    "resourceBehaviorOptions": [],
    "resourceProvisioningOptions": [],
    "securityEnabled": false,
    "visibility": "Public",
    "onPremisesProvisioningErrors": []
}

SDK-BeispielcodeSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var group = new Group
{
    Description = "Group with designated owner and members",
    DisplayName = "Operations group",
    GroupTypes = new List<String>()
    {
        "Unified"
    },
    MailEnabled = true,
    MailNickname = "operations2019",
    SecurityEnabled = false
};

await graphClient.Groups
    .Request()
    .AddAsync(group);

In der SDK-Dokumentation finden Sie Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider -Instanz.Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.