directoryDefinition-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt das Synchronisierungsmodul Informationen zu einem Verzeichnis und seinen Objekten zur Verfügung. Diese Ressource teilt dem Synchronisierungsmodul beispielsweise mit, dass das Verzeichnis Objekte mit dem Namen Benutzer und Gruppe enthält, welche Attribute für diese Objekte unterstützt werden und welche Typen für diese Attribute verwendet werden. Damit das Objekt und das Attribut an Synchronisierungsregeln und Objektzuordnungen teilnehmen können,müssen sie als Teil der Verzeichnisdefinition definiert werden.

Im Allgemeinen definiert das standardmäßige Synchronisierungsschema, das als Teil der Synchronisierungsvorlage bereitgestellt wird, am häufigsten verwendete Objekte und Attribute für dieses Verzeichnis. Wenn das Verzeichnis jedoch das Hinzufügen von benutzerdefinierten Attributen unterstützt, können Sie die Standarddefinition mit Ihren eigenen benutzerdefinierten Objekten oder Attributen erweitern. Weitere Informationen finden Sie unter Konfigurieren der Synchronisierung mit benutzerdefinierten Attributen und Konfigurieren der Synchronisierung mit Verzeichniserweiterungsattributen.

Verzeichnisdefinitionen werden im Rahmen des Synchronisierungsschemas aktualisiert.

Methoden

Methode	Rückgabetyp	Beschreibung
Discover directoryDefinition	directoryDefinition	Ermitteln Sie das Schema und die unterstützten Eigenschaften des Verzeichnisses.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	String	Verzeichnis-ID. Lässt keine Nullwerte zu.
Metadaten	metadataEntry-Auflistung	Zusätzliche Erweiterungseigenschaften. Sofern nicht explizit erwähnt, sollten Metadatenwerte nicht geändert werden.
name	String	Name des Verzeichnisses. Muss innerhalb des Synchronisierungsschemas eindeutig sein. Lässt keine Nullwerte zu.
objekte	objectDefinition-Auflistung	Auflistung von Objekten, die vom Verzeichnis unterstützt werden.
Version	String	Schreibgeschützter Wert, der die ermittelte Version angibt. null wenn die Ermittlung noch nicht erfolgt ist.
discoveryDateTime	DateTimeOffset	Stellt das Datum und die Uhrzeit der Ermittlung im ISO 8601-Format dar und befindet sich immer in UTC-Zeit. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
discoverabilities	directoryDefinitionDiscoverabilities	Schreibgeschützter Wert, der angibt, welche Art von Ermittlung von der App unterstützt wird. Mögliche Werte sind: AttributeDataTypes, AttributeNames, AttributeReadOnly, None, ReferenceAttributes und UnknownFutureValue.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "discoverabilities": "String",
  "discoveryDateTime": "DateTimeOffset",
  "id": "String",
  "metadata": [{"@odata.type": "microsoft.graph.stringKeyStringValuePair"}],
  "name": "String",
  "objects": [{"@odata.type": "microsoft.graph.objectDefinition"}],
  "version": "String"
}