synchronizationRule-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, wie die Synchronisierung für die Synchronisierungs-Engine ausgeführt werden soll, einschließlich der zu synchronisierenden Objekte und in welche Richtung, wie Objekte aus dem Quellverzeichnis mit Objekten im Zielverzeichnis abgeglichen werden sollen und wie Attribute transformiert werden sollen, wenn sie von der Quelle mit dem Zielverzeichnis synchronisiert werden.

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

Synchronisierungsregeln werden als Teil des Synchronisierungsschemas aktualisiert.

Eigenschaften

Eigenschaft	Typ	Beschreibung
containerFilter	containerFilter	Die Namen und Bezeichner von Organisationseinheiten, die sich im Bereich einer Synchronisierungsregel befinden. containerFilter und groupFilter schließen sich gegenseitig aus, die in derselben Anforderung nicht konfiguriert werden können. Derzeit nur für Azure AD Connect-Cloudsynchronisierungsszenarien unterstützt.
Bearbeitbaren	Boolesch	true , wenn die Synchronisierungsregel angepasst werden kann; false , wenn diese Regel schreibgeschützt ist und nicht geändert werden soll.
groupFilter	groupFilter	Die Namen und Bezeichner von Gruppen, die sich im Bereich einer Synchronisierungsregel befinden. containerFilter und groupFilter schließen sich gegenseitig aus, die in derselben Anforderung nicht konfiguriert werden können. Derzeit nur für Azure AD Connect-Cloudsynchronisierungsszenarien unterstützt.
id	String	Synchronisierungsregelbezeichner. Muss einer der vom Synchronisierungsmodul erkannten Bezeichner sein. Unterstützte Regelbezeichner finden Sie in der von der API zurückgegebenen Synchronisierungsvorlage.
Metadaten	stringKeyStringValuePair-Auflistung	Zusätzliche Erweiterungseigenschaften. Metadatenwerte sollten nicht geändert werden, es sei denn, es wird explizit vom Supportteam angewiesen.
name	String	Lesbarer Name der Synchronisierungsregel. Lässt keine NULL-Werte zu.
objectMappings	objectMapping-Auflistung	Auflistung von Objektzuordnungen, die von der Regel unterstützt werden. Teilt der Synchronisierungs-Engine mit, welche Objekte synchronisiert werden sollen.
priority	Ganze Zahl	Priorität relativ zu anderen Regeln im synchronizationSchema. Regeln mit der niedrigsten Priorität werden zuerst verarbeitet.
Sourcedirectoryname	String	Name des Quellverzeichnisses. Muss mit einer der Verzeichnisdefinitionen in synchronizationSchema übereinstimmen.
targetDirectoryName	String	Name des Zielverzeichnisses. Muss mit einer der Verzeichnisdefinitionen in synchronizationSchema übereinstimmen.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt 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"
}