Type de ressource extensionProperty (extensions d’annuaire)

  • Article

Espace de noms: microsoft.graph

Représente une extension de répertoire qui peut être utilisée pour ajouter une propriété personnalisée aux objets d’annuaire sans nécessiter de magasin de données externe. Par exemple, si une organization a une application métier qui nécessite un ID Skype pour chaque utilisateur de l’annuaire, Microsoft Graph peut être utilisé pour inscrire une nouvelle propriété nommée skypeId sur l’objet Utilisateur de l’annuaire, puis écrire une valeur dans la nouvelle propriété pour un utilisateur spécifique. Les extensions d’annuaire peuvent également être disponibles dans les applications multilocataires qui ont été autorisées dans le locataire.

Les extensions d’annuaire peuvent être ajoutées aux objets d’annuaire suivants :

Seules 100 valeurs d’extension, sur tous les types et toutes les applications, peuvent être écrites dans une ressource Microsoft Entra unique.

Utilisez cette ressource et les méthodes associées pour gérer les définitions d’extension de répertoire. Pour gérer les données d’extension d’annuaire sur la ressource étendue instance, utilisez la même requête REST que celle que vous utilisez pour gérer la ressource instance.

Pour plus d’informations sur l’extensibilité de Microsoft Graph, consultez Ajouter des propriétés personnalisées aux ressources à l’aide d’extensions.

Hérite de directoryObject.

Remarque

Les extensions créées via Azure AD Graph (actuellement dans son cycle de mise hors service) et les données personnalisées synchronisées à partir de Active Directory local à l’aide de Microsoft Entra Connect Sync sont représentées sous forme d’extensions d’annuaire dans Microsoft Graph.

Méthodes

Méthode Type renvoyé Description
Créer extensionProperties extensionProperty Créez une extension d’annuaire sur un objet d’application.
Liste extensionProperties collection extensionProperty Répertorier les extensions d’annuaire sur un objet d’application.
Obtenir extensionProperty collection extensionProperty Obtenir une extension d’annuaire d’un objet d’application.
Supprimer extensionProperty Aucun Supprimer l’extension d’annuaire d’un objet d’application. Vous pouvez supprimer uniquement les extensions d’annuaire qui ne sont pas synchronisées à partir d’Active Directory local.
Obtenir les extensions disponibles collection extensionProperty Retourne toutes les définitions d’extension d’annuaire qui ont été inscrites dans un annuaire, y compris via des applications multilocataires.

Conseil

  1. Pour définir une valeur pour la propriété d’extension sur une instance d’une ressource spécifiée dans targetObjects, utilisez l’opération Update de la ressource. Par exemple, l’API Mettre à jour l’utilisateur pour définir la valeur d’un utilisateur.
  2. Pour supprimer la propriété d’extension et sa valeur d’un instance d’une ressource spécifiée dans targetObjects, définissez la valeur de la propriété d’extension sur null.

Propriétés

Propriété Type Description
appDisplayName String Nom d’affichage de l’objet d’application sur lequel cette propriété d’extension est définie. En lecture seule.
dataType String Spécifie le type de données de la valeur que la propriété d’extension peut contenir. Les valeurs suivantes sont prises en charge.
  • Binary - 256 octets maximum
  • Boolean
  • DateTime - Doit être spécifié au format ISO 8601. Conservées au format UTC.
  • Integer - Valeur 32 bits.
  • LargeInteger - Valeur 64 bits.
  • String - 256 caractères maximum
Ne pouvant accepter la valeur null. Pour les extensions de répertoire à plusieurs valeurs, ces limites s’appliquent par valeur dans la collection.
deletedDateTime DateTimeOffset Date et heure de suppression de cet objet. Toujours null lorsque l’objet n’a pas été supprimé. Hérité de directoryObject.
isSyncedFromOnPremises Boolean Indique si cette propriété d’extension a été synchronisée à partir d’Active Directory local à l’aide de Microsoft Entra Connect. En lecture seule.
name String Nom de la propriété d’extension. Ne pouvant accepter la valeur null. Prend en charge $filter (eq).
isMultiValued Boolean Définit l’extension de répertoire en tant que propriété à valeurs multiples. Quand truela valeur est , la propriété d’extension d’annuaire peut stocker une collection d’objets du dataType ; par exemple, une collection de types de chaînes telles que "extension_b7b1c57b532f40b8b5ed4b7a7ba67401_jobGroupTracker": ["String 1", "String 2"]. La valeur par défaut est false. Prend en charge $filter (eq).
targetObjects Collection de chaînes Les valeurs suivantes sont prises en charge. Ne peut pas accepter une valeur null.
  • User
  • Group
  • AdministrativeUnit
  • Application
  • Device
  • Organization

Relations

Aucun

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "@odata.type": "#microsoft.graph.extensionProperty",
  "appDisplayName": "String",
  "dataType": "String",
  "deletedDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "isSyncedFromOnPremises": "Boolean",
  "isMultiValued": "Boolean",
  "name": "String",
  "targetObjects": [
    "String"
  ]
}

Contenu connexe