Ressourcentyp "synchronizationRule"

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, wie die Synchronisierung für das Synchronisierungsmodul durchgeführt werden soll, einschließlich welche Objekte in welcher Richtung 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. Dieses Objekt wird in der Eigenschaft synchronizationRules von synchronizationSchema konfiguriert.

Hinweis: Synchronisationsregeln definieren die Synchronisation in eine Richtung – vom Quellverzeichnis zum Zielverzeichnis. Die Quell- und Zielverzeichnisse werden als Teil der Regeleigenschaften definiert.

Synchronisierungsregeln werden als Teil des Synchronisationsschemas aktualisiert.

Eigenschaften

Eigenschaft Typ Beschreibung
containerFilter containerFilter Die Namen und Bezeichner von Organisationseinheiten, die sich im Geltungsbereich einer Synchronisierungsregel befinden. containerFilter und groupFilter sind sich gegenseitig ausschließende Eigenschaften, die nicht in derselben Anforderung konfiguriert werden können. Derzeit nur für Azure AD Connect-Cloudsynchronisierungsszenarien unterstützt.
bearbeitbar Boolean true ob die Synchronisationsregel angepasst werden kann; false Diese Regel ist schreibgeschützt und sollte nicht geändert werden.
groupFilter groupFilter Die Namen und Bezeichner von Gruppen, die sich im Bereich einer Synchronisierungsregel befinden. containerFilter und groupFilter sind sich gegenseitig ausschließende Eigenschaften, die nicht in derselben Anforderung konfiguriert werden können. Derzeit nur für Azure AD Connect-Cloudsynchronisierungsszenarien unterstützt.
id Zeichenfolge Bezeichner der Synchronisierungsregel. Muss einer der vom Synchronisierungsmodul erkannten Bezeichner sein. Unterstützte Regelbezeichner finden Sie in der Synchronisierungsvorlage, die von der API zurückgegeben wird.
Metadaten stringKeyStringValuePair-Auflistung Zusätzliche Erweiterungseigenschaften. Metadatenwerte dürfen nicht geändert werden, es sei denn, das Supportteam hat ausdrücklich dazu aufgefordert.
name Zeichenfolge Lesbarer Name der Synchronisierungsregel. Lässt keine NULL-Werte zu.
objectMappings objectMapping-Sammlung Auflistung der von der Regel unterstützten Objektzuordnungen. Teilt dem Synchronisierungsmodul mit, welche Objekte synchronisiert werden sollen.
priority Integer Priorität relativ zu anderen Regeln im synchronizationSchema. Regeln mit der niedrigsten Prioritätsnummer werden zuerst verarbeitet.
sourceDirectoryName Zeichenfolge Name des Quellverzeichnisses. Muss mit einer der Verzeichnisdefinitionen im synchronizationSchema übereinstimmen.
targetDirectoryName Zeichenfolge Der Name des Zielverzeichnisses. Muss mit einer der Verzeichnisdefinitionen im synchronizationSchema übereinstimmen.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "containerFilter": {
    "@odata.type": "microsoft.graph.containerFilter"
  },
  "editable": true,
  "groupFilter": {
    "@odata.type": "microsoft.graph.groupFilter"
  },
  "id": "String",
  "metadata": [
    {
      "@odata.type": "microsoft.graph.stringKeyStringValuePair"
    }
  ],
  "name": "String",
  "objectMappings": [
    {
      "@odata.type": "microsoft.graph.objectMapping"
    }
  ],
  "priority": 1024,
  "sourceDirectoryName": "String",
  "targetDirectoryName": "String"
}