extensionProperty-Ressourcentyp
Namespace: microsoft.graph
Stellt eine Verzeichniserweiterung dar, die verwendet werden kann, um Verzeichnisobjekten eine benutzerdefinierte Eigenschaft hinzuzufügen, ohne dass ein externer Datenspeicher erforderlich ist. Wenn eine Organisation beispielsweise über eine Branchenanwendung verfügt, die eine Skype-ID für jeden Benutzer im Verzeichnis erfordert, kann Microsoft Graph verwendet werden, um eine neue Eigenschaft namens "skypeId " im Benutzerobjekt des Verzeichnisses zu registrieren und dann einen Wert für einen bestimmten Benutzer in die neue Eigenschaft zu schreiben.
Verzeichniserweiterungen können den folgenden Verzeichnisobjekten hinzugefügt werden:
Es können nur 100 Erweiterungswerte für alle Typen und Anwendungen in jede einzelne Azure AD-Ressource geschrieben werden.
Verwenden Sie diese Ressource und die zugehörigen Methoden, um die Verzeichniserweiterungsdefinitionen zu verwalten. Um die Verzeichniserweiterungsdaten in der erweiterten Ressourceninstanz zu verwalten, verwenden Sie dieselbe REST-Anforderung, die Sie zum Verwalten der Ressourceninstanz verwenden.
Weitere Informationen zur Erweiterbarkeit von Microsoft Graph finden Sie unter Hinzufügen von benutzerdefinierten Eigenschaften zu Ressourcen mithilfe von Erweiterungen.
Erbt von directoryObject.
Hinweis
Erweiterungen, die über Azure AD Graph erstellt wurden (veraltet) und von lokales Active Directory mithilfe von Azure AD Connect Sync synchronisierte benutzerdefinierte Daten werden als Verzeichniserweiterungen in Microsoft Graph dargestellt.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| extensionProperties erstellen | extensionProperty | Dient zum Erstellen einer Erweiterungseigenschaft für ein Application-Objekt. |
| extensionProperties auflisten | extensionProperty-Sammlung | Dient zum Auflisten von Erweiterungseigenschaften für ein Application-Objekt. |
| extensionProperty abrufen | extensionProperty-Sammlung | Dient zum Auflisten von Erweiterungseigenschaften für ein Application-Objekt. |
| extensionProperty löschen | Keine | Dient zum Löschen einer Erweiterungseigenschaft aus einem Application-Objekt. Sie können nur Eigenschaften löschen, die nicht aus dem lokalen Active Directory synchronisiert werden. |
Tipp
- Verwenden Sie den Aktualisierungsvorgang der Ressource, um einen Wert für die Erweiterungseigenschaft auf eine Instanz einer Ressource festzulegen, die in targetObjects angegeben ist. Beispielsweise die Benutzer-API aktualisieren, um den Wert für einen Benutzer festzulegen.
- Um die Erweiterungseigenschaft und ihren Wert aus einer Instanz einer Ressource zu entfernen, die in targetObjects angegeben ist, legen Sie den Wert der Erweiterungseigenschaft auf
null.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| appDisplayName | Zeichenfolge | Anzeigename des Anwendungsobjekts, für das diese Erweiterungseigenschaft definiert ist. Schreibgeschützt. |
| dataType | String | Gibt den Datentyp des Werts an, den die Erweiterungseigenschaft enthalten kann. Die folgenden Werte werden unterstützt. Lässt keine NULL-Werte zu.
|
| deletedDateTime | DateTimeOffset | Datum und Uhrzeit, zu der dieses Objekt gelöscht wurde. Immer null, wenn das Objekt nicht gelöscht wurde. Geerbt von directoryObject. |
| isSyncedFromOnPremises | Boolesch | Gibt an, ob diese Erweiterungseigenschaft mithilfe von Azure AD Connect aus dem lokalen Active Directory synchronisiert wurde. Schreibgeschützt. |
| name | Zeichenfolge | Name der Erweiterungseigenschaft. Lässt keine NULL-Werte zu. |
| targetObjects | String-Sammlung | Die folgenden Werte werden unterstützt. Lässt keine Nullwerte zu.
|
Beziehungen
Keine
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
{
"@odata.type": "#microsoft.graph.extensionProperty",
"id": "String (identifier)",
"deletedDateTime": "String (timestamp)",
"appDisplayName": "String",
"name": "String",
"dataType": "String",
"isSyncedFromOnPremises": "Boolean",
"targetObjects": [
"String"
]
}
Siehe auch
Feedback
Feedback senden und anzeigen für