type de ressource directoryRole
Espace de noms: microsoft.graph
Représente un rôle d’annuaire Microsoft Entra. Microsoft Entra rôles d’annuaire sont également appelés rôles d’administrateur. Pour plus d’informations sur les rôles d’annuaire (administrateur), consultez Attribution de rôles d’administrateur Microsoft Entra. Avec Microsoft Graph, vous pouvez attribuer des utilisateurs à des rôles d’annuaire pour leur accorder des autorisations du rôle cible. Pour lire un rôle d’annuaire ou mettre à jour ses membres, vous devez d’abord l’activer dans le client. Seuls les administrateurs de l’entreprise sont activés par défaut. Pour activer d’autres rôles d’annuaire disponibles, vous envoyez une requête POST avec l’ID de l’élément directoryRoleTemplate sur lequel est basé le rôle d’annuaire. Dressez la liste des modèles de rôles d’annuaire pour obtenir tous les autres rôles d’annuaire disponibles. Hérite de directoryObject.
Cette ressource prend en charge les fonctions suivantes :
- 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 |
---|---|---|
Obtenir un rôle d’annuaire | directoryRole | Lisez les propriétés et les relations de l’objet directoryRole. |
Répertorier les rôles d’annuaire | Collection d’objets directoryRole | Répertorier les rôles d’annuaire qui sont activés dans le client. |
Ajouter un membre | directoryObject | Ajoutez un utilisateur au rôle d’annuaire en publiant dans la propriété de navigation des membres. |
Répertorier les membres | collection directoryObject | Obtenez les utilisateurs qui sont membres du rôle d’annuaire à partir de la propriété de navigation des membres. |
Supprimer un membre | directoryObject | Supprimer un utilisateur du rôle d’annuaire. |
Activer un rôle d’annuaire. | directoryRole | Activer un rôle d’annuaire. |
Lister les membres délimités | Collection d’objets scopedRoleMembership | Répertorier les membres de ce rôle d’annuaire qui sont limités aux unités administratives, via la collection de ressources scopedRoleMembership. |
Obtenir delta | Collection directoryRole | Obtenez les modifications incrémentielles de rôles d’annuaire. |
Propriétés
Propriété | Type | Description |
---|---|---|
description | Chaîne | Description pour le rôle d’annuaire. En lecture seule. Prend en charge $filter (eq ), $search , $select . |
displayName | Chaîne | Nom d’affichage pour le rôle d’annuaire. En lecture seule. Prend en charge $filter (eq ), $search , $select . |
id | String | Identificateur unique pour le rôle d’annuaire. Hérité de directoryObject. Clé, ne peut pas avoir la valeur Null, en lecture seule. Prend en charge $filter (eq ), $select . |
roleTemplateId | String |
id de l’élément directoryRoleTemplate sur lequel est basé ce rôle. La propriété doit être spécifiée lors de l’activation d’un rôle d’annuaire dans un client avec une opération POST. Une fois que le rôle d’annuaire a été activé, la propriété est en lecture seule. Prend en charge $filter (eq ), $select . |
Relations
Relation | Type | Description |
---|---|---|
members | collection directoryObject | Utilisateurs qui sont membres de ce rôle d’annuaire. Méthodes HTTP : GET, POST, DELETE. En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand . |
scopedMembers | Collection d’objets scopedRoleMembership | Membres de ce rôle d’annuaire qui sont limités aux unités administratives. En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"description": "string",
"displayName": "string",
"id": "string (identifier)",
"roleTemplateId": "string"
}