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

Führt eine Synchronisierung durch, indem regelmäßig im Hintergrund ausgeführt wird, Änderungen in einem Verzeichnis abruft und in ein anderes Verzeichnis kopiert wird. Der Synchronisierungsauftrag ist immer spezifisch für eine bestimmte Instanz einer Anwendung in Ihrem Mandanten. Im Rahmen der Einrichtung des Synchronisierungsauftrags müssen Sie die Autorisierung zum Lesen und Schreiben von Objekten in Ihrem Zielverzeichnis geben und das Synchronisierungsschema des Auftrags anpassen.

Methoden

Methode	Rückgabetyp	Beschreibung
List	synchronizationJob-Sammlung	Auflisten vorhandener Aufträge für eine bestimmte Anwendungsinstanz (Dienstprinzipal).
synchronizationJob erhalten	synchronizationJob	Liest die Eigenschaften und Beziehungen eines synchronizationJob-Objekts.
Create	synchronizationJob	Erstellen sie einen neuen Auftrag für eine bestimmte Anwendung.
Start	Keine	Starten Sie die Synchronisierung. Wenn sich der Auftrag in einem angehaltenen Zustand befindet, wird er ab dem Punkt fortgesetzt, an dem der Auftrag angehalten wurde. Wenn sich der Auftrag in Quarantäne befindet, wird der Quarantänestatus entfernt.
Restart	Keine	Erzwingen Sie, dass der Auftrag von vorn beginnt, und verarbeiten Sie alle Objekte im Verzeichnis erneut.
Pause	Keine	Beenden Sie die Synchronisierung vorübergehend. Der fortschritt, einschließlich des Auftragsstatus, wird beibehalten, und der Auftrag wird an der Stelle fortgesetzt, an der er bei einem Startaufruf aufbließ.
Delete	Keine	Beenden Sie die Synchronisierung, und löschen Sie den status, der dem Auftrag zugeordnet ist, endgültig.
synchronizationSchema erhalten	synchronizationSchema	Rufen Sie das effektive Synchronisierungsschema des Auftrags ab.
synchronizationSchema aktualisieren	Keine	Aktualisieren Sie das Synchronisierungsschema des Auftrags.
Überprüfen von Anmeldeinformationen	Keine	Testen Sie die bereitgestellten Anmeldeinformationen für das Zielverzeichnis.
provisionOnDemand	synchronizationJobApplicationParameters-Sammlung	Stellt die Objekte dar, die bereitgestellt und die Synchronisierungsregeln ausgeführt werden. Die Ressource wird in erster Linie für die Bedarfsbereitstellung verwendet.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Eindeutige Synchronisierungsauftrags-ID. Schreibgeschützt.
Zeitplan	synchronizationSchedule	Zum Ausführen des Auftrags verwendeter Zeitplan. Schreibgeschützt.
status	synchronizationStatus	Status des Auftrags, der die letzte Ausführung des Auftrags, den aktuellen Auftragsstatus und Fehler enthält.
synchronizationJobSettings	keyValuePair	Einstellungen, die dem Auftrag zugeordnet sind. Einige Einstellungen werden von der Vorlage geerbt.
templateId	Zeichenfolge	Der Bezeichner der Synchronisierungsvorlage, auf der dieser Auftrag basiert.

Beziehungen

Beziehung	Typ	Beschreibung
Schema	synchronizationSchema	Das für den Auftrag konfigurierte Synchronisierungsschema.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "id": "String (identifier)",
  "schedule": {"@odata.type": "microsoft.graph.synchronizationSchedule"},
  "status": {"@odata.type": "microsoft.graph.synchronizationStatus"},
  "synchronizationJobSettings": {"@odata.type": "microsoft.graph.keyValuePair"},
  "templateId": "String"
}