synchronizationSchema-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 .

Definiert, welche Objekte synchronisiert werden und wie sie synchronisiert werden. Das Synchronisierungsschema enthält die meisten Setupinformationen für einen bestimmten Synchronisierungsauftrag. In der Regel passen Sie einige Derattributzuordnungen an oder fügen einen Filter zum Festlegen des Zielwerts hinzu, um nur Objekte zu synchronisieren, die eine bestimmte Bedingung erfüllen.

In den folgenden Abschnitten werden die Hauptkomponenten des Synchronisierungsschemas beschrieben.

Verzeichnisdefinitionen

Verzeichnisdefinitionen enthalten informationen zum Synchronisierungsmodul zu Verzeichnissen und deren Objekten. Beispielsweise teilt die Verzeichnisdefinition dem Synchronisierungsmodul mit, dass ein Azure AD-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 ein bestimmtes Objekt und Attribut in Synchronisierungsregeln/Objektzuordnungen verwendet werden kann, müssen sie als Teil der Verzeichnisdefinition definiert werden.

Synchronisierungsregeln

Synchronisierungsregeln sind der Kern des Synchronisierungsaufbaus. Sie definieren für das Synchronisierungsmodul, wie die Synchronisierung ausgeführt werden soll, einschließlich der objekte synchronisiert werden soll, wie Objekte aus dem Quellverzeichnis mit Objekten im Zielverzeichnis übereinstimmen und wie Attribute transformiert werden sollen, wenn sie aus der Quelle mit dem Zielverzeichnis synchronisiert werden.

Objektzuordnungen

Objektzuordnungen sind der Hauptteil der Synchronisierungsregel. Jede Objektzuordnung definiert, wie ein bestimmtes Objekt aus der Quelle mit dem Zielverzeichnis synchronisiert werden soll. Die Zuordnung definiert insbesondere, wie ein Objekt im Quellverzeichnis mit einem Objekt im Zielverzeichnis übereinstimmen soll, welche (falls vorhandenen) Bereichfilter verwendet werden sollten, um zu entscheiden, ob ein Objekt bereitgestellt werden soll und wie Objektattribute transformiert werden sollen, wenn sie von der Quelle mit dem Zielverzeichnis synchronisiert werden.

Methoden

Methode	Rückgabetyp	Beschreibung
Schema abrufen	synchronizationSchema	Liest die Eigenschaften und Beziehungen des synchronizationSchema-Objekts.
Schema aktualisieren	Keine	Aktualisieren Sie das Synchronisierungsschema.
Schema löschen	Keine	Löschen Sie das angepasste Schema, und zurücksetzen Sie das Schema auf die Standardkonfiguration.
Listenfilteroperatoren	filterOperatorSchema -Auflistung	Listet alle Operatoren auf, die in den Suchfiltern unterstützt werden.
Funktionen für die Attributzuordnung auflisten	attributeMappingFunctionSchema-Auflistung	Listet alle Funktionen auf, die in den Attributzuordnungsausdrücken unterstützt werden.
Analyseattributzuordnungsausdruck	parseExpressionResponse	Analysieren eines Zeichenfolgenausdrucks in ein attributeMappingSource-Objekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Eindeutiger Bezeichner für das Schema.
synchronizationRules	synchronizationRule-Sammlung	Eine Sammlung von Synchronisierungsregeln, die für den synchronizationJob oder synchronizationTemplate konfiguriert sind.
Version	String	Die Version des Schemas, die automatisch mit jeder Schemaänderung aktualisiert wird.

Beziehungen

Beziehung	Typ	Beschreibung
Verzeichnisse	directoryDefinition collection	Enthält die Auflistung der Verzeichnisse und aller ihrer Objekte.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.synchronizationSchema",
  "id": "String (identifier)",
  "synchronizationRules": [
    {
      "@odata.type": "microsoft.graph.synchronizationRule"
    }
  ],
  "version": "String"
}