Type de ressource « group »
Espace de noms: microsoft.graph
Représente un groupe Microsoft Entra, un groupe Microsoft 365 ou un groupe de sécurité. Cette ressource est un type ouvert qui permet de transmettre d’autres propriétés.
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 non retournées par défaut, spécifiez-les dans une $select
option de requête OData.
Cette ressource prend en charge les fonctions suivantes :
- Ajout de vos données à des propriétés personnalisées en tant qu’extensions.
- Abonnementles notifications de modification.
- Utilisation de la requête delta pour effectuer le suivi des suppressions, des mises à jour et des ajouts incrémentiels à l’aide de la fonction delta.
Méthodes
Méthode | Type renvoyé | Description |
---|---|---|
Gestion des groupes | ||
Créer un groupe | group | Créer un groupe. Il peut s’agir d’un groupe Microsoft 365, d’un groupe dynamique ou d’un groupe de sécurité. |
Obtenir un groupe | group | Lis les propriétés d’un objet « group ». |
Répertorier les groupes | collection group | Répertorie les objets « group » et leurs propriétés. |
Mettre à jour un groupe | Aucun | Mettre à jour les propriétés d’un objet « group ». |
Groupe Upsert | groupe | Créez un groupe s’il n’existe pas ou mettez à jour les propriétés d’un groupe existant. |
Supprimer un groupe | Aucun | Supprime un objet « group ». |
delta | collection de groupes | Obtenez des modifications incrémentielles de groupes. |
Ajouter des membres | Aucun | Ajoutez un membre à ce groupe en publiant dans la propriété de navigation members (prise en charge pour les groupes de sécurité et les groupes Microsoft 365 uniquement). |
Ajouter des propriétaires | Aucun | Ajoutez un nouveau propriétaire pour le groupe en validant la propriété de navigation pour les propriétaires (prise en charge pour les groupes de sécurité et les groupes Microsoft 365 uniquement). |
Répertorier groupLifecyclePolicies | Collection groupLifecyclePolicy | Liste des stratégies de cycle de vie de groupe. |
Liste des membres | collection directoryObject | Obtenez les membres directs de ce groupe à partir de la propriété de navigation membres. |
Liste des propriétaires | collection directoryObject | Obtient les propriétaires du groupe à partir de la propriété de navigation owners. |
Liste des membres transitifs | Collection directoryObject | Obtenez les utilisateurs, groupes et appareils qui sont membres, y compris les membres imbriquées de ce groupe. |
Liste des objets membresOf transitifs | collection directoryObject | Groupes dont ce groupe est membre. Cette opération est transitive et comprend les groupes de ce groupe est un membre imbriqué. |
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. |
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. |
assignLicense | group | Ajouter ou supprimez des abonnements pour le groupe. Vous pouvez également activer et désactiver des plans spécifiques associés à un abonnement. |
Renouvellement | 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. |
validateProperties | JSON | Validez que le nom d’affichage d’un groupe Microsoft 365 ou surnom d’un courrier est conforme aux stratégies de noms. |
Attribution de rôle d’application | ||
Liste des appRoleAssignments | Collection appRoleAssignment | Obtenez les applications et les rôles d’application auxquels ce groupe a été affecté. |
Ajouter appRoleAssignment | appRoleAssignment | Affecter un rôle d’application à ce groupe. |
Supprimer appRoleAssignment | Aucun. | Supprimer une affectation de rôle d’application de ce groupe. |
Calendar | ||
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 ». |
Répertorier les événements | collection event | Obtient une collection d’objets « 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 objets calendarView | collection event | Obtenir une collection d’événements dans un intervalle de temps spécifié. |
Conversations | ||
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 ». |
Répertorier les conversations | collection conversation | Obtenir une collection d’objets « conversation ». |
Supprimer une conversation | Aucun | Supprimer un objet « conversation ». |
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 ». |
Répertorier les threads | collection conversationThread | Obtenir tous les threads d’un groupe. |
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 objets acceptedSenders | collection directoryObject | Obtient la liste des utilisateurs ou groupes qui figurent dans la liste des expéditeurs acceptés pour ce groupe. |
Ajouter un objet acceptedSender | directoryObject | Ajoute un utilisateur ou un groupe à la collection d’objets « acceptSenders ». |
Supprimer un objet acceptedSender | directoryObject | Supprime un utilisateur ou un groupe de la collection d’objets « acceptedSenders ». |
Répertorier les objets rejectedSenders | collection directoryObject | Obtient la liste des utilisateurs ou groupes qui figurent dans la liste des expéditeurs rejetés pour ce groupe. |
Ajouter un objet rejectedSender | directoryObject | Ajoute un nouvel utilisateur ou un nouveau groupe à la collection d’objets « rejectedSenders ». |
Supprimer un objet rejectedSender | directoryObject | Supprime le nouvel utilisateur ou le nouveau groupe de la collection d’objets « rejectedSenders ». |
Créer un paramètre | groupSetting | Créez un objet de paramètre basé sur un groupSettingTemplate. La requête POST doit fournir des valeurs de paramètre 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. |
Objets d’annuaire | ||
Répertorier les groupes supprimés | collection directoryObject | Récupérez les groupes supprimés dans le client au cours des 30 derniers jours. |
Liste des groupes supprimés détenus par un utilisateur | collection directoryObject | Récupérez les groupes supprimés dans le client au cours des 30 derniers jours et appartenant à un utilisateur. |
Obtenir le groupe supprimé | collection directoryObject | Récupérer un groupe supprimé par ID. |
Restaurer un groupe supprimé | collection directoryObject | Restituer un groupe supprimé dans le client au cours des 30 derniers jours. |
Supprimer définitivement le groupe | collection directoryObject | Supprimer définitivement un groupe supprimé du client. |
checkMemberGroups | String collection | Vérifie l’appartenance dans une liste de groupes. Cette fonction est transitive. |
getMemberGroups | String collection | Renvoie tous les groupes dont le groupe est membre. Cette fonction est transitive. |
checkMemberObjects | 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. |
getMemberObjects | String collection | Retourne tous les groupes et unités administratives dont le groupe est membre. Cette fonction est transitive. |
Paramètres de groupe | ||
Obtenir un paramètre | groupSetting | Lisez les propriétés d’un objet de paramètre spécifique. |
Liste des paramètres | Collection de groupSettings | Liste des paramètres de tous les objets de paramètre. |
Mettre à jour un paramètre | Aucun | Mettre à jour un objet de paramètre. |
Supprimer un paramètre | Aucun | Supprimez un objet de paramètre. |
Obtenir un modèle de paramètre | Aucun | Lire les propriétés d’un modèle de paramètre. |
Répertorier un modèle de paramètre | Aucun | Répertorier les propriétés de tous les modèles de paramètre. |
Extensions d’ouverture | ||
Créer une extension d’ouverture | openTypeExtension | Créer une extension d’ouverture et ajouter des propriétés personnalisées dans une ressource nouvelle ou existante. |
Obtenir une extension d’ouverture | collection openTypeExtension | Obtenir une extension d’ouverture identifiée par le nom de l’extension. |
Extensions de schéma | ||
Ajouter des valeurs d’extension de schéma | Aucun | Créer une définition d’extension de schéma, puis l’utiliser pour ajouter des données personnalisées à une ressource. |
Autres ressources de groupe | ||
Répertorier les photos | Collection profilePhoto | Renvoie une collection de photos de profil pour le groupe. |
Répertorier les objets plannerPlan | Collection plannerPlan | Obtenir des plans Planner appartenant au groupe. |
Répertorier les permissionGrants | Collection resourceSpecificPermissionGrant | Répertoriez les autorisations qui ont été accordées aux applications pour accéder au groupe. |
Paramètres utilisateur | ||
addFavorite | Aucun | Ajoute le groupe à la liste des groupes favoris de l’utilisateur connecté. Pris en charge pour les groupes Microsoft 365 uniquement. |
removeFavorite | 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 memberOf | collection directoryObject | Obtient les groupes et les unités administratives dont l’utilisateur est un membre direct, à partir de la propriété de navigation memberOf. |
Liste joinedTeams | 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é. |
subscribeByMail | 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. |
unsubscribeByMail | Aucun | Définit la propriété isSubscribedByMail sur false . Empêche l’utilisateur connecté de recevoir des e-mails. Pris en charge pour les groupes Microsoft 365 uniquement. |
resetUnseenCount | Aucun | Remet à 0 la valeur unseenCount de tous les billets non vus par l’utilisateur connecté 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, consultez Fonctionnalités de requête avancées sur les objets d’annuaire.
Propriété | Type | Description |
---|---|---|
allowExternalSenders | Booléen | Indique si les personnes extérieures à l’organisation peuvent envoyer des messages au groupe. La valeur par défaut est false . Renvoyé uniquement sur $select . Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID} ). |
assignedLabels | Collection assignedLabel | La liste des paires d’étiquettes de confidentialité (ID d’étiquette, nom d’étiquette) associées à un groupe Microsoft 365. Renvoyé uniquement sur $select . |
assignedLicenses | collection assignedLicense | Licences attribuées à l’utilisateur. Renvoyé uniquement sur $select . Prend en charge $filter (eq ). En lecture seule. |
autoSubscribeNewMembers | Booléen | Indique si les nouveaux membres ajoutés au groupe seront automatiquement inscrits pour recevoir des notifications par courrier électronique. Vous pouvez définir cette propriété en envoyant une demande PATCH au groupe ; ne la définissez pas dans la demande POST initiale qui crée le groupe. La valeur par défaut est false . Renvoyé uniquement sur $select . 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’activité). Les valeurs valides pour cette propriété sont définies en créant une valeur de paramètre ClassificationList, basée sur la définition du modèle. Renvoyée par défaut. Prend en charge $filter (eq , ne , not , ge , le , startsWith ). |
createdDateTime | DateTimeOffset | Horodatage de la création du groupe. La valeur ne peut pas être modifiée et est renseignée automatiquement une fois le groupe créé. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure 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 de suppression de l’objet. Sinon, cette propriété est null . Si l’objet est restauré, cette propriété est mise à jour avec la valeur null . |
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. Cette propriété est requise lors de la création d’un groupe, et ne peut pas être désactivée lors des mises à jour. Longueur maximale : 256 caractères. Renvoyée par défaut. Prend en charge $filter (eq , ne , not , ge , le , in , startsWith et eq sur null valeurs), $search et $orderby . |
expirationDateTime | DateTimeOffset | Horodatage du dernier renouvellement du groupe. Il s’agit null des 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 la stratégie groupLifecyclePolicy. Le type Timestamp 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 d’un groupe de sécurité ou 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). Consultez un exemple. Prend en charge $filter (eq ). |
hideFromAddressLists | Boolean | True si le groupe n’apparaît pas dans certaines parties de d’Outlook dans l’interface utilisateur : carnet d’adresses, les listes d’adresses pour la sélection des destinataires des messages, et la boîte de dialogue Parcourir les groupes pour la recherche de groupes ; dans le cas contraire, false. La valeur par défaut est false . Renvoyé uniquement sur $select . Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID} ). |
hideFromOutlookClients | Boolean | True si le groupe n’apparaît pas dans les clients Outlook, tels qu’Outlook pour Windows et Outlook sur le web ; dans le cas contraire, false. La valeur par défaut est false . Renvoyé uniquement sur $select . 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}/team point 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. Optional. Cette propriété ne peut être activée que lors de la création du groupe et est immuable. Si la true valeur est , la 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 des rôles Administrateur général et Administrateur de rôle privilégié peuvent définir cette propriété. L’appelant doit également recevoir l’autorisation RoleManagement.ReadWrite.Directory pour définir cette propriété ou mettre à jour l’appartenance de ces groupes. Pour plus d’informations, consultez 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é par défaut. Prend en charge $filter (eq , ne , not ). |
isSubscribedByMail | Booléen | Indique si l’utilisateur connecté est abonné pour recevoir des e-mails. La valeur par défaut est true . Renvoyé uniquement sur $select . Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID} ). |
licenseProcessingState | Chaîne | Indique la status de l’attribution de licence de groupe à tous les membres du groupe. La valeur par défaut est false . En lecture seule. Les valeurs possibles sont QueuedForProcessing , ProcessingInProgress etProcessingComplete .Renvoyé uniquement sur $select . 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 , startsWith et 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 , not ). |
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 . Obligatoire. Renvoyée par défaut. Prend en charge $filter (eq , ne , not , ge , le , in , startsWith et eq sur les valeurs null ). |
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 ). |
onPremisesLastSyncDateTime | DateTimeOffset | Indique l’heure de dernière synchronisation du groupe avec le répertoire local. Le type Timestamp représente les informations de date et d’heure à l’aide du 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 ). |
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 renseignée uniquement pour les clients synchronisant leur annuaire local pour Microsoft Entra ID via Microsoft Entra Connect. Renvoyé 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é (SID) local pour le groupe synchronisé de l’environnement local vers le cloud. Renvoyée par défaut. Prend en charge $filter (eq y compris sur les valeurs null ). En lecture seule. |
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 , in et 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 l’un des rôles Microsoft Entra suivants :
Pour plus d’informations sur cette propriété, consultez OneDrive Online Multi-Géo. 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é par défaut. Prend en charge $filter (eq , ne , not , ge , le , in , startsWith et 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 Timestamp 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é peut être définie uniquement dans le cadre de la création (POST). Pour obtenir la liste des valeurs possibles, consultez Comportements de groupe Microsoft 365 et options d’approvisionnement. |
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, consultez Comportements de groupe Microsoft 365 et options d’approvisionnement. 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. 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 d’un objet de groupe . Prend en charge $filter (eq , not , pour isResolved et serviceInstance). |
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 affecté à un groupe et utilisé comme clé de remplacement. 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. Renvoyé uniquement sur $select . |
unseenCount | Int32 | Nombre de conversations qui ont reçu les nouvelles publications depuis la dernière visite de l’utilisateur connecté dans le groupe. Renvoyé uniquement sur $select . Pris en charge uniquement par l'API Obtenir un groupe (GET /groups/{ID} ). |
visibility | String | Spécifie la stratégie d’adhésion au groupe et la visibilité du contenu des groupes. Les valeurs possibles sont les suivantes : Private , Public ou HiddenMembership . HiddenMembership peut être défini uniquement pour les groupes Microsoft 365 lors de la création des groupes. 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 Options de visibilité de groupe. Renvoyée par défaut. Pouvant accepter la valeur Null. |
Options de visibilité de groupe
Valeur | Description |
---|---|
Public | Tout le monde peut rejoindre le groupe sans avoir besoin d’autorisations de propriété. Tout le monde peut afficher les attributs du groupe. Tout le monde peut voir les membres du groupe. |
Private | Les autorisations de propriété sont nécessaires pour rejoindre le groupe. Tout le monde peut afficher les attributs du groupe. Tout le monde peut voir les membres du groupe. |
Hiddenmembership | Les autorisations de propriété sont nécessaires pour rejoindre le groupe. Les utilisateurs invités ne peuvent pas afficher les attributs du groupe. Tout le monde peut voir les membres du groupe. Ce paramètre n’affecte pas la visibilité des propriétaires de 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 publications 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 sont autorisés à 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 relation n’est pas définie si l’utilisateur est 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. |
événements | collection event | Événements de calendrier du groupe. |
extensions | collection extension | Collection d’extensions ouvertes définies 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 | Groupes dont ce groupe 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 | Les membres de ce 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 d’objets user | Liste des membres du groupe avec des erreurs de licence à partir de cette attribution des licences basée sur le groupe. En lecture seule. |
OneNote | Onenote | En lecture seule. |
owners | collection directoryObject | Propriétaires du groupe. 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 est automatiquement affecté en tant que propriétaire du groupe. Prend en charge $filter (/$count eq 0 , /$count ne 0 , /$count eq 1 , /$count ne 1 ). Prend en charge $expand ainsi que les $select imbriqués. Par exemple : /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName) . |
Photo | profilePhoto | Photo de profil du groupe |
photos | Collection profilePhoto | Photos de profil appartenant au groupe. En lecture seule. Pouvant accepter la valeur Null. |
planner | plannerGroup | Point d’entrée dans une ressource Planner pouvant exister pour un groupe unifié. |
rejectedSenders | collection directoryObject | Liste des utilisateurs ou groupes non autorisés à créer des publications ou des événements de calendrier dans ce groupe. Peut accepter la valeur Null |
paramètres | Collection de groupSettings | 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 de 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 | Groupes dont un groupe est membre, directement ou par le biais de l’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
Voici une représentation JSON de la ressource.
{
"allowExternalSenders": false,
"acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
"autoSubscribeNewMembers": true,
"calendar": { "@odata.type": "microsoft.graph.calendar" },
"calendarView": [{ "@odata.type": "microsoft.graph.event" }],
"classification": "String",
"conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
"createdDateTime": "String (timestamp)",
"createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
"description": "String",
"displayName": "String",
"drive": { "@odata.type": "microsoft.graph.drive" },
"events": [{ "@odata.type": "microsoft.graph.event" }],
"groupTypes": ["String"],
"hasMembersWithLicenseErrors": "Boolean",
"hideFromAddressLists": false,
"hideFromOutlookClients": false,
"id": "String (identifier)",
"isAssignableRole": false,
"isSubscribedByMail": true,
"licenseProcessingState": "String",
"mail": "String",
"mailEnabled": true,
"mailNickname": "String",
"memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesProvisioningErrors": [
{ "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
],
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
"owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"preferredDataLocation": "String",
"proxyAddresses": ["String"],
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
"rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"renewedDateTime": "String (timestamp)",
"resourceBehaviorOptions": ["String"],
"resourceProvisioningOptions": ["String"],
"securityEnabled": true,
"securityIdentifier": "String",
"serviceProvisioningErrors": [
{ "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
],
"sites": [{ "@odata.type": "microsoft.graph.site" }],
"threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
"uniqueName": "String",
"unseenCount": 1024,
"visibility": "String"
}
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour