Sie können mit dem Befehl sync-cmd und Google Cloud Directory Sync (GCDS) Synchronisierungen über die Befehlszeile ausführen.
Wann Sie über die Befehlszeile synchronisieren sollten
Wenn Sie Ihre Konfiguration einrichten oder ändern, sollten Sie über den Konfigurationsmanager eine manuelle Synchronisierung ausführen. So können Sie die synchronisierten Daten auf ihre Richtigkeit überprüfen. Weitere Informationen finden Sie unter Manuelle Synchronisierung durchführen.
Nachdem Sie die Änderungen an Ihrer Konfiguration abgeschlossen haben, können Sie den Synchronisierungsvorgang über die Befehlszeile automatisieren. Sie können Synchronisierungen in jede Planung oder jedes Stapel-Skript einbeziehen. Alternativ können Sie Synchronisierungen mit einem Drittanbietertool automatisieren. Weitere Informationen finden Sie unter Automatische Synchronisierungen planen.
Migration über die Befehlszeile
Führen Sie den Befehl sync-cmd aus dem GCDS-Installationsverzeichnis aus und geben Sie ihn einzeilig ein. Mit den unten aufgeführten Argumenten können Sie dem Befehl verschiedene Aktionen hinzufügen:
- Alle erkannten Änderungen werden übernommen.
- Eine bestimmte Datei lesen
- Detailebene für Logging festlegen
Tipp: Wenn Sie sync-cmd -h eingeben, werden Ihnen Informationen zu den verfügbaren Befehlsargumenten angezeigt.
Befehlsargumente und Beispiele
Alle maximieren | Alle minimieren und nach oben
Befehlsargumente| Argument (eine der beiden Optionen verwenden) | Beschreibung |
|---|---|
-a |
Alle erkannten Änderungen werden angewendet.
Hinweis: Ohne dieses Argument wird die Synchronisierung nur zu Testzwecken durchgeführt und es werden keine Änderungen an Ihrem Google-Konto vorgenommen. Die besten Ergebnisse erzielen Sie, wenn Sie eine Testsynchronisierung ohne dieses Argument ausführen, bevor Sie eine vollständige Synchronisierung mit diesem Argument durchführen. |
-c |
Legt die zu ladende XML-Konfigurationsdatei fest.
Wichtig: Sie müssen mit diesem Argument eine gültige XML-Datei hinzufügen. Weitere Informationen finden Sie im Hilfeartikel Konfigurationsdateien verwenden. |
-cs |
Schließt benutzerdefinierte Schemas aus.
Verwenden Sie diese Option, wenn Sie nicht möchten, dass benutzerdefinierte Schemadaten für Nutzer synchronisiert werden. |
-d |
Die konfigurierten Löschlimits werden ignoriert. |
-f |
Löscht die im Cache gespeicherte Kopie Ihrer Google-Kontodaten, bevor die Synchronisierung ausgeführt wird.
Wichtig: Eine unsachgemäße Verwendung kann zu Leistungseinbußen führen. Verwenden Sie diese Option nur, wenn Sie vom Support dazu angewiesen werden. |
-g |
Gruppen werden ausgeschlossen.
Verwenden Sie diese Option, wenn Sie Nutzer, aber keine Gruppen synchronisieren möchten. |
-h |
Zeigt Hilfeinformationen und Möglichkeiten zur Beendigung an. |
-l |
Standardmäßige oder konfigurierte Protokollebene mit einem angegebenen Wert wird überschrieben. Gültige Werte (mit zunehmend mehr Details) sind FATAL, ERROR, WARN, INFO, DEBUG und TRACE.
In den meisten Fällen empfehlen wir, die Protokollebene auf INFO zu setzen. |
-lic |
Schließt Lizenzen aus.
Verwenden Sie diese Option, wenn Sie nicht möchten, dass Lizenzdaten von Nutzern synchronisiert werden. |
-o |
Beschränkt alle laufenden Synchronisierungen auf eine einzelne Instanz pro XML-Konfigurationsdatei. Dies verhindert, dass ungewollt mehrere Instanzen ausgeführt werden (z. B. durch einen Planer oder Cronjob). Das Argument ist nur mit dem Argument Weitere Informationen zur Fehlerbehebung finden Sie unter Warum führt GCDS keine Synchronisierung über die Befehlszeile aus? |
-ou |
Schließt Organisationseinheiten aus. |
-r |
Gibt neben dem Protokoll auch Berichte in eine angegebene Ausgabedatei aus. |
-s |
Schließt freigegebene Kontakte aus. |
-u |
Schließt Nutzer aus.
Verwenden Sie diese Option, wenn Sie zwar Gruppen synchronisieren möchten, jedoch keine Nutzer. |
-v |
Zeigt Kurzinformationen zur Anwendungsversion an. |
-V |
Zeigt detaillierte Informationen zur Anwendungsversion an, synchronisiert sie jedoch nicht. |
Windows
Beispiel 1: Führen Sie eine simulierte Synchronisierung mit der XML-Konfigurationsdatei C:\Nutzer\Nutzer\gdcs-config.xml aus:
sync-cmd -c C:\Nutzer\Nutzer\gdcs-config.xml
Beispiel 2: Führen Sie eine vollständige Synchronisierung einschließlich Anwendung aller erkannten Änderungen mit der XML-Konfigurationsdatei C:\Nutzer\Nutzer\gdcs-config.xml aus:
sync-cmd -a -c C:\Nutzer\Nutzer\gdcs-config.xml
Linux
Beispiel 1: Führen Sie eine simulierte Synchronisierung mit der XML-Konfigurationsdatei /path/gcds-config.xml aus:
sync-cmd -c /path/gcds-config.xml
Beispiel 2: Führen Sie eine vollständige Synchronisierung einschließlich Anwendung von Änderungen mit der XML-Konfigurationsdatei /path/gcds-config.xml aus:
sync-cmd -a -c /path/gcds-config.xml
Exit-Code überprüfen
Nachdem Sie die Synchronisierung oder Simulation über die Befehlszeile ausgeführt haben, erhalten Sie einen der folgenden Exit-Codes:
- 0: Die Synchronisierung wurde ohne Probleme abgeschlossen und die Änderungen überschreiten nicht die konfigurierten Limits.
- 255: Simulation abgeschlossen. Oder die Synchronisierung ist abgeschlossen und es liegen Probleme mit der Synchronisierung vor, z. B. Änderungen, die die konfigurierten Limits überschreiten, oder Nutzer konnten nicht synchronisiert werden.
Nächster Schritt
Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der Unternehmen, mit denen sie verbunden sind.
