Type de ressource extensionProperty (extensions d’annuaire)
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 n’importe quelle ressource Azure AD 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 (déconseillé) et les données personnalisées synchronisées à partir de Active Directory local à l’aide d’Azure AD 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
- 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.
- 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 | Chaîne | 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. Ne pouvant accepter la valeur null.
|
| 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 d’Azure AD Connect. En lecture seule. |
| name | Chaîne | Nom de la propriété d’extension. Ne pouvant accepter la valeur null. Prend en charge $filter (eq). |
| targetObjects | String collection | Les valeurs suivantes sont prises en charge. Ne peut pas accepter une valeur null.
|
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",
"name": "String",
"targetObjects": [
"String"
]
}