type de ressource administrativeUnit

  • Article

Espace de noms: microsoft.graph

Une unité administrative fournit un conteneur conceptuel pour les objets d’annuaire d’utilisateurs, de groupes et d’appareils. À l’aide d’unités administratives, un administrateur d’entreprise peut désormais déléguer des responsabilités administratives pour gérer les utilisateurs, les groupes et les appareils contenus dans ou limités à une unité administrative à un administrateur régional ou départemental. Cette ressource est un type ouvert qui permet de transmettre d’autres propriétés.

Prenons un exemple. Imaginez que Contoso Corp se compose de deux divisions : une division de la côte Ouest et une division de la côte Est. Les rôles d’annuaire sur Contoso sont étendus à l’ensemble du locataire. Lee, administrateur de société Contoso, souhaite déléguer des responsabilités administratives, mais les étendre à la division de la côte Ouest ou de la côte Est. Lee peut créer une unité administrative de la côte Ouest et placer tous les utilisateurs de la côte Ouest dans cette unité administrative. De même, Lee peut créer une unité administrative de la côte Est. Désormais, Lee, peut commencer à déléguer des responsabilités administratives à d’autres personnes, mais étendue aux nouvelles unités administratives qu’ils ont créées . Lee place Jennifer dans un rôle d’administrateur de support technique étendu à l’unité administrative de la côte Ouest. Cela permet à Jennifer de réinitialiser le mot de passe d’un utilisateur, mais uniquement si ces utilisateurs se trouvent dans l’unité administrative de la côte Ouest. De même, Lee place Dave dans un rôle d’administrateur de compte d’utilisateurétendu à l’unité administrative de la côte Est. Cela permet à Dave de mettre à jour les utilisateurs, d’attribuer des licences et de réinitialiser le mot de passe d’un utilisateur, mais uniquement si ces utilisateurs se trouvent dans l’unité administrative de la côte Est. Pour obtenir une vue d’ensemble de la vidéo, consultez Présentation des unités administratives Microsoft Entra.

Cette ressource prend en charge les fonctions suivantes :

  • Ajout de vos propres données aux propriétés personnalisées à l’aide des extensions.
  • 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
Créer administrativeUnit Créez une unité administrative.
List collection administrativeUnit Répertorie les propriétés de toutes les administrativeUnits.
Obtenir administrativeUnit Lit les propriétés et les relations d’un objet administrativeUnit spécifique.
Mettre à jour administrativeUnit Mettez à jour l’objet administrativeUnit.
Supprimer Aucune Supprimez l’objet administrativeUnit.
Ajout d'un membre directoryObject Ajoutez un membre (utilisateur, groupe ou appareil).
Liste des membres collection directoryObject Obtenez la liste des membres (utilisateur, groupe ou appareil).
Obtenir un membre directoryObject Obtenir un membre spécifique.
Supprimer un membre directoryObject Supprimer un membre.
Ajouter un scopedRoleMember scopedRoleMembership Attribuez un rôle Microsoft Entra avec l’étendue de l’unité administrative.
Lister scopedRoleMembers Collection d’objets scopedRoleMembership Répertoriez Microsoft Entra attributions de rôles avec l’étendue de l’unité administrative.
Obtenir un scopedRoleMember scopedRoleMembership Obtenez une attribution de rôle Microsoft Entra avec l’étendue de l’unité administrative.
Supprimer un scopedRoleMember scopedRoleMembership Supprimez une attribution de rôle Microsoft Entra avec l’étendue de l’unité administrative.

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
description Chaîne Description facultative de l’unité administrative. Prend en charge $filter (eq, ne, in, startsWith), $search.
displayName Chaîne Nom d’affichage de l’unité administrative. Prend en charge $filter (eq, ne, not, ge, le, in, startsWithet eq sur null valeurs), $searchet $orderby.
id Chaîne Identificateur unique de l’unité administrative. En lecture seule. Prend en charge $filter (eq).
visibility String Contrôle si l’unité administrative et ses membres sont masqués ou publics. Peut être défini sur HiddenMembership. S’il n’est pas défini (la valeur est null), le comportement par défaut est public. Lorsqu’il HiddenMembershipest défini sur , seuls les membres de l’unité administrative peuvent répertorier les autres membres de l’unité administrative.

Conseil

Les extensions d’annuaire et les données associées sont retournées par défaut, tandis que les extensions de schéma et les données associées sont retournées uniquement sur $select.

Relations

Relation Type Description
members collection directoryObject Utilisateurs et groupes membres de cette unité administrative. Prend en charge $expand.
extensions collection extension Collection d’extensions ouvertes définies pour cette unité administrative. Pouvant accepter la valeur Null.
scopedRoleMembers Collection d’objets scopedRoleMembership Membres de rôle délimités de cette unité administrative.

Représentation JSON

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

{
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "visibility": "String"
}

Contenu connexe