Créer un groupeCreate group

Créez un groupe comme spécifié dans le corps de la demande.Use this API to create a new group as specified in the request body. Vous pouvez créer les types de groupes suivants :You can use the New-DistributionGroup cmdlet to create the following types of groups:

  • Groupe Office 365 (groupe unifié)Office 365 Group (unified group)
  • Groupe de sécuritéSecurity group

Cette opération renvoie par défaut uniquement un sous-ensemble de propriétés pour chaque groupe.This operation returns by default only a subset of the properties for each group. Ces propriétés par défaut sont indiquées dans la section Propriétés.These default properties are noted in the Properties section.

Pour obtenir des propriétés qui ne sont pas renvoyées par défaut, effectuez une opération GET et spécifiez les propriétés dans une option de requête OData $select.To get properties that are not returned by default, do a GET operation and specify the properties in a $select OData query option.

Remarque : même si Microsoft Teams dépend des Groupes Office 365, vous ne pouvez pas créer actuellement d’équipe via cette API. Vous pouvez utiliser les API de l’autre groupe pour gérer une équipe qui a été créée dans l’interface utilisateur de Microsoft Teams.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.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Group.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllGroup.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All

Requête HTTPHTTP request

POST /groups

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

Le tableau suivant indique les propriétés de la ressource groupe à spécifier lorsque vous créez un groupe.The following table shows the properties of the group resource to specify when you create a group.

PropriétéProperty TypeType DescriptionDescription
displayNamedisplayName chaînestring Nom à afficher dans le carnet d’adresses pour le groupe.The name to display in the address book for the group. Obligatoire.Required.
mailEnabledmailEnabled booléenboolean Défini sur true pour les groupes à extension messagerie.Set to true for mail-enabled groups. Obligatoire.Required.
mailNicknamemailNickname chaînestring Alias de messagerie pour le groupe.The mail alias for the group. Obligatoire.Required.
securityEnabledsecurityEnabled booléenboolean Définissez true pour les groupes prenant en charge la sécurité, y compris les groupes Office 365.Set to true for security-enabled groups, including Office 365 groups. Obligatoire.Required.
Propriétairesowners collection de chaînesstring collection Cette propriété représente les propriétaires du groupe au moment de la création.This property represents the owners for the group at creation time. Facultatif.Optional.
membresmembers collection de chaînesstring collection Cette propriété représente les membres du groupe au moment de la création.This property represents the members for the group at creation time. Facultatif.Optional.

Remarque : la propriété securityEnabled est toujours définie initialement sur true pour les groupes créés à l’aide du Portail Microsoft Azure.Note: Groups created using the Microsoft Azure portal always have securityEnabled initially set to true.

Spécifiez d’autres propriétés accessible en écriture selon les besoins de votre groupe.Specify other writable properties as necessary for your group. Pour plus d’informations, voir les propriétés de la ressource group.For more information, see the properties of the group resource.

Remarque :  la création d’un groupe Office 365 par programmation sans contexte utilisateur et sans spécifier de propriétaires va créer le groupe de manière anonyme.Note: Creating an Office 365 Group programmatically without a user context and without specifying owners will create the group anonymously. Cette opération peut entraîner une création non automatique du site SharePoint Online associé et une obligation d’action manuelle.Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.

Options de groupTypesgroupTypes options

Utilisez la propriété groupTypes pour contrôler le type de groupe et ses membres, comme illustré ci-dessous :Use the groupTypes property to control the type of group and its membership, as shown below:

Type de groupeType of group Appartenance attribuéeAssigned membership Appartenance dynamiqueDynamic membership
Office 365 (groupe unifié)Office 365 (aka unified group) ["Unified"] ["Unified","DynamicMembership"]
DynamiqueDynamic [] (null)Null ["DynamicMembership"]

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 201 Created et un objet group dans le corps de la réponse.If successful, this method returns 201 Created response code and group object in the response body. La réponse inclut uniquement les propriétés par défaut du groupe.The response includes only the default properties of the group.

ExemplesExamples

Exemple 1 : créer un groupe Office 365Create an Office 365 group

L’exemple suivant crée un groupe Office 365.The following example creates an Office 365 group.

DemandeRequest

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
}

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque :  l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.Note: The response object shown here might be shortened for readability. Toutes les propriétés par défaut sont renvoyées à partir d’un appel réel.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": []
}

Exemple 2 : créer un groupe avec des propriétaires et des membresExample 2: Create a group with owners and members

L’exemple suivant crée un groupe Office 365 avec un propriétaire et des membres spécifiés.The second example request creates an Office 365 group with an owner and members specified.

DemandeRequest

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"
  ]
}

RéponseResponse

Voici un exemple de réponse réussie.The following is an example of a successful response. Il inclut uniquement les propriétés par défaut.It includes only default properties. Vous pouvez ensuite obtenir les propriétés de navigation propriétaires ou membres du groupe pour vérifier les détails du propriétaire ou des membres.You can subsequently get the owners or members navigation properties of the group to verify the owner or members.

Remarque :  l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.Note: The response object shown here might be shortened for readability. Toutes les propriétés par défaut sont renvoyées à partir d’un appel réel.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": []
}