Type de ressource « group »

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un groupe Microsoft Entra, qui peut être un groupe Microsoft 365, une équipe dans Microsoft Teams ou un groupe de sécurité. Cette ressource est un type ouvert qui autorise des propriétés supplémentaires au-delà de celles documentées ici.

Hérite de directoryObject.

Pour des raisons de performance, les opérations créer, obtenir et répertorier renvoient uniquement un sous-ensemble des propriétés par défaut plus couramment utilisées. Ces propriétés par défaut sont indiquées dans la section Propriétés. Pour obtenir les propriétés qui ne sont pas renvoyées par défaut, spécifiez-les dans une option de $select requête OData.

Cette ressource prend en charge les fonctions suivantes :

Groupes Microsoft Teams et Microsoft 365 prennent en charge la collaboration de groupe. Vous pouvez utiliser la plupart des API de groupes Microsoft 365 avec Microsoft Teams. Pour créer une équipe, débutez par Créer un groupe puis ajouter une équipe vers celui-ci. Pour plus d’informations, consultez l’aperçu de Microsoft Teams.

Méthodes

Méthode Type renvoyé Description
List collection group Lire les propriétés et les relations de tous les objets d’un groupe.
Create group Créer un nouveau groupe comme précisé. Il peut s’agir d’un groupe Microsoft 365, d’un groupe dynamique, d’un groupe de sécurité ou d’une équipe.
Obtenir group Récupère les propriétés et les relations d’un groupe de l’objet.
Mettre à jour Aucun Mettre à jour les propriétés d’un objet « group ».
Upsert groupe Créez un groupe s’il n’existe pas ou mettez à jour les propriétés d’un groupe existant.
Supprimer Aucun Supprime un objet « group ».
Obtenir delta collection group Obtenez des modifications incrémentielles de groupes.
Gestion des groupes
Liste des membres collection directoryObject Obtient les utilisateurs et les groupes qui sont des membres directs de ce groupe à partir de la propriété de navigation members.
Ajouter un membre directoryObject Ajoutez un membre à ce groupe en le publiant dans la propriété de navigation Membres (prise en charge pour les groupes de sécurité et les groupes Microsoft 365 uniquement).
Supprimer un membre Aucun Supprimez un membre d’un groupe Microsoft 365 ou d’un groupe de sécurité via la propriété de navigation membre.
Liste des propriétaires collection directoryObject Obtient les propriétaires du groupe à partir de la propriété de navigation owners.
Ajouter un propriétaire directoryObject Ajoutez un nouveau propriétaire pour le groupe en publiant aux propriétaires dans la propriété de navigation (prise en charge pour les groupes de sécurité et les Microsoft 365 groupes uniquement).
Supprimer un propriétaire Aucun Supprimez un propriétaire d’un groupe Microsoft 365 ou d’un groupe de sécurité via la propriété de navigation propriétaire.
Lister les appartenances collection directoryObject Obtenez les groupes, les rôles d’administrateur et les unités administratives dont ce groupe est un membre direct à partir de la propriété de navigation memberOf.
Liste des membres transitifs collection directoryObject Obtenez les utilisateurs, groupes, appareils et entités de service qui sont membres, y compris les membres imbriquées de ce groupe.
Répertorier les appartenances transitives collection directoryObject Répertoriez les groupes et unités d’administration dont fait partie ce groupe. Cette opération est transitive et comprend les groupes de ce groupe est un membre imbriqué.
Répertorier les stratégies de cycle de vie Collection groupLifecyclePolicy Liste des stratégies de cycle de vie de groupe.
Liste de points de terminaison REST collectionpoint de terminaison Obtient une collection d’objets points de terminaison.
Obtenir point de terminaison REST endpoint Lire les propriétés et les relations de l’objet point de terminaison.
Attribuer une licence group Ajouter ou supprimez des abonnements pour le groupe. Vous pouvez également activer et désactiver des plans spécifiques associés à un abonnement.
Évaluer l’appartenance dynamique evaluateDynamicMembershipResult Évaluer si un utilisateur ou un appareil est membre d’un groupe dynamique.
Renew Booléen Renouvelle l’expiration d’un groupe. Lorsqu’un groupe est renouvelé, la date d’expiration du groupe est repoussée du nombre de jours défini dans la stratégie.
Valider les propriétés JSON Validez le nom d’affichage ou le surnom de messagerie d’un groupe Microsoft 365 qui est conforme aux stratégies de nommage.
Obtenir une source d’autorité (SOA) onLocalSyncBehavior Vérifiez si la source d’autorité (SOA) de l’objet de groupe est le cloud ou Active Directory local.
Mise à jour de la source d’autorité (SOA) onLocalSyncBehavior Mettez à jour la source d’autorité (SOA) de l’objet de groupe sur le cloud ou le Active Directory local.
Attribution de rôle d’application
List Collection appRoleAssignment Obtenez les applications et les rôles d’application auxquels ce groupe a été affecté.
Add appRoleAssignment Affecter un rôle d’application à ce groupe.
Remove Aucun. Supprimer une affectation de rôle d’application de ce groupe.
Calendar
Obtenir un calendrier calendrier Obtenir le calendrier du groupe.
Mettre à jour un calendrier Aucun Mettre à jour le calendrier du groupe.
Répertorier des événements collection event Obtient une collection d’objets « event ».
Créer un événement event Créer un événement en publiant dans la collection d’objets « event ».
Obtenir un événement event Lire les propriétés d’un objet « event ».
Mettre à jour un événement Aucun Mettre à jour les propriétés d’un objet « event ».
Supprimer un événement Aucun Supprimer un objet « event ».
Répertorier les affichages de calendrier collection event Obtenir une collection d’événements dans un intervalle de temps spécifié.
Licences cloud
Répertorier les droits d’utilisation microsoft.graph.cloudLicensing.usageRight collection Obtenir la liste des objets usageRight accordés à un groupe.
Obtenir l’utilisation correcte microsoft.graph.cloudLicensing.usageRight Obtenir les propriétés et les relations d’un objet usageRight accordé à un groupe.
Conversations
Répertorier les conversations collection conversation Obtenir une collection d’objets « conversation ».
Créer une conversation conversation Crée un objet « conversation » en publiant dans la collection d’objets « conversation ».
Obtenir une conversation conversation Lire les propriétés d’un objet « conversation ».
Supprimer une conversation Aucun Supprimer un objet « conversation ».
Répertorier les threads collection conversationThread Obtenez tous les threads d’un groupe.
Créer un thread conversationThread Créer un nouveau thread de conversation.
Obtenir le thread conversationThread Lire les propriétés d’un objet « thread ».
Mettre à jour un thread Aucun Mettre à jour les propriétés d’un objet « thread ».
Supprimer un thread Aucun Supprimer un objet « thread ».
Répertorier les expéditeurs acceptés collection directoryObject Obtient la liste des utilisateurs ou groupes qui figurent dans la liste des expéditeurs acceptés pour ce groupe.
Ajouter un expéditeur accepté directoryObject Ajoute un utilisateur ou un groupe à la collection d’objets « acceptSenders ».
Supprimer un expéditeur accepté directoryObject Supprime un utilisateur ou un groupe de la collection d’objets « acceptedSenders ».
Répertorier les expéditeurs rejetés collection directoryObject Obtient la liste des utilisateurs ou groupes qui figurent dans la liste des expéditeurs rejetés pour ce groupe.
Ajouter un expéditeur rejeté directoryObject Ajoute un nouvel utilisateur ou un nouveau groupe à la collection d’objets « rejectedSenders ».
Supprimer l’expéditeur rejeté directoryObject Supprime le nouvel utilisateur ou le nouveau groupe de la collection d’objets « rejectedSenders ».
Objets d’annuaire
List deleted items collection directoryObject Récupérez les groupes supprimés dans le client au cours des 30 derniers jours.
Get deleted item collection directoryObject Récupérer un groupe supprimé par ID.
Restore deleted item collection directoryObject Restituer un groupe supprimé dans le client au cours des 30 derniers jours.
Supprimer définitivement l’élément collection directoryObject Supprimer définitivement un groupe supprimé du client.
Répertorier les éléments supprimés possédés par utilisateur collection directoryObject Récupérez les groupes supprimés dans le client au cours des 30 derniers jours qui appartiennent à un utilisateur.
Vérifier des groupes de membres String collection Vérifie l’appartenance dans une liste de groupes. Cette fonction est transitive.
Obtenir des groupes de membres String collection Renvoyer tous les groupes dont le groupe est membre. Cette fonction est transitive.
Vérifier les objets membres Collection de chaînes Vérifiez l'appartenance à une liste d'objets de groupe, de rôle d'annuaire ou d'unité administrative. Cette fonction est transitive.
Obtenir des objets de membre String collection Renvoyer tous les groupes et unités administratives dont le groupe est membre. Cette fonction est transitive.
Drive
Obtenir un lecteur drive Récupérez les propriétés et les relations d’une ressource Drive.
Répertorier les enfants Collection driveItem Renvoie une collection d’objets driveItem dans la relation enfants d’un driveItem.
Paramètres de groupe
List collectiondirectorySetting Liste des paramètres de tous les objets de paramètre.
Create directorySetting Créez un objet de paramètre basé sur un directorySettingTemplate. La demande POST doit fournir settingValues pour tous les paramètres définis dans le modèle. Seuls des modèles spécifiques à des groupes peuvent être utilisés pour cette opération.
Obtenir directorySetting Lisez les propriétés d’un objet de paramètre spécifique.
Mettre à jour Aucun Mettre à jour un objet de paramètre.
Supprimer Aucun Supprimez un objet de paramètre.
Modèles de paramètres de liste Aucun Répertorier les propriétés de tous les modèles de paramètre.
Obtenir un modèle de paramètre Aucun Lire les propriétés d’un modèle de paramètre.
Remarques
Répertorier les blocs-notes Collection de blocs-notes Récupérez la liste d’objets bloc-notes.
Créer un bloc-notes bloc-notes Créez un bloc-notes OneNote.
Informations d’identification d’authentification unique par mot de passe
Obtenir passwordSingleSignOnCredentialSet collection Obtenez la liste des informations d’identification d’authentification unique par mot de passe pour ce groupe. Les mots de passe ne sont jamais renvoyés et sont toujours renvoyés comme nuls.
Supprimer Aucun Supprimez les informations d’identification d’authentification unique par mot de passe pour un principal de service donné associé à ce groupe.
Nom.
Photo de profil
Obtenir profilePhoto Obtenir l’élément profilePhoto spécifié ou ses métadonnées (propriétés profilePhoto).
Mettre à jour Aucun Mettez à jour la photo pour tout utilisateur du client, y compris l’utilisateur connecté, ou le groupe ou le contact spécifié.
Supprimer Aucun Supprimez la photo pour tout utilisateur du client, y compris l’utilisateur connecté ou le groupe spécifié.
Planner
Répertorier les plans Collection plannerPlan Obtenir les plans affectés au groupe.
Posts
List collection post Obtenir des billets dans un fil de conversation.
Obtenir post Obtenir un billet spécifique.
Répondre à la publication Aucun Répondre à un billet.
Transférer une publication Aucun Transférer un billet.
Autres ressources de groupe
Répertorier les octrois d’autorisations Collection resourceSpecificPermissionGrant Listez les autorisations accordées aux applications pour accéder au groupe.
Paramètres utilisateur
Ajouter un favori Aucun Ajoute le groupe à la liste des groupes favoris de l’utilisateur connecté. Pris en charge pour les groupes Microsoft 365 uniquement.
Supprimer un favori Aucun Supprime le groupe de la liste des groupes favoris de l’utilisateur connecté. Pris en charge pour les groupes Microsoft 365 uniquement.
Répertorier les membres de collection directoryObject Obtenez les groupes et les unités administratives dont cet utilisateur est un membre direct à partir de la propriété de navigation memberOf .
Répertorier les équipes rejointes collection group Bénéficiez de Microsoft Teams dont l’utilisateur est un membre direct.
Répertorier les équipes associées Collection associatedTeamInfo Obtenez la liste des objets associatedTeamInfo dans Microsoft Teams auxquelles un utilisateur est associé.
S’abonner par courrier électronique Aucun Définit la propriété isSubscribedByMail sur true. Permet à l’utilisateur connecté de recevoir des e-mails. Pris en charge pour les groupes Microsoft 365 uniquement.
Se désabonner par courrier électronique Aucun Définit la propriété isSubscribedByMail sur false. Désactivation de la réception des conversations par courrier électronique à l’utilisateur connecté. Pris en charge pour les groupes Microsoft 365 uniquement.
Réinitialiser les non lus Aucun Réinitialisez unseenCount sur 0 pour toutes les publications que l’utilisateur connecté n’a pas vues depuis sa dernière visite. Pris en charge pour les groupes Microsoft 365 uniquement.

Propriétés

Importante

L’utilisation spécifique de $filter et du paramètre de requête $search n’est prise en charge que lorsque vous utilisez l’en-tête ConsistencyLevel défini sur eventual et $count. Pour plus d’informations, voir Fonctionnalités de requête avancées sur les objets d’annuaire.

Propriété Type Description
accessType groupAccessType Indique le type d’accès au groupe. Les valeurs possibles sont none, , secretprivateet public.
allowExternalSenders Booléen Indique si les personnes extérieures à l’organisation peuvent envoyer des messages au groupe. La valeur par défaut est false.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
assignedLabels Collection assignedLabel Liste des paires d’étiquettes de confidentialité (ID d’étiquette, nom de l’étiquette) associées à un groupe Microsoft 365 ou à un groupe de sécurité cloud. Nécessite une licence Microsoft Entra ID P1.

Besoin $select de récupération. Cette propriété peut être spécifiée lors de la création ou de la mise à jour du groupe. Toutefois, pour les groupes de sécurité cloud, il est immuable une fois défini. Cette propriété peut être mise à jour uniquement dans les scénarios délégués où l’appelant doit à la fois disposer de l’autorisation Microsoft Graph et d’un rôle d’administrateur pris en charge. Pour en savoir plus sur la gestion de cette propriété pour Microsoft 365 et les groupes de sécurité cloud par rapport à ceux de Microsoft 365, consultez Principales différences par rapport à l’étiquetage de groupe Microsoft 365 .
assignedLicenses collection assignedLicense Licences attribuées à l’utilisateur.

Besoin $select de récupération. Prend en charge $filter (eq). En lecture seule.
autoSubscribeNewMembers Booléen Indique si les nouveaux membres ajoutés au groupe sont automatiquement abonnés pour recevoir des Notifications par e-mail. Vous pouvez définir cette propriété dans une requête PATCH pour le groupe ; ne le définissez pas dans la requête POST initiale qui crée le groupe. La valeur par défaut est false.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
classification String Décrit une classification pour le groupe (par exemple, impact faible, moyen ou élevé sur l’entreprise). Les valeurs valides pour cette propriété sont définies en créant une valeur de paramètre ClassificationList, en fonction de la définition du modèle.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, startsWith).
cloudLicensing microsoft.graph.cloudLicensing.groupCloudLicensing Relations d’un groupe avec des ressources de licences cloud.
createdByAppId Chaîne ID de l'application utilisée pour créer le groupe. Valeur pouvant être null pour certains groupes.

Renvoyée par défaut. En lecture seule. Prend en charge $filter (eq, ne, not, in, startsWith).
createdDateTime DateTimeOffset Horodatage de la création du groupe. La valeur ne peut pas être modifiée et est automatiquement renseignée lors de la création du groupe. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Renvoyée par défaut. En lecture seule.
deletedDateTime DateTimeOffset Pour certains objets Microsoft Entra (utilisateur, groupe, application), si l’objet est supprimé, il est d’abord supprimé logiquement, et cette propriété est mise à jour avec la date et l’heure auxquelles l’objet a été supprimé. Sinon, cette propriété est null. Si l’objet est restauré, cette propriété est mise à jour avec la valeur null. Hérité de directoryObject.
description String Description facultative du groupe.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, startsWith, $search).
displayName String Nom complet du groupe. Obligatoire. Longueur maximale : 256 caractères.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, in, startsWithet eq sur null valeurs), $searchet $orderby.
expirationDateTime DateTimeOffset Horodatage du dernier renouvellement du groupe. Il est null destiné aux groupes de sécurité, mais pour les groupes Microsoft 365, il représente le moment où le groupe est défini pour expirer, comme défini dans groupLifecyclePolicy. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, in). En lecture seule.
groupTypes String collection Spécifie le type et l’appartenance du groupe.

Si la collection contient Unified, le groupe est un groupe Microsoft 365 ; sinon, il s’agit soit d’un groupe de sécurité, soit d’un groupe de distribution. Pour plus de détails, consultez l'aperçu des groupes.

Si la collection inclut DynamicMembership, le groupe a une appartenance dynamique. Sinon, l’appartenance est statique.

Renvoyée par défaut. Prend en charge $filter (eq, not).
hasMembersWithLicenseErrors Booléen Indique s’il existe des membres de ce groupe avec erreurs de licence à partir de cette attribution des licences basée sur le groupe.

Cette propriété n’est jamais renvoyée sur une opération GET. Vous pouvez l’utiliser comme un argument $filter pour obtenir des groupes comportant des membres avec des erreurs de licence (autrement dit, le filtre pour cette propriété est true).

Prend en charge $filter (eq).
hideFromAddressLists Boolean true si le groupe n’est pas affiché dans certaines parties de l’interface utilisateur Outlook : dans le carnet d’adresses, dans les listes d’adresses pour sélectionner les destinataires des messages et dans la boîte de dialogue Parcourir les groupes pour rechercher des groupes ; false dans le cas contraire. La valeur par défaut est false.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
hideFromOutlookClients Boolean trueSi le groupe n’est pas affiché dans les clients Outlook, tels qu’Outlook pour Windows et Outlook sur le web, sinon false. La valeur par défaut est false.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
id String Identificateur unique du groupe.

Renvoyée par défaut. Hérité de directoryObject. Clé. Ne peut pas avoir la valeur Null. En lecture seule.

Prend en charge $filter (eq, ne, not, in).
isArchived Boolean Lorsqu’un groupe est associé à une équipe, cette propriété indique si l’équipe est en mode lecture seule.
Pour lire cette propriété, utilisez le /group/{groupId}/teampoint de terminaison ou l’API Get team. Pour mettre à jour cette propriété, utilisez les API archiveTeam et unarchiveTeam .
isAssignableToRole Boolean Indique si ce groupe peut être affecté à un rôle Microsoft Entra. Facultatif.

Cette propriété ne peut être activée que lors de la création du groupe et est immuable. Si la valeur est , truela propriété securityEnabled doit également être définie sur true, la visibilité doit être Hidden, et le groupe ne peut pas être un groupe dynamique (autrement dit, groupTypes ne peut pas contenir DynamicMembership).

Seuls les appelants avec au moins le rôle d’administrateur de rôle privilégié peuvent définir cette propriété. L’appelant doit également disposer de l’autorisation RoleManagement.ReadWrite.Directory pour définir cette propriété ou mettre à jour l’appartenance à ces groupes. Pour plus d’informations, voir Utilisation d’un groupe pour gérer les attributions de rôles Microsoft Entra

L’utilisation de cette fonctionnalité nécessite une licence Microsoft Entra ID P1. Renvoyée par défaut. Prend en charge $filter (eq, ne, not).
isFavorite Boolean Indique si l’utilisateur a marqué le groupe comme favori.
isManagementRestricted Booléen Indique si le groupe est membre d’une unité administrative de gestion restreinte. Si elle n’est pas définie, la valeur par défaut est null false et le comportement par défaut est false. En lecture seule.

Pour gérer un membre d’un groupe d’une unité administrative de gestion restreinte, l’administrateur ou l’application appelante doit se voir attribuer un rôle Microsoft Entra dans le cadre de l’unité administrative de gestion restreinte.
infoCatalogs Collection de chaînes Identifie les segments d’informations attribués au groupe. Renvoyée par défaut. Prend en charge $filter (eq, not, ge, le, startsWith).
isSubscribedByMail Booléen Indique si l’utilisateur connecté est abonné pour recevoir des e-mails. La valeur par défaut est true.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
licenseProcessingState Chaîne Indique le status de l’attribution de la licence de groupe à tous les membres du groupe. Les valeurs possibles sont QueuedForProcessing, ProcessingInProgressetProcessingComplete.

Besoin $select de récupération. En lecture seule.
messagerie String Adresse SMTP du groupe, par exemple «serviceadmins@contoso.com ».

Renvoyée par défaut. En lecture seule. Prend en charge $filter (eq, ne, not, ge, le, in, startsWithet eq sur les valeurs null ).
mailEnabled Boolean Indique si le groupe est à extension messagerie. Obligatoire.

Renvoyée par défaut. Prend en charge $filter (eq, ne, notet eq sur les valeurs null ).
mailNickname String Alias de messagerie du groupe, unique pour Microsoft 365 de l’organisation. Longueur maximale : 64 caractères. Cette propriété ne peut contenir que des caractères dans le jeu de caractères ASCII 0 – 127, sauf les caractères suivants : @ () \ [] " ; : <> , SPACE.

Renvoyé par défaut. Prend en charge $filter (eq, ne, not, ge, le, in, startsWith).
membershipRule Chaîne La règle qui détermine les membres de ce groupe si le groupe est un groupe dynamique (groupTypes contient DynamicMembership). Pour plus d’informations sur la syntaxe de la règle d’appartenance, reportez-vous à la rubrique relative aux syntaxe règles d’appartenance.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, startsWith).
membershipRuleProcessingState Chaîne Indique si le traitement d’appartenance dynamique est en cours ou suspendu. Les valeurs possibles sont : On ou Paused.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, in).
membershipRuleProcessingStatus membershipRuleProcessingStatus Décrit l’état du traitement pour les groupes dynamiques basés sur des règles. La propriété est null destinée aux groupes dynamiques non basés sur des règles ou si le traitement du groupe dynamique a été suspendu.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}). En lecture seule.
onPremisesDomainName String Contient le nom de domaine complet, également appelé dnsDomainName synchronisé à partir de l’annuaire local. La propriété est uniquement remplie pour les clients qui synchronisent leur annuaire local avec Microsoft Entra ID via Microsoft Entra Connect.

Renvoyée par défaut. En lecture seule.
onPremisesExtensionAttributes onPremisesExtensionAttributes Type complexe contenant les attributs d’extension 1 à 15 pour le groupe, synchronisé à partir de Active Directory local. Renvoyé uniquement sur $select. Prend en charge $filter (eq, ne, not, in).
onPremisesLastSyncDateTime DateTimeOffset Indique la dernière fois que le groupe a été synchronisé avec l’annuaire local. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Renvoyée par défaut. En lecture seule. Prend en charge $filter (eq, ne, not, ge, le, in).
onPremisesNetBiosName Chaîne Contient le nom NetBIOS local synchronisé à partir de l’annuaire local. La propriété est uniquement remplie pour les clients qui synchronisent leur annuaire local avec Microsoft Entra ID via Microsoft Entra Connect.

Renvoyée par défaut. En lecture seule.
onPremisesProvisioningErrors collectionOnPremisesProvisioningError Erreurs lors de l’utilisation du produit de synchronisation d’annuaires Microsoft pendant la mise en service.

Renvoyée par défaut. Prend en charge $filter (eq, not).
onPremisesSamAccountName Chaîne Contient le nom de compte SAM local synchronisé à partir de l’annuaire local. La propriété est uniquement remplie pour les clients qui synchronisent leur annuaire local avec Microsoft Entra ID via Microsoft Entra Connect.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, in, startsWith). En lecture seule.
onPremisesSecurityIdentifier String Contient l’identificateur de sécurité local (SID) du groupe synchronisé à partir du local vers le cloud. En lecture seule.

Renvoyée par défaut. Prend en charge $filter (eq y compris sur les valeurs null).
onPremisesSyncEnabled Boolean true si ce groupe est synchronisé à partir d’un répertoire local ; false si ce groupe a été initialement synchronisé à partir d’un répertoire local, mais n’est plus synchronisé ; null s’il n’a jamais été synchronisé à partir d’un répertoire local (valeur par défaut).

Renvoyée par défaut. En lecture seule. Prend en charge $filter (eq, ne, not, inet eq sur les valeurs null ).
preferredDataLocation Chaîne Emplacement de données préféré pour le groupe Microsoft 365. Par défaut, le groupe hérite de l’emplacement de données préféré du créateur du groupe. Pour définir cette propriété, l’application appelante doit disposer de l’autorisation Directory.ReadWrite.All et l’utilisateur doit se voir attribuer au moins un des rôles Microsoft Entra suivants :
  • Administrateur de compte d’utilisateur
  • Rédacteur d’annuaire
  • Administrateur Exchange
  • Administrateur SharePoint

Pour plus d’informations sur cette propriété, voir OneDrive Online Multigéographique et Créer un groupe Microsoft 365 avec un PDL spécifique.

Pouvant accepter la valeur Null. Renvoyée par défaut.
preferredLanguage String Langue par défaut du groupe Microsoft 365. Doit respecter le Code ISO 639-1 ; par exemple en-US.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, in, startsWithet eq sur les valeurs null ).
proxyAddresses String collection Adresses de messagerie pour le groupe qui transfèrent vers la même boîte aux lettres de groupe. Par exemple : ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. L’opérateur any est requis pour les expressions de filtre sur des propriétés à valeurs multiples.

Renvoyée par défaut. En lecture seule. Ne pouvant accepter la valeur null. Prend en charge $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).
renewedDateTime DateTimeOffset Horodatage du dernier renouvellement du groupe. Il ne peut pas être modifié directement et ne peut être mis à jour que via l’action de service renew. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, ge, le, in). En lecture seule.
resourceBehaviorOptions Collection de chaînes Décrit les comportements de groupe pouvant être définis pour un groupe Microsoft 365 lors de la création. Cette propriété ne peut être définie que dans le cadre de la création (POST). Pour obtenir la liste des valeurs possibles, voir Comportements de groupe et options d’approvisionnement de Microsoft 365.
resourceProvisioningOptions Collection de chaînes Spécifie les ressources de groupe associées au groupe Microsoft 365. La valeur possible est Team. Pour plus d’informations, voir Comportements de groupe et options d’approvisionnement de Microsoft 365.

Renvoyée par défaut. Prend en charge $filter (eq, not, startsWith).
securityEnabled Boolean Indique si le groupe est un groupe de sécurité. Obligatoire.

Renvoyée par défaut. Prend en charge $filter (eq, ne, not, in).
securityIdentifier String Identificateur de sécurité du groupe, utilisé dans les scénarios Windows. En lecture seule.

Renvoyé par défaut.
serviceProvisioningErrors collection serviceProvisioningError Erreurs publiées par un service fédéré décrivant une erreur non temporaire, spécifique au service concernant les propriétés ou le lien à partir d’un objet de groupe.
thème String Spécifie le thème de couleur d’un groupe Microsoft 365. Les valeurs possibles sontTeal, Purple, Green, Blue, Pink, Orange ou Red.

Renvoyée par défaut.
uniqueName String Identificateur unique qui peut être attribué à un groupe et utilisé comme clé secondaire. Non modifiable. En lecture seule.
unseenConversationsCount Int32 Nombre de conversations ayant livré une ou plusieurs nouvelles publications depuis la dernière visite de l’utilisateur connecté au groupe. Cette propriété est identique à unseenCount.

Besoin $select de récupération.
unseenCount Int32 Nombre de conversations qui ont reçu les nouvelles publications depuis la dernière visite de l’utilisateur connecté dans le groupe. Cette propriété est identique à unseenConversationsCount.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
unseenMessagesCount Int32 Les nombre de nouvelles publications ont été remis à aux conversations de groupe depuis la dernière visite de l’utilisateur sur le groupe.

Besoin $select de récupération.
visibility String Spécifie la stratégie d’adhésion au groupe et la visibilité du contenu des groupes. Les valeurs possibles sont : Private, Public, ou HiddenMembership. HiddenMembership ne peut être définie que pour les groupes Microsoft 365 lors de leur création. Vous ne pouvez pas mettre à jour cette valeur par la suite. Vous pouvez mettre à jour les autres valeurs de visibilité après la création des groupes.
Si la valeur de visibilité n’est pas spécifiée lors de la création du groupe sur Microsoft Graph, un groupe de sécurité est créé comme Private par défaut, et le groupe Microsoft 365 est Public. Les groupes attribués à des rôles sont toujours Private. Pour en savoir plus, consultez les options de visibilité des groupes.

Renvoyée par défaut. Pouvant accepter la valeur Null.
welcomeMessageEnabled Booléen Indique si un message de bienvenue est envoyé aux nouveaux membres lorsqu’ils sont ajoutés au groupe. La valeur par défaut est true.

Besoin $select de récupération. Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID}).
writebackConfiguration groupWritebackConfiguration Spécifie si un groupe est configuré pour réécrire les propriétés des objets du groupe dans Active Directory local. Ces propriétés sont utilisées lorsque l’écriture différée de groupe est configurée dans le client de synchronisation Microsoft Entra Connect.

Options de visibilité de groupe

Valeur Description
Public Tout le monde peut rejoindre le groupe sans l’autorisation du propriétaire.
Tout le monde peut afficher le contenu du groupe.
Private Les autorisations de propriété sont nécessaires pour rejoindre le groupe.
Les non-membres peuvent consulter les contenus du groupe.
Hiddenmembership Les autorisations de propriété sont nécessaires pour rejoindre le groupe.
Les non-membres peuvent consulter les contenus du groupe.
Tout le monde peut voir les membres du groupe.
Les administrateurs (général, société, utilisateur et au support technique) peuvent afficher l’appartenance au groupe.
Le groupe apparaît dans le carnet d’adresses globales (LAG).

Relations

Relation Type Description
acceptedSenders collection directoryObject Liste des utilisateurs ou groupes autorisés à créer des billets ou des événements de calendrier dans ce groupe. Si cette liste n’est pas vide, seuls les utilisateurs ou groupes répertoriés ici peuvent publier.
appRoleAssignments Collection appRoleAssignment Représente les rôles d’application qu’un groupe a accordés à une application. Prend en charge $expand.
calendrier calendar Calendrier du groupe. En lecture seule.
calendarView collection event Affichage Calendrier pour le calendrier. En lecture seule.
conversations collection conversation Conversations du groupe.
createdOnBehalfOf directoryObject Utilisateur (ou application) qui a créé le groupe. Remarque : Cette option n’est pas définie si l’utilisateur est un administrateur. En lecture seule.
lecteur lecteur Lecteur par défaut du groupe. En lecture seule.
lecteurs Collection d’objets lecteur Lecteurs du groupe. En lecture seule.
Points de terminaison collectionPoint de terminaison Points de terminaison pour le groupe. En lecture seule. Pouvant accepter la valeur Null.
événements collection event Événements du groupe.
extensions collection extension Collection d’extensions ouvertes définie pour le groupe. En lecture seule. Pouvant accepter la valeur Null.
groupLifecyclePolicies Collection groupLifecyclePolicy L’ensemble de stratégies de cycle de vie pour ce groupe. En lecture seule. Peut avoir la valeur Null.
memberOf collection directoryObject Liste de groupes et unités administratives dont l’utilisateur est membre. Méthodes HTTP: GET (prise en charge pour tous les groupes). En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand.
membres collection directoryObject Membres directs du groupe, qui peuvent être des utilisateurs, des appareils, d’autres groupes ou des principaux de service. Prend en charge les opérations Répertorier les membres, Ajouter un membre, et Supprimer un membre. Pouvant accepter la valeur Null.
Prend en charge $expand ainsi que les $select imbriqués. Par exemple : /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName).
membersWithLicenseErrors Collection user Liste des membres du groupe avec des erreurs de licence de cette attribution des licences basée sur le groupe. En lecture seule.
OneNote onenote En lecture seule.
onLocalSyncBehavior onLocalSyncBehavior Indique l’état de synchronisation d’un groupe entre le cloud et Active Directory Active Directory local. Prend en charge $filter uniquement avec des capacités de requête avancées. Par exemple : $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true.
Propriétaires collection directoryObject Les propriétaires du groupe qui peuvent être des utilisateurs ou des responsables de services. Limité à 100 propriétaires. Pouvant accepter la valeur Null.
  • Si cette propriété n’est pas spécifiée lors de la création d’un groupe Microsoft 365, l’utilisateur appelant (administrateur ou non) est automatiquement affecté en tant que propriétaire du groupe.
  • Un utilisateur non administrateur ne peut pas s’ajouter explicitement à cette collection lorsqu’il crée le groupe. Pour plus d’informations, voir le problème connu associé.
  • Pour les groupes de sécurité, l’utilisateur administrateur n’est pas automatiquement ajouté à cette collection. Pour plus d’informations, voir le problème connu associé.

    Prend en charge $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1) ; Prend en charge $expand , y compris les $selectfichiers . Par exemple : /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).
permissionGrants resourceSpecificPermissionGrant Autorisations accordées pour un groupe à une application spécifique. Prend en charge $expand.
photo profilePhoto Photo de profil du groupe.
photos Collection profilePhoto Les photos de profil appartenant au groupe. En lecture seule. Pouvant accepter la valeur Null.
planner plannerGroup Services Planner sélectives disponibles au groupe. En lecture seule. Pouvant accepter la valeur Null.
rejectedSenders collection directoryObject Liste des utilisateurs ou groupes non autorisés à créer des billets ou des événements de calendrier dans ce groupe. Peut accepter la valeur Null
paramètres collectiondirectorySetting Les paramètres qui contrôlent les comportement de ce groupe, par exemple, si les membres peuvent inviter des utilisateurs invités au groupe. Pouvant accepter la valeur Null.
sites collection de sites Liste des sites SharePoint dans ce groupe. Accédez au site par défaut avec /sites/root.
team collection channel L’équipe associée à ce groupe
threads collection conversationThread Threads de conversation du groupe. Pouvant accepter la valeur Null.
transitiveMemberOf collection directoryObject Les groupes dont un groupe est membre, directement ou par le biais d’une appartenance imbriquée. Pouvant accepter la valeur Null.
transitiveMembers collection directoryObject Membres directs et transitifs d’un groupe. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "accessType": "String",
  "assignedLabels": [{ "@odata.type": "microsoft.graph.assignedLabel" }],
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "allowExternalSenders": "Boolean",
  "autoSubscribeNewMembers": "Boolean",
  "cloudLicensing": { "@odata.type": "microsoft.graph.cloudLicensing.groupCloudLicensing" },
  "createdByAppId": "String",
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "expirationDateTime": "String (timestamp)",
  "groupTypes": ["String"],
  "hideFromAddressLists": "Boolean",
  "hideFromOutlookClients": "Boolean",
  "welcomeMessageEnabled": "Boolean",
  "id": "String (identifier)",
  "isFavorite": "Boolean",
  "isArchived": "Boolean",
  "isAssignableToRole": "Boolean",
  "isManagementRestricted": "Boolean",
  "isSubscribedByMail": "Boolean",
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": "Boolean",
  "mailNickname": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": { "@odata.type": "microsoft.graph.onPremisesExtensionAttributes" }, 
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "String",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": "Boolean",
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": "Boolean",
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "uniqueName": "String",
  "unseenConversationsCount": "Int32",
  "unseenCount": "Int32",
  "unseenMessagesCount": "Int32",
  "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" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "classification": "String",
  "hasMembersWithLicenseErrors": "Boolean",
  "membershipRule": "String",
  "membershipRuleProcessingState": "String",
  "membershipRuleProcessingStatus": {
    "@odata.type": "microsoft.graph.membershipRuleProcessingStatus"
  },
  "preferredLanguage": "String",
  "theme": "String"
}

Contenu connexe

  • Last updated on