synchronizationSchema-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Definiert, welche Objekte synchronisiert werden und wie sie synchronisiert werden. Das Synchronisationsschema enthält die meisten Setupinformationen für einen bestimmten Synchronisationsjob. In der Regel passen Sie einige der Attributzuordnungen an oder fügen einen Bereichsfilter hinzu, um nur Objekte zu synchronisieren, die eine bestimmte Bedingung erfüllen.

In den folgenden Abschnitten werden die allgemeinen Komponenten des Synchronisationsschemas beschrieben. Weitere Informationen finden Sie unter Grundlegendes zum Microsoft Entra-Schema und zur Attributzuordnung – Active Directory zu Microsoft Entra ID.

Verzeichnisdefinitionen

Verzeichnisdefinitionen stellen dem Synchronisierungsmodul Informationen zu Verzeichnissen und ihren Objekten bereit. Beispielsweise teilt die Verzeichnisdefinition dem Synchronisierungsmodul mit, dass ein Microsoft Entra-Verzeichnis Objekte mit dem Namen "user" und "group" 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 Synchronisationsregeln/Objektzuordnungen verwendet werden kann, müssen sie als Teil der Verzeichnisdefinition definiert werden.

Synchronisierungsregeln

Synchronisierungsregeln sind das Herzstück der Synchronisierungseinrichtung. Sie definieren für das Synchronisierungsmodul, wie die Synchronisierung durchgeführt werden soll, einschließlich welche Objekte synchronisiert werden sollen, wie Objekte aus dem Quellverzeichnis mit Objekten im Zielverzeichnis abgeglichen werden sollen und wie Attribute transformiert werden sollen, wenn sie aus dem Quell- mit dem Zielverzeichnis synchronisiert werden.

Objektzuordnungen

Objektzuordnungen sind der Hauptbestandteil der Synchronisierungsregel. Jede Objektzuordnung definiert, wie ein bestimmtes Objekt vom Quell- mit dem Zielverzeichnis synchronisiert werden soll. Insbesondere definiert die Zuordnung, wie ein Objekt im Quellverzeichnis mit einem Objekt im Zielverzeichnis abgeglichen werden soll, welche (falls vorhanden) Bereichsfilter verwendet werden sollen, um zu entscheiden, ob ein Objekt bereitgestellt werden soll, und wie Objektattribute transformiert werden sollen, wenn sie vom Quell- mit dem Zielverzeichnis synchronisiert werden.

Methoden

Methode Rückgabetyp Beschreibung
Get synchronizationSchema Lesen Sie Eigenschaften und Beziehungen des synchronizationSchema-Objekts .
Update Keine Aktualisieren Sie das Synchronisierungsschema.
Reset Keine Löschen Sie das benutzerdefinierte Schema, und setzen Sie das Schema auf die Standardkonfiguration zurück.
Schemafilteroperatoren abrufen filterOperatorSchema-Auflistung Listen Sie alle Operatoren auf, die in den Bereichsfiltern unterstützt werden.
Schemafunktionen abrufen attributeMappingFunctionSchema-Auflistung Listen Sie alle Funktionen auf, die in den Attributzuordnungsausdrücken unterstützt werden.
Analysieren eines Attributzuordnungsausdrucks parseExpressionResponse Analysieren Sie einen Zeichenfolgenausdruck in ein attributeMappingSource-Objekt .

Eigenschaften

Eigenschaft Typ Beschreibung
id Zeichenfolge Eindeutiger Bezeichner für das Schema.
synchronizationRules synchronizationRule collection Eine Auflistung von Synchronisationsregeln, die für synchronizationJob oder synchronizationTemplate konfiguriert sind.
Version Zeichenfolge Die Version des Schemas, die bei jeder Schemaänderung automatisch aktualisiert wird.

Beziehungen

Beziehung Typ Beschreibung
Verzeichnisse directoryDefinition collection Enthält die Sammlung von Verzeichnissen und all ihren Objekten.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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