type de ressource administrativeUnit

  • Article

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 .

Une unité administrative fournit un conteneur conceptuel pour les objets d’annuaire d’utilisateurs, de groupes et d’appareils. Avec les 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. Pour plus d’informations sur les unités administratives, consultez Unités administratives dans Microsoft Entra ID.

Cette ressource est un type ouvert qui permet de transmettre d’autres propriétés.

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 Create une nouvelle 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 Aucun Supprimez l’objet administrativeUnit.
Obtenir delta administrativeUnit Obtenez les nouvelles administrativeUnits créées , mises à jour ou supprimées sans avoir à effectuer une lecture complète de l’ensemble de la collection de ressources.
Ajout d'un membre directoryObject Ajouter un membre (utilisateur ou groupe).
Liste des membres collection directoryObject Obtenez la liste des membres (utilisateur et groupe).
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.
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 Créer une définition d’extension de schéma, puis l’utiliser pour ajouter des données personnalisées à une ressource.

Remarque

Le point de terminaison d’URL pour appeler l’API administrativeUnits se trouve /administrativeUnits dans le point de beta terminaison, mais /directory/administrativeUnits dans le point de v1.0 terminaison.

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).
isMemberManagementRestricted Valeur booléenne true si les membres de cette unité administrative doivent être traités comme sensibles, ce qui nécessite des autorisations spécifiques pour gérer. La valeur par défaut est false. Utilisez cette propriété pour définir des unités administratives dont les rôles n’héritent pas des administrateurs au niveau du locataire, et la gestion des objets membres individuels est limitée aux administrateurs limités à une unité administrative de gestion restreinte. Immuable, donc ne peut pas être modifié ultérieurement.

Pour plus d’informations sur l’utilisation des unités administratives de gestion restreinte, consultez Unités administratives de gestion restreintes dans Microsoft Entra ID.
membershipRule Chaîne Règle d’appartenance dynamique pour l’unité administrative. Pour plus d’informations sur les règles que vous pouvez utiliser pour les unités administratives dynamiques et les groupes dynamiques, consultez Utilisation d’attributs pour créer des règles avancées.
membershipRuleProcessingState Chaîne Permet de contrôler si la règle d’appartenance dynamique est activement traitée. Définissez sur On lorsque vous souhaitez que la règle d’appartenance dynamique soit active et Paused si vous souhaitez arrêter la mise à jour dynamique de l’appartenance. S’il n’est pas défini, le comportement par défaut est Paused.
membershipType Chaîne Type d’appartenance pour l’unité administrative. Peut être dynamic ou assigned. S’il n’est pas défini, le comportement par défaut est assigned.
visibility String Contrôle si l’unité administrative et ses membres sont masqués ou publics. Peut être défini sur HiddenMembership ou Public. S’il n’est pas défini, 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
extensions collection extension Collection d’extensions ouvertes définies pour cette unité administrative. Peut avoir la valeur Null.
membres collection directoryObject Utilisateurs et groupes membres de cette unité administrative. Prend en charge $expand.
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",
  "membershipType": "String",
  "membershipRule": "String",
  "membershipRuleProcessingState": "String"
}

Contenu connexe