Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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"
}