Gérer les groupes dans Microsoft Graph

Les groupes dans Microsoft Graph sont des conteneurs pour les principaux tels que les utilisateurs, les appareils ou les applications qui partagent l’accès aux ressources. Ils facilitent la gestion des accès en regroupant les principaux au lieu de les gérer individuellement.

Le type de ressource de groupe dans Microsoft Graph fournit des API pour créer et gérer les types de groupes pris en charge et leurs fonctionnalités.

Remarque

Vous ne pouvez créer des groupes qu’à l’aide de comptes professionnels ou scolaires. Les comptes Microsoft personnels ne prennent pas en charge les groupes.
Toutes les opérations liées au groupe dans Microsoft Graph nécessitent un consentement administrateur.

Types de groupes pris en charge dans Microsoft Graph

Microsoft Graph prend en charge ces types de groupes :

Groupes Microsoft 365
Groupes de sécurité
Groupes de sécurité à extension messagerie
Groupes de distribution

Remarque

Les groupes de distribution dynamique ne sont pas pris en charge dans Microsoft Graph.

Le tableau suivant montre comment identifier les types de groupes à l’aide de leurs propriétés et s’ils peuvent être gérés via l’API de groupes Microsoft Graph. Les principaux facteurs de différenciation sont les valeurs des propriétés groupTypes, mailEnabled et securityEnabled d’un groupe.

Type	groupTypes	mailEnabled	securityEnabled	Géré via Microsoft Graph
Groupes Microsoft 365	`["Unified"]`	`true`	`true` ou `false`	Oui
Groupes de sécurité	`[]`	`false`	`true`	Oui
Groupes de sécurité à extension messagerie	`[]`	`true`	`true`	Non (lecture seule)
Groupes de distribution	`[]`	`true`	`false`	Non (lecture seule)

Pour plus d’informations, consultez Comparer les groupes dans Microsoft Entra ID.

Groupes Microsoft 365

Les Groupes Microsoft 365 sont conçus pour la collaboration et donnent accès à des ressources partagées telles que :

Conversations et calendrier Outlook.
les fichiers SharePoint et le site d’équipe.
Bloc-notes OneNote.
Plans du Planificateur.
Gestion des périphériques Intune.

Voici un exemple de groupe Microsoft 365 au format JSON :

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
    "id": "4c5ee71b-e6a5-4343-9e2c-4244bc7e0938",
    "displayName": "OutlookGroup101",
    "groupTypes": ["Unified"],
    "mailEnabled": true,
    "securityEnabled": false,
    "mail": "outlookgroup101@service.microsoft.com",
    "visibility": "Public"
}

Pour en savoir plus sur les Groupes Microsoft 365, voir Vue d’ensemble des Groupes Microsoft 365 dans Microsoft Graph.

Groupes de sécurité et groupes de sécurité à extension messagerie

Les groupes de sécurité contrôlent l’accès aux ressources. Elles peuvent inclure des utilisateurs, d’autres groupes, des appareils et des principaux de service.

Les groupes de sécurité à extension messagerie fonctionnent comme les groupes de sécurité, mais autorisent également la communication par e-mail. Ces groupes sont en lecture seule dans Microsoft Graph. Pour plus d'informations, voir Gérer les groupes de sécurité à extension de messagerie.

Exemple de groupe de sécurité au format JSON :

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

{
    "@odata.type": "#microsoft.graph.group",
    "id": "f87faa71-57a8-4c14-91f0-517f54645106",
    "displayName": "SecurityGroup101",
    "groupTypes": [],
    "mailEnabled": false,
    "securityEnabled": true
}

Appartenance à un groupe

Les groupes peuvent avoir un ou plusieurs propriétaires qui gèrent le groupe. Les propriétaires peuvent être des utilisateurs ou des principaux de service. Nous vous recommandons d’affecter au moins deux propriétaires à un groupe pour assurer la continuité.

Stratégie de groupe sans propriétaire

Lorsqu’un groupe perd son seul propriétaire, il devient sans propriétaire et ne peut plus être géré efficacement. Utilisez la ressource ownerlessGroupPolicy pour configurer une stratégie au niveau du locataire qui envoie automatiquement des e-mails de notification actionnables aux membres actifs de groupes sans propriétaire, les invitant à accepter la propriété. Les administrateurs peuvent configurer la durée de la notification, le nombre maximal de membres à notifier et contrôler l’éligibilité de la propriété à l’aide de groupes de sécurité. Pour plus d’informations, consultez Obtenir ownerlessGroupPolicy et Créer ou mettre à jour ownerlessGroupPolicy.

Appartenance aux groupes

Les groupes peuvent avoir des appartenances statiques ou dynamiques. L’appartenance dynamique utilise des règles pour ajouter ou supprimer automatiquement des membres en fonction de leurs propriétés. Tous les types d’objets ne peuvent pas être membres de Microsoft 365 et de groupes de sécurité.

Le tableau suivant présente les types de membres qui peuvent être ajoutés à des groupes de sécurité ou à des groupes Microsoft 365.

Type d’objet	Membre du groupe de sécurité	Membre du groupe Microsoft 365
Utilisateur
Groupe de sécurité
Groupe Microsoft 365
Appareil
Principal de service
Contact de l’organisation

Appartenance dynamique

L’appartenance dynamique signifie que des principaux sont ajoutés ou supprimés du groupe en fonction de leurs propriétés. Par exemple, un groupe peut être configuré pour inclure tous les utilisateurs du département « Marketing ». Lorsqu’un utilisateur est ajouté à ce service, il est automatiquement ajouté au groupe. De même, si un utilisateur quitte le service, il est supprimé du groupe.

Seuls les utilisateurs et les appareils peuvent être membres d’un groupe dynamique. L’adhésion dynamique nécessite une licence Microsoft Entra ID P1 pour chaque utilisateur unique d’un groupe dynamique.

La règle d’appartenance est définie à l’aide de la syntaxe de règle de groupe dynamique de Microsoft Entra ID.

Exemple de règle d’appartenance dynamique :

"membershipRule": "user.department -eq \"Marketing\""

L’appartenance dynamique nécessite la "DynamicMembership" valeur de la propriété groupTypes . La règle d’appartenance dynamique peut être activée ou désactivée via la propriété membershipRuleProcessingState. Vous pouvez mettre à jour un groupe en passant d’une appartenance statique à une appartenance dynamique.

Exemple de demande de création d’un groupe Microsoft 365 dynamique :

POST https://graph.microsoft.com/beta/groups
Content-type: application/json

{
    "description": "Marketing department folks",
    "displayName": "Marketing department",
    "groupTypes": [
        "Unified",
        "DynamicMembership"
    ],
    "mailEnabled": true,
    "mailNickname": "marketing",
    "securityEnabled": false,
    "membershipRule": "user.department -eq \"Marketing\"",
    "membershipRuleProcessingState": "on"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new Group
{
	Description = "Marketing department folks",
	DisplayName = "Marketing department",
	GroupTypes = new List<string>
	{
		"Unified",
		"DynamicMembership",
	},
	MailEnabled = true,
	MailNickname = "marketing",
	SecurityEnabled = false,
	MembershipRule = "user.department -eq \"Marketing\"",
	MembershipRuleProcessingState = "on",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Groups.PostAsync(requestBody);

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewGroup()
description := "Marketing department folks"
requestBody.SetDescription(&description) 
displayName := "Marketing department"
requestBody.SetDisplayName(&displayName) 
groupTypes := []string {
	"Unified",
	"DynamicMembership",
}
requestBody.SetGroupTypes(groupTypes)
mailEnabled := true
requestBody.SetMailEnabled(&mailEnabled) 
mailNickname := "marketing"
requestBody.SetMailNickname(&mailNickname) 
securityEnabled := false
requestBody.SetSecurityEnabled(&securityEnabled) 
membershipRule := "user.department -eq \"Marketing\""
requestBody.SetMembershipRule(&membershipRule) 
membershipRuleProcessingState := "on"
requestBody.SetMembershipRuleProcessingState(&membershipRuleProcessingState) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
groups, err := graphClient.Groups().Post(context.Background(), requestBody, nil)

Importante


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Group group = new Group();
group.setDescription("Marketing department folks");
group.setDisplayName("Marketing department");
LinkedList<String> groupTypes = new LinkedList<String>();
groupTypes.add("Unified");
groupTypes.add("DynamicMembership");
group.setGroupTypes(groupTypes);
group.setMailEnabled(true);
group.setMailNickname("marketing");
group.setSecurityEnabled(false);
group.setMembershipRule("user.department -eq \"Marketing\"");
group.setMembershipRuleProcessingState("on");
Group result = graphClient.groups().post(group);

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

const group = {
    description: 'Marketing department folks',
    displayName: 'Marketing department',
    groupTypes: [
        'Unified',
        'DynamicMembership'
    ],
    mailEnabled: true,
    mailNickname: 'marketing',
    securityEnabled: false,
    membershipRule: 'user.department -eq \"Marketing\"',
    membershipRuleProcessingState: 'on'
};

await client.api('/groups')
	.version('beta')
	.post(group);

Importante


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Group;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Group();
$requestBody->setDescription('Marketing department folks');
$requestBody->setDisplayName('Marketing department');
$requestBody->setGroupTypes(['Unified', 'DynamicMembership', 	]);
$requestBody->setMailEnabled(true);
$requestBody->setMailNickname('marketing');
$requestBody->setSecurityEnabled(false);
$requestBody->setMembershipRule('user.department -eq \"Marketing\"');
$requestBody->setMembershipRuleProcessingState('on');

$result = $graphServiceClient->groups()->post($requestBody)->wait();

Importante


Import-Module Microsoft.Graph.Beta.Groups

$params = @{
	description = "Marketing department folks"
	displayName = "Marketing department"
	groupTypes = @(
	"Unified"
"DynamicMembership"
)
mailEnabled = $true
mailNickname = "marketing"
securityEnabled = $false
membershipRule = "user.department -eq "Marketing""
membershipRuleProcessingState = "on"
}

New-MgBetaGroup -BodyParameter $params

Importante


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.group import Group
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Group(
	description = "Marketing department folks",
	display_name = "Marketing department",
	group_types = [
		"Unified",
		"DynamicMembership",
	],
	mail_enabled = True,
	mail_nickname = "marketing",
	security_enabled = False,
	membership_rule = "user.department -eq \"Marketing\"",
	membership_rule_processing_state = "on",
)

result = await graph_client.groups.post(request_body)

Importante

La demande renvoie un 201 Created code de réponse et le nouvel objet de groupe créé dans le corps de la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
    "id": "6f7cd676-5445-47c4-9c2b-c47da4671da2",
    "createdDateTime": "2023-01-20T07:00:31Z",
    "description": "Marketing department folks",
    "displayName": "Marketing department",
    "groupTypes": [
        "Unified",
        "DynamicMembership"
    ],
    "mail": "marketing@contoso.com",
    "mailEnabled": true,
    "mailNickname": "marketing",
    "membershipRule": "user.department -eq \"Marketing\"",
    "membershipRuleProcessingState": "On"
}

Autres paramètres de groupe

Vous pouvez configurer d’autres paramètres pour les groupes, par exemple :

Setting	Description	S’applique à
Expiration du groupe	Configurez une stratégie d’expiration afin que les groupes Microsoft 365 soient automatiquement supprimés après une période spécifiée, sauf si vous les renouvelez.	Groupes Microsoft 365
Paramètres de groupe	Configurez les comportements des groupes à l’aide des modèles de réglage. Les modèles de configuration incluent : Group.Unified pour Microsoft 365 paramètres de groupe (tels que les stratégies de nommage, l’accès invité et les étiquettes de confidentialité), Group.Unified.Guest pour les paramètres invités Microsoft 365, Group.Security pour les paramètres de groupe de sécurité cloud (tels que l’activation des étiquettes de confidentialité) et Group.Security.Policies pour les paramètres de sécurité cloud.	Groupes Microsoft 365 et groupes de sécurité cloud
Paramètres de synchronisation locale	Configurez les paramètres de synchronisation d’annuaires locaux.	Sécurité et groupes Microsoft 365
Source de conversion d’autorité	Convertir la source d’autorité pour un groupe.	Sécurité et groupes Microsoft 365

Limitations de la recherche de groupe pour les invités dans les organisations

Les applications peuvent rechercher des groupes dans l’annuaire d’une organisation en interrogeant la /groups ressource (par exemple, https://graph.microsoft.com/beta/groups). Cette fonctionnalité est disponible pour les administrateurs et les membres, mais pas pour les invités.

Les invités, en fonction des autorisations accordées à l’application, peuvent afficher le profil d’un groupe spécifique (par exemple). https://graph.microsoft.com/beta/group/fc06287e-d082-4aab-9d5e-d6fd0ed7c8bc Toutefois, ils ne peuvent pas effectuer de requêtes sur la /groups ressource qui renvoient plusieurs résultats.

Les membres ont généralement un accès plus large aux ressources du groupe, tandis que les invités ont des autorisations restreintes, limitant leur accès à certaines fonctionnalités du groupe. Pour plus d’informations, consultez Comparer les autorisations par défaut des membres et des invités.

Avec les autorisations appropriées, les applications peuvent accéder aux profils de groupe via des propriétés de navigation, telles que /groups/{id}/members.

Gestion des licences en fonction des groupes

La licence basée sur des groupes vous permet d’attribuer une ou plusieurs licences de produit à un groupe Microsoft Entra. Les membres du groupe, y compris les nouveaux membres, héritent automatiquement de ces licences. Lorsque les membres quittent le groupe, leurs licences sont automatiquement supprimées. Cette fonctionnalité est uniquement disponible pour les groupes de sécurité et les Groupes Microsoft 365 avec securityEnabled défini sur true.

Pour plus d’informations, consultez Qu’est-ce que la licence basée sur un groupe dans Microsoft Entra ID ?.

Propriétés stockées en dehors du magasin de données principal

La plupart des données de ressource de groupe sont stockées dans Microsoft Entra ID, mais certaines propriétés, telles que autoSubscribeNewMembers et allowExternalSenders, sont stockées dans Microsoft Exchange. Ces propriétés ne peuvent pas être incluses dans le même corps de demande de création ou de mise à jour que les autres propriétés de groupe.

En outre, les propriétés stockées en dehors du magasin de données principal ne sont pas prises en charge pour le suivi des modifications. Les modifications apportées à ces propriétés n’apparaissent pas dans les réponses à la requête delta.

Les propriétés de groupe suivantes sont stockées en dehors du magasin de données principal :
accessType, allowExternalSenders, autoSubscribeNewMembers, cloudLicensing, hideFromAddressLists, hideFromOutlookClients, isArchived, isFavorite, isSubscribedByMail, membershipRuleProcessingStatus, unseenConversationsCount, unseenCount, unseenMessagesCount, welcomeMessageEnabled.

Cas d’utilisation courants de l’API de groupe

L’API de groupes Microsoft Graph prend en charge les opérations courantes suivantes :

Cas d’utilisation	Opérations d’API
Créer et gérer des groupes	Créer, répertorier, mettre à jour et supprimer
Gestion de l’appartenance aux groupes	Lister les membres, ajouter et supprimer un membre
Gérer la propriété d’un groupe	Répertorier les propriétaires, ajouter un propriétaire et supprimer le propriétaire
Fonctionnalités de groupe Microsoft 365	Gérer les conversations, les événements de calendrier, les blocs-notes OneNote et activer pour Teams

Rôles de Microsoft Entra pour la gestion des groupes

Pour gérer les groupes, l’utilisateur connecté doit disposer des autorisations Microsoft Graph appropriées et se voir attribuer un rôle Microsoft Entra pris en charge ou un rôle personnalisé avec des autorisations prises en charge. L’administrateur de groupes est le rôle principal de la gestion des groupes, mais d’autres rôles tels qu’administrateur d’utilisateur, administrateur Exchange et enregistreurs d’annuaires peuvent également gérer des groupes avec différents niveaux d’autorisation.

Pour plus d’informations, consultez Rôles les moins privilégiés pour gérer les groupes.

Étape suivante

Commencer à travailler avec des groupes

Voir aussi

Meilleures pratiques de gestion des groupes dans le cloud

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-07-09

Gérer les groupes dans Microsoft Graph

Types de groupes pris en charge dans Microsoft Graph

Groupes Microsoft 365

Groupes de sécurité et groupes de sécurité à extension messagerie

Appartenance à un groupe

Stratégie de groupe sans propriétaire

Appartenance aux groupes

Appartenance dynamique

Autres paramètres de groupe

Limitations de la recherche de groupe pour les invités dans les organisations

Gestion des licences en fonction des groupes

Propriétés stockées en dehors du magasin de données principal

Cas d’utilisation courants de l’API de groupe

Rôles de Microsoft Entra pour la gestion des groupes

Étape suivante

Voir aussi

Commentaires

Ressources supplémentaires