GoodSync-Auftrag über die Befehlszeile (GSYNC)

Nach oben

GSYNC-Befehlszeilenreferenz

GSYNC ist die Befehlszeilenversion von GoodSync. Sie kann in Batchdateien, Skripten, Automatisierungstools und Linux-Umgebungen verwendet werden.

GSYNC zeigt die grafische Oberfläche von GoodSync nicht an und bleibt geöffnet, bis der angeforderte Auftrag oder Vorgang abgeschlossen ist. Unter Windows und Mac erfordert GSYNC eine Lizenz für GoodSync Personal oder höher.

Allgemeines Befehlsformat:

gsync [profile-options] [run-options] [global-options] global-command | job-command

GSYNC führt Aufträge nacheinander in der Reihenfolge aus, in der sie in der Auftragsliste stehen.

Die Protokollausgabe wird nach stdout geschrieben, sofern sie nicht umgeleitet wird.

gsync /runner bildet das Verhalten der GoodSync-Oberfläche für Auto-Aufträge nach:

  • Startet und führt alle Aufträge im Auto-Modus aus, etwa Aufträge mit der Option Bei Veränderung einer Datei.
  • Zeigt keine grafische Oberfläche an. Die Auftragsergebnisse stehen in den globalen und Auftragsprotokollen zur Verfügung.
  • Belegt keine grafischen Ressourcen, da es als Befehlszeilenprozess läuft.
  • Um den GSYNC Runner zu beenden, senden Sie STRG+C an seine Konsole.
  • Ist /runner nicht angegeben, gelten die normalen GSYNC-Optionen.

gsync /? oder gsync /help – Listet alle GSYNC-Befehle auf.

Auf dieser Seite

Wählen Sie unten einen Abschnitt aus, um direkt zu den entsprechenden Informationen zur Befehlszeile zu springen.

Erste Schritte

Globale Befehle und Optionen

Auftragsbefehle und -optionen

Erweiterte Optionen

Automatisierung und Support

GSYNC-Schnellstart

Mit dem folgenden Ablauf prüfen Sie GSYNC, suchen einen vorhandenen Auftrag, sehen sich die vorgeschlagenen Änderungen an und führen ihn anschließend aus.

Bevor Sie beginnen: Vergewissern Sie sich, dass GoodSync installiert und lizenziert ist, und öffnen Sie die Eingabeaufforderung, PowerShell, das Terminal oder Ihre bevorzugte Shell.

  1. Installierte GoodSync-Version und Lizenz prüfen:
    gsync /version
  2. Im aktiven GoodSync-Profil verfügbare Aufträge auflisten:
    gsync job-list
  3. Auftrag analysieren, um die vorgeschlagenen Änderungen zu prüfen:
    gsync analyze "Job Name"
  4. Nach Prüfung der Analysieren-Ergebnisse den Auftrag ausführen:
    gsync sync "Job Name"

Wichtig: Führen Sie vor der ersten Synchronisierung Analysieren aus und prüfen Sie die vorgeschlagenen Änderungen – besonders dann, wenn der Auftrag Löschungen zulässt, Move Mode verwendet oder in nur eine Richtung läuft.

Leitfaden zur Befehlssyntax

Bei GSYNC müssen die Optionen in der richtigen Reihenfolge angegeben werden. Zuerst kommen die Profiloptionen, dann die Ausführungsoptionen, die globalen Optionen, der Befehl und die zugehörigen Auftragsoptionen.

gsync [profile-options] [run-options] [global-options] job-command [job-options]

Für einen globalen Befehl, der keinen Auftrag ausführt, verwenden Sie:

gsync [profile-options] global-command

Schreibweise Bedeutung
<value> Ersetzen Sie den Platzhalter durch einen tatsächlichen Wert.
[option] Die Option ist optional.
yes|no Wählen Sie einen der verfügbaren Werte.
Suffix 1 oder 2 Verwenden Sie 1 für die linke und 2 für die rechte Seite.
"Job Name" Setzen Sie Auftragsnamen oder Pfade, die Leerzeichen enthalten, in Anführungszeichen.

Wichtig: Mischen Sie Auftragsoptionen nicht mit globalen Optionen und setzen Sie globale Optionen nicht vor Profiloptionen. GSYNC erzwingt die Reihenfolge der Optionen.

Geltungsbereich von Befehlen

Jeder Befehl und jede Option gilt für einen bestimmten Bereich von GoodSync. Prüfen Sie den Geltungsbereich einer Option, bevor Sie sie einem Befehl hinzufügen.

Bereich Zweck
Profile Wählt das GoodSync-Profil, die Auftragsliste und den Speicherort der Protokolle aus.
Run Steuert Ausgabe und Verhalten des aktuellen GSYNC-Prozesses.
Global Steuert Aktionen und Einstellungen von GoodSync auf Programmebene.
Job Erstellt, aktualisiert, analysiert, synchronisiert oder konfiguriert einen bestimmten Auftrag.
Connectoid Legt eine Auftragsordner-URL, ein Server-Konto oder eine Verbindungseinstellung fest.
Side Gilt mit dem Suffix 1 für die linke Seite oder mit dem Suffix 2 für die rechte Seite.

Gängige GSYNC-Beispiele

Alle verfügbaren Aufträge auflisten:

gsync job-list

Einen vorhandenen Auftrag analysieren:

gsync analyze "Job Name"

Einen vorhandenen Auftrag analysieren und synchronisieren:

gsync sync "Job Name"

Alle Aufträge analysieren und synchronisieren:

gsync sync /all

Einen lokalen 1-Weg-Backup-Auftrag erstellen: gsync job-new "Local Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor /deletions=no /analyze

Einen 2-Weg-Synchronisierungsauftrag erstellen: gsync job-new "Two-Way Sync" /f1="file:///C:/Folder A" /f2="file:///D:/Folder B" /dir=2way /analyze

Einen temporären Auftrag ausführen, ohne ihn zu speichern: gsync job-tmp "Temporary Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor /analyze

Einen lokalen Backup-Auftrag unter Linux erstellen: gsync job-new "Linux Backup" /f1="file:///home/user/Documents" /f2="file:///mnt/backup/Documents" /dir=ltor /deletions=no /analyze

Einen vorhandenen Auftrag so konfigurieren, dass er täglich um 2:00 Uhr ausgeführt wird: gsync job-update "Backup Job" /on-schedule=sync /schedule-hour=2 /schedule-min=0

Um Aufträge zu verarbeiten, die für den Auto-Modus konfiguriert sind, starten Sie GSYNC mit gsync /runner.

Sicherheit

Beachten Sie die folgenden Punkte, bevor Sie GSYNC in Produktivskripten oder unbeaufsichtigten Umgebungen einsetzen.

  • Analysieren vor Synchronisieren: Führen Sie vor der ersten Synchronisierung oder nach einer Änderung der Auftragsoptionen Analysieren aus und prüfen Sie die vorgeschlagenen Änderungen.
  • Löschoptionen: /deletions=yes überträgt Löschungen auf die andere Seite. Prüfen Sie vorher Richtung und Filter des Auftrags.
  • Move Mode: /move-mode=yes löscht Quelldateien, nachdem sie kopiert wurden.
  • Sperrdateien: /override-locks=yes kann den Schutz eines anderen aktiven Auftrags aufheben. Verwenden Sie diese Option nur, wenn Sie sichergestellt haben, dass kein anderer GoodSync- oder GSYNC-Prozess die Ordner verwendet.
  • Verhalten der Statusdatei: /no-gsdata1=yes oder /no-gsdata2=yes verhindert, dass GoodSync auf dieser Seite seinen normalen Ordner für die Statusdatei verwendet, und kann die Nachverfolgung des Auftragsverlaufs verändern.
  • Zertifikatsprüfung: /bad-certs1=yes oder /bad-certs2=yes deaktiviert die normale Prüfung von SSL-Zertifikaten für diese Seite und sollte nur in einer kontrollierten Umgebung verwendet werden.
  • Passwörter: Direkt in einem Befehl eingegebene Passwörter können im Shell-Verlauf, in Skripten, Protokollen oder in den Informationen zu laufenden Prozessen sichtbar sein.
  • Profilauswahl: Prüfen Sie das aktive Profil, bevor Sie Aufträge aktualisieren oder löschen. Derselbe Auftragsname kann auch in einem anderen GoodSync-Profil vorkommen.

Profiloptionen

Mit den Profiloptionen legen Sie fest, welches GoodSync-Profil, welche Auftragsliste und welche Protokolleinstellungen beim Ausführen von GSYNC verwendet werden.

/profile=<folder-path> – Ordner, in dem sich jobs.tic und options.tic befinden.

/lf=<folder> – Ordner, in den die globale Protokolldatei geschrieben wird.

/ll=<number> – Detailstufe des Protokolls. Standard: 2 - Actions.

Protokoll-Detailstufen:

  • 0 - Critical
  • 1 - Errors
  • 2 - Actions – Standard
  • 3 - Details
  • 4 - Transaction
  • 5 - Debug

/jobs-file=<file-path> – Lädt die Auftragsliste aus dieser Datei im Format TIC oder TIX.

/no-load-tic – Lädt Aufträge, Gruppen und Optionen nicht, bevor Änderungen angewendet werden.

/no-save-tic – Speichert Aufträge, Gruppen und Optionen nicht, nachdem Änderungen angewendet wurden.

Ausführungsoptionen

Mit den Ausführungsoptionen steuern Sie beim Ausführen von Aufträgen die Befehlsausgabe, Fortschrittsanzeige, Bereinigung, Sperren und die Vergleichsmethode bei Analysieren.

/progress – Zeigt beim Ausführen eines Auftrags Fortschrittsmeldungen an.

/noprint – Gibt die Befehlszeilenargumente nicht zur Überprüfung aus.

/no-log-stamp – Fügt nicht jeder Protokollzeile einen Zeitstempel hinzu.

/list-changes – Gibt die Liste der von Analysieren erkannten Änderungen aus.

/cleanup – Bereinigt beim Start von GSYNC alte Protokoll- und temporäre Dateien.

/override-locks – Setzt Sperrdateien bei Analysieren außer Kraft und löscht sie. Standard: No.

/comp-cksums – Vergleicht bei Analysieren die Prüfsummen der Dateien. Diese Option ist langsam.

/comp-bodies – Vergleicht bei Analysieren die Dateiinhalte. Diese Option ist sehr langsam.

Globale Befehle

Mit diesen Befehlen zeigen Sie Hilfe- und Versionsinformationen an, verwalten Lizenzierung und Kontoaktionen, starten GSYNC in einem Runner-Modus und synchronisieren oder listen Aufträge/Gruppen und Server-Konten auf.

/version oder /license – Zeigt die Version und Lizenz von GoodSync an und wird beendet.

/help – Zeigt diese Hilfemeldung an.

/check-ver – Prüft die GoodSync-Version auf www.goodsync.com.

/gs-account-enroll=Email – Registriert diesen Computer in dem GoodSync-Konto mit der angegebenen E-Mail-Adresse.

/manage-account – Öffnet die GoodSync-Website zur Verwaltung Ihres GoodSync-Kontos.

/buy-license – Öffnet die GoodSync-Website zum Kauf von Lizenzen.

/activate – Aktiviert die Lizenz über das lokal registrierte GoodSync-Konto.

/runner – Läuft als lokaler Job Runner.

/cc-runner – Läuft als Control Center Job Runner.

/sync-jobs-accts – Synchronisiert Aufträge/Gruppen und Server-Konten dieses Computers mit dem GoodSync-Konto.

/list-jga – Listet alle Aufträge, Gruppen und Server-Konten dieses Computers auf.

GSYNC Runner Service

Der GSYNC Runner Service führt Auto-Aufträge aus, ohne dass die GoodSync-Oberfläche geöffnet bleiben muss.

/auto-unattended=yes|no – Führt einen Auto-Auftrag im Dienst gs-runner aus.

Wenn /auto-unattended=yes aktiviert ist:

  • Der Auftrag wird über den GoodSync Runner Service ausgeführt.
  • Unter Windows kann der Auftrag auch ausgeführt werden, wenn der Benutzer abgemeldet ist.
  • Der Runner Service wird erstellt, sobald der erste Auftrag für die Ausführung im Modus Unattended Auto konfiguriert wird.
  • Starten Sie den Befehl für den Runner Service nicht manuell. Er wird vom Betriebssystem gestartet.
  • Um den Auftrag wieder an die GoodSync-Oberfläche zu übergeben, deaktivieren Sie die Option Im Hintergrund in den Auftragsoptionen.

Globale Befehle für Server-Konten

Mit diesen Befehlen können Sie Server-Konten über die Befehlszeile erstellen, auflisten, aktualisieren, umbenennen, löschen und authentifizieren.

/sa-list [prefix] – Listet Server-Konten auf, optional beschränkt auf Konten, die mit dem angegebenen Präfix beginnen.

/sa-create – Erstellt ein neues Server-Konto und füllt es mit ConnectOptions.

/sa-oauth – Führt eine Browser-Authentifizierung (OAuth2) durch und speichert die Ergebnisse im Server-Konto.

  • Beispiele für OAuth-Start-URLs:
  • goodrive:// – Startet OAuth für Google All Drive.
  • gcp:// – Startet OAuth für Google Cloud Storage.
  • gteamdrive:// – Startet OAuth für Google Team Drive.
  • gdocs3:// – Startet OAuth für Google Docs.
  • dropbox:// – Startet OAuth für Dropbox.
  • box:// – Startet OAuth für Box.com.
  • msgraph:// – Startet OAuth für OneDrive, Office 365 und SharePoint.
  • pcloud:// – Startet OAuth für pCloud.

/sa-update AcctKey/AcctName ConnectOptions – Aktualisiert ein vorhandenes Server-Konto mit ConnectOptions.

/sa-rename AcctKey/AcctName NewAcctName – Benennt ein Server-Konto in NewAcctName um.

/sa-delete AcctKey/AcctName – Löscht ein Server-Konto anhand seines Schlüssels oder Namens.

/encrypt-plain=clear-password – Erzeugt aus einem Klartextpasswort ein verschlüsseltes Passwort.

Globale Optionen

Mit diesen Optionen konfigurieren Sie das allgemeine Programmverhalten von GoodSync, darunter Einstellungen für den Infobereich, Protokollierung, Auftragssortierung, Behandlung von Auto-Aufträgen, Proxy-Einstellungen und SMTP-E-Mail-Einstellungen.

Allgemein

/sort-jobs-alpha=yes|no – Sortiert Aufträge in der Auftragsliste alphabetisch.

/system-tray=yes|no – Zeigt das Symbol im Infobereich der Taskleiste an. Gilt nur für Windows.

/tray-on-close=yes|no – Verschiebt GoodSync beim Schließen der Anwendung in den Infobereich. Gilt nur für Windows.

/compare-prog=<FilePath> – Verwendet das angegebene Programm, um zwei Dateien im Diff-Stil zu vergleichen.

/warn-time-range=yes|no – Warnt, wenn die Änderungszeit einer Datei oder eines Ordners außerhalb des gültigen Bereichs liegt.

/group-log-lines=yes|no – Fasst ähnliche Protokollzeilen zusammen.

/log-retain-days=NNN – Legt fest, wie viele Tage alte Protokolle aufbewahrt werden.

Autostart

/auto-hide-mini-win=yes|no – Blendet das Minifenster automatisch aus, wenn keine Auftragsaktivität vorliegt. Gilt nur für Windows.

/months-old-gens=NNN – Bewahrt den Generationsverlauf für die angegebene Anzahl von Monaten auf.

/parallel-auto-jobs=NNN – Legt die maximale Anzahl von Aufträgen im Auto-Modus fest, die parallel laufen können.

/auto-jobs-quant=NNN – Legt das Zeitintervall in Sekunden für das Starten von Auto-Aufträgen fest.

/encrypted-passwords – Speichert Verbindungspasswörter lokal in verschlüsselter Form.

Filter

/exclude=<file-mask> – Schließt Dateien und Ordner aus, die der angegebenen Maske entsprechen.

/include=<file-mask> – Schließt nur Dateien und Ordner ein, die der angegebenen Maske entsprechen.

/exclude-empty=yes|no – Schließt leere Ordner aus.

/exclude-hidden=yes|no – Schließt versteckte Dateien und Ordner aus.

/exclude-system=yes|no – Schließt Systemdateien und -ordner aus.

PROXY-EINSTELLUNGEN

/proxy-auto=yes|no – Verwendet die automatischen Proxy-Einstellungen aus Internetoptionen > Verbindungen.

/proxy-host=hostname – Verwendet den angegebenen Proxyserver.

/proxy-port=port – Legt den Port des Proxyservers fest.

/proxy-userid=<userid> – Legt die Proxy-Benutzer-ID für Proxys mit Authentifizierung fest.

/proxy-passwd=<password> – Legt das Proxy-Passwort fest.

SMTP

/smtp-host=hostname – Legt den SMTP-Server für E-Mails nach Analysieren und nach Synchronisieren fest.

/smtp-port=port – Legt den Port des SMTP-Servers fest.

/smtp-secure=yes|no – Verwendet SSL für die Verbindung zum SMTP-Server.

/smtp-starttls=yes|no – Verwendet STARTTLS für die Verbindung zum SMTP-Server.

/smtp-userid=<userid> – Legt die Benutzer-ID für den SMTP-Server fest.

/smtp-passwd=<password> – Legt das Passwort für den SMTP-Server fest.

/smtp-sender=<name-email> – Legt E-Mail-Adresse und Namen des Absenders fest.

Auftragsbefehle

Mit diesen Befehlen können Sie GoodSync-Aufträge über die Befehlszeile analysieren, synchronisieren, erstellen, aktualisieren, löschen oder auflisten.

analyze /all – Analysiert alle Aufträge.
Beispiel: gsync analyze /all

analyze <job list> – Analysiert die aufgeführten Aufträge.
Beispiel: gsync analyze "Job Name"

sync /all – Analysiert und synchronisiert alle Aufträge.
Beispiel: gsync sync /all

sync <job list> – Analysiert und synchronisiert die aufgeführten Aufträge.
Beispiel: gsync sync "Job Name"

job <job name> [<job options>] – Erstellt einen neuen Auftrag oder aktualisiert einen vorhandenen Auftrag.
Beispiel: gsync job "Backup Job" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor

job-new <job name> [<job options>] – Erstellt einen neuen Auftrag.
Beispiel: gsync job-new "Backup Job" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor

job-tmp <job name> [<job options>] – Verwendet einen temporären Auftrag, der nicht gespeichert wird.
Beispiel: gsync job-tmp "Temp Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /sync

job-update <job name> [<job options>] – Aktualisiert einen vorhandenen Auftrag.
Beispiel: gsync job-update "Backup Job" /deletions=yes /worker-threads=4

job-delete <job name> – Löscht einen vorhandenen Auftrag.
Beispiel: gsync job-delete "Old Backup Job"

job-list – Listet die verfügbaren Aufträge auf.
Beispiel: gsync job-list

Auftragsoptionen

Mit diesen Optionen führen Sie Analysieren oder Synchronisieren aus, nachdem ein Auftrag erstellt oder aktualisiert wurde.

/analyze – Analysiert den Auftrag, nachdem er erstellt oder aktualisiert wurde.

/sync – Analysiert und synchronisiert den Auftrag, nachdem er erstellt oder aktualisiert wurde.

/autoclear – Entfernt die Baumansicht nach einer erfolgreichen Synchronisierung oder im Auto-Modus nach einem Analysieren ohne Änderungen.

URL- und Connectoid-Optionen für die Auftragsseiten

Mit diesen Optionen legen Sie die linke und rechte Seite eines Auftrags fest.

/f1=<full folder URL> – Vollständige URL des linken Sync-Ordners.

/f2=<full folder URL> – Vollständige URL des rechten Sync-Ordners.

/u1=<account URL> – URL eines im Account Manager gespeicherten Server-Kontos für die linke Seite.

/u2=<account URL> – URL eines im Account Manager gespeicherten Server-Kontos für die rechte Seite.

/n1=<AccountName> – Name des linken Server-Kontos. Erfordert /u1.

/n2=<AccountName> – Name des rechten Server-Kontos. Erfordert /u2.

/d1=<folder path> – Pfad des linken Ordners innerhalb des Server-Kontos bei Verwendung des Account Managers.

/d2=<folder path> – Pfad des rechten Ordners innerhalb des Server-Kontos bei Verwendung des Account Managers.

Setzen Sie Pfade, die Leerzeichen enthalten, in Anführungszeichen.

Beispiel: /f1="file:///C:/Source Folder" /f2="file:///D:/Backup Folder"

ConnectOptions und Seitenoptionen

Diese Optionen können mit Befehlen für Server-Konten oder als Seitenoptionen in Auftragsbefehlen verwendet werden.

/userid1=<userid> /userid2=<userid> – Benutzer-ID für die Verbindung auf der linken bzw. rechten Seite.

/password1=<password> /password2=<password> – Passwort für die Verbindung auf der linken bzw. rechten Seite.

/time-trans1=yes|no /time-trans2=yes|no – Verwendet eine Zeitumrechnung, wenn die Änderungszeit einer Datei nicht kopiert oder gesetzt werden kann.

/bad-certs1=yes|no /bad-certs2=yes|no – Deaktiviert die normale Prüfung von SSL-Zertifikaten auf der linken bzw. rechten Seite.

/useproxy1=yes|no /useproxy2=yes|no – Verwendet die Proxy-Einstellungen auf der linken bzw. rechten Seite.

/wininet1=yes|no /wininet2=yes|no – Verwendet WinInet statt nativer Sockets für DAV, S3 oder FTP auf der linken bzw. rechten Seite.

/utf8-1=yes|no /utf8-2=yes|no – Verwendet UTF-8- oder ANSI-Codierung für Dateinamen auf der linken bzw. rechten Seite.

/temp-dest-file1=yes|no /temp-dest-file2=yes|no – Verwendet temporäre Dateien beim Kopieren auf die linke bzw. rechte Seite.

/hostbased1=yes|no /hostbased2=yes|no – Verwendet Host-Based Addressing für S3 auf der linken bzw. rechten Seite.

/reduced-redundancy1=yes|no /reduced-redundancy2=yes|no – Verwendet Reduced Redundancy für S3 auf der linken bzw. rechten Seite.

/server-encrypt1=yes|no /server-encrypt2=yes|no – Verwendet serverseitige Verschlüsselung für S3 auf der linken bzw. rechten Seite.

/accesspolicy1=<policy> /accesspolicy2=<policy> – Verwendet die angegebene S3 Access Policy auf der linken bzw. rechten Seite.

/aws4-auth1=yes|no /aws4-auth2=yes|no – Verwendet die Authentifizierung mit AWS Signature Version 4 auf der linken bzw. rechten Seite.

/show-native1=yes|no /show-native2=yes|no – Exportiert oder importiert native Google-Docs-Dateien auf der linken bzw. rechten Seite.

/active1=yes|no /active2=yes|no – Verwendet den aktiven oder passiven FTP-Modus auf der linken bzw. rechten Seite.

/mdtm1=yes|no /mdtm2=yes|no – Verwendet MDTM für FTP auf der linken bzw. rechten Seite.

/mlsd1=yes|no /mlsd2=yes|no – Verwendet MLSD für FTP auf der linken bzw. rechten Seite.

/implicit1=yes|no /implicit2=yes|no – Verwendet den Implicit Mode für FTPS auf der linken bzw. rechten Seite.

/listla1=yes|no /listla2=yes|no – Verwendet die Option LIST -la für FTP auf der linken bzw. rechten Seite.

/move-level-only=yes|no – Lässt MOVE nur innerhalb einer Ordnerebene zu. Gilt für FTP.

/tls-sess-reuse=yes|no – Erfordert die Wiederverwendung von TLS-Sitzungen. Gilt für FTPS.

/pk1=<file-path> /pk2=<file-path> – Gibt den Pfad zum privaten SFTP-Schlüssel oder zum DAV/GSTP-Zertifikat für die linke bzw. rechte Seite an.

/can-otp1=yes|no /can-otp2=yes|no – Aktiviert die OTP-Unterstützung für GSTP auf der linken bzw. rechten Seite. Diese Option wird nicht gespeichert.

/otp1=value /otp2=value – Gibt den OTP-Wert für die linke bzw. rechte Seite an. Diese Option wird nicht gespeichert.

Allgemeine Auftragsoptionen

Mit diesen Optionen konfigurieren Sie das grundlegende Verhalten eines Auftrags, darunter Sync-Richtung, Löschungen, frühere Dateiversionen, Wiederverbindungsversuche, parallele Threads und Geschwindigkeitsbegrenzungen.

/dir=2way|ltor|rtol – Legt die Auftragsrichtung fest: 2-Weg, von links nach rechts oder von rechts nach links.

/deletions=yes|no – Überträgt Löschungen.

/fast-1way=yes|no – Aktiviert den Modus Schneller 1-Wege NoState NoLock.

/create-if-not-found=yes|no – Legt die Sync-Ordner des Auftrags an, falls sie nicht vorhanden sind.

/balloon-msg=none|errors|changes – Zeigt Sprechblasenmeldungen nie, bei Fehlern oder bei Änderungen an.

/save-prev-version=yes|no – Speichert gelöschte oder ersetzte Dateien in _gsdata_/_saved_. Es wird nur die letzte Version gespeichert.

/cleanup-prev-version=yes|no – Bereinigt frühere Dateiversionen.

/days-prev-version=<number> – Legt fest, wie viele Tage frühere Dateiversionen aufbewahrt werden.

/save-past-versions=yes|no – Speichert gelöschte oder ersetzte Dateien in _gsdata_/_history_. Es werden mehrere Versionen gespeichert.

/cleanup-past-versions=yes|no – Bereinigt ältere Dateiversionen.

/days-past-versions=<number> – Legt fest, wie viele Tage ältere Dateiversionen aufbewahrt werden.

/reconnect-secs=<number> – Legt die Gesamtdauer in Sekunden für Wiederverbindungsversuche fest.

/run-parallel-threads=yes|no – Führt während der Synchronisierung parallele Threads aus.

/worker-threads=N – Legt die Anzahl der Threads fest, die während der Synchronisierung parallel laufen.

/speed-limit=<number> – Legt die Geschwindigkeitsbegrenzung für das Kopieren von Dateien in Kb/s fest.

Auftragsfilteroptionen

Mit diesen Optionen legen Sie fest, welche Dateien und Ordner bei Analysieren oder Synchronisieren eines Auftrags ein- oder ausgeschlossen werden.

/exclude=<file-mask> – Schließt Dateien und Ordner aus, die der angegebenen Maske entsprechen.

Dateimasken können Muster wie *.obj oder \folder\file verwenden.

Es können mehrere /exclude-Optionen angegeben werden. Ihre Werte werden zusammengefasst und durch | getrennt.

/include=<file-mask> – Schließt Dateien und Ordner ein, die der angegebenen Maske entsprechen.

Dateimasken können Muster wie *.obj oder \folder\file verwenden.

Es können mehrere /include-Optionen angegeben werden. Ihre Werte werden zusammengefasst und durch | getrennt.

/exclude-empty=yes|no – Schließt leere Ordner aus.

/exclude-hidden=yes|no – Schließt versteckte Dateien und Ordner aus.

/exclude-system=yes|no – Schließt Systemdateien und -ordner aus.

Auftrags-Autostart-Optionen

Mit diesen Optionen legen Sie fest, wann ein Auftrag automatisch ausgeführt wird, etwa bei Dateiänderungen, beim Verbinden von Ordnern, beim Start von GoodSync, zu geplanten Zeitpunkten oder per Timer.

/on-file-change=analyze|sync|no – Analysiert oder synchronisiert automatisch, wenn in lokalen Sync-Ordnern Dateiänderungen erkannt werden.

/onfilechange-delay=NNN – Legt die Verzögerung für Bei Veränderung einer Datei in Sekunden fest.

/on-folder-connect=analyze|sync|no – Analysiert oder synchronisiert automatisch, wenn ein Ordner verbunden wird.

/on-start=analyze|sync|no – Analysiert oder synchronisiert automatisch beim Start von GoodSync.

/autostart-delay=NNN – Legt die Verzögerung für Beim Start von GoodSync in Sekunden fest.

/on-timer=analyze|sync|no – Analysiert oder synchronisiert automatisch per Timer.

/timer-period=<NN> – Legt das Timer-Intervall in Minuten für /on-timer fest.

/on-logout=sync – Synchronisiert automatisch beim Abmelden vom Windows-Konto.

/on-schedule=analyze|sync|no – Analysiert oder synchronisiert automatisch nach Zeitplan.

/schedule-min=list-of-number-ranges (0 to 59) – Legt die Minute des Zeitplans fest.

/schedule-hour=list-of-number-ranges (0 to 23) – Legt die Stunde des Zeitplans fest.

/schedule-day=list-of-number-ranges (1 to 31) – Legt den Tag des Monats im Zeitplan fest.

/schedule-month=list-of-number-ranges (1 to 12) – Legt den Monat des Zeitplans fest.

/schedule-dow=list-of-number-ranges (0=Sun to 6=Sat) – Legt den Wochentag des Zeitplans fest.

/auto-unattended=yes|no – Führt den Auto-Auftrag im Dienst gs-runner aus.

/limit-changes=<NN> – Synchronisiert nicht, wenn der Prozentsatz geänderter Dateien größer als NN ist.

/wait-for-locks=yes|no – Wartet auf Sperrdateien, statt einen Fehler auszugeben.

/autoclear=yes|no – Leert den Sync-Baum nach der Synchronisierung automatisch.

Konfliktoptionen

/resolve-weak-conflicts=yes|no – Löst schwache Konflikte automatisch, wenn eine Seite keine Generationen hat.

/autoresolve=no|left|right|newer|stopsync – Legt die Option Verhalten bei Konflikten in Autostartaufträgen fest.

/rename-losing-file=yes|no – Benennt die bei einem Konflikt unterlegene Datei um, statt sie zu löschen.

Skriptoptionen

Mit diesen Optionen führen Sie vor oder nach Analysieren bzw. Synchronisieren eines Auftrags ein Programm aus oder senden eine E-Mail.

/pre-analyze-action=<file-path> – Führt das angegebene Programm vor Analysieren aus.

/post-analyze-action=<email>|<file-path> – Sendet nach Analysieren eine E-Mail oder führt das angegebene Programm aus.

/post-sync-action=<email>|<file-path> – Sendet nach Synchronisieren eine E-Mail oder führt das angegebene Programm aus.

Erweiterte Optionen

Mit diesen Optionen steuern Sie die Dateiverarbeitung bei Analysieren und Synchronisieren, darunter Vergleichsmethoden, Metadaten, Berechtigungen, gesperrte Dateien, symbolische Links und das seitenspezifische Ordnerverhalten.

Optionen für die Synchronisieren-Phase

Mit diesen Optionen steuern Sie, wie Dateien bei der Synchronisierung behandelt werden, darunter Dateizeiten, Attribute, Berechtigungen, Verschiebeverhalten, gesperrte Dateien und Dateien, die sich nach Analysieren ändern.

/do-not-sync-changed-files=yes|no – Synchronisiert keine Dateien, die sich nach Analysieren geändert haben.

/wait-sync-after-analyze=seconds – Wartet nach Analysieren die angegebene Anzahl von Sekunden, bevor Synchronisieren gestartet wird.

/copy-create-time=yes|no – Kopiert die Erstellungszeit von Dateien und Ordnern.

/copy-attrs=yes|no – Kopiert die Attributbits von Dateien und Ordnern, etwa rwx.

/copy-ext-attrs=yes|no – Kopiert erweiterte Attribute. Gilt nur für Mac.

/copy-owner=yes|no – Kopiert die Besitzerinformationen von Dateien und Ordnern. Nicht erforderlich, wenn /copy-acl aktiviert ist.

/copy-acl=yes|no – Kopiert ACL-Sicherheitsinformationen einschließlich Besitzer und ACL.

/move-mode=yes|no – Löscht die Quelle nach dem Kopieren, um ein Verschieben nachzubilden.

/delete-empty-folders-on-move=yes|no – Löscht im Move Mode leere Ordner.

/copy-locked=yes|no – Kopiert gesperrte Dateien mithilfe des Volumeschattenkopie-Dienstes (Shadow Copy Service).

/uber-unlocked=yes|no – Aktiviert den Uber-Unlocked-Modus, in dem Dateien gelöscht werden können, während sie gelesen werden.

Optionen für die Analysieren-Phase

Mit diesen Optionen steuern Sie, wie Dateien bei Analysieren verglichen werden, darunter Prüfsummen, Erkennung verschobener Dateien, symbolische Links, Schätzung des benötigten Speicherplatzes und Änderungen auf der Zielseite.

/compare-md5=yes|no – Vergleicht bei Analysieren alle Dateien anhand von MD5-Prüfsummen.

/detect-moves=yes|no – Erkennt das Verschieben und Umbenennen von Dateien und Ordnern, statt dies als Kopieren und Löschen zu verarbeiten.

/ignore-changes-on-dest-side – Ignoriert Änderungen auf der Zielseite.

/est-req-space=yes|no – Schätzt den für die Synchronisierung benötigten freien Speicherplatz.

/links=ignore|copy-asis|drill-down – Legt fest, wie symbolische Links verarbeitet werden.

/copy-original-fs-names=yes|no – Behält die ursprünglichen Dateisystemnamen bei und ersetzt keine unzulässigen Zeichen. Gilt für Aufträge von Mac zu Mac.

Ordneroptionen für die linke/rechte Seite

Mit diesen Optionen konfigurieren Sie Einstellungen für die linke oder rechte Seite eines Auftrags, darunter Vergleichsregeln, Verhalten der Statusdatei, temporäre Dateien, Komprimierung, Verschlüsselung und Dateisystembehandlung.

/compare-checksums1=yes|no /compare-checksums2=yes|no – Vergleicht bei Bedarf Prüfsummen auf der linken bzw. rechten Seite.

/compare-ext-attrs1=yes|no /compare-ext-attrs2=yes|no – Vergleicht erweiterte Attribute auf der linken bzw. rechten Seite.

/compare-attrs1=yes|no /compare-attrs2=yes|no – Vergleicht Attribute auf der linken bzw. rechten Seite.

/compare-owner1=yes|no /compare-owner2=yes|no – Vergleicht Besitzerinformationen auf der linken bzw. rechten Seite.

/compare-acl1=yes|no /compare-acl2=yes|no – Vergleicht ACL-Sicherheitsinformationen auf der linken bzw. rechten Seite.

/no-gsdata1=yes|no /no-gsdata2=yes|no – Erstellt bzw. verwendet den Ordner _gsdata_ auf der linken bzw. rechten Seite nicht.

/no-listdir1=yes|no /no-listdir2=yes|no – Führt kein ListDir aus und verlässt sich auf der linken bzw. rechten Seite auf die Statusdatei.

/temp-dest-file1=yes|no /temp-dest-file2=yes|no – Verwendet temporäre Dateien beim Kopieren auf die linke bzw. rechte Seite.

/compress-type1=no|plain|deflate /compress-type2=no|plain|deflate – Legt die Methode zur Komprimierung der Dateiinhalte auf der linken bzw. rechten Seite fest.

/cipher-type1=no|zipcrypto|aes-256 /cipher-type2=no|zipcrypto|aes-256 – Legt die Methode zur Verschlüsselung der Dateiinhalte auf der linken bzw. rechten Seite fest.

/encrypt-files1=yes|no /encrypt-files2=yes|no – Verschlüsselt die Dateiinhalte auf der linken bzw. rechten Seite.

/encrypt-paths1=yes|no /encrypt-paths2=yes|no – Verschlüsselt die Dateipfade auf der linken bzw. rechten Seite.

/encrypt-password1=str /encrypt-password2=str – Legt das Verschlüsselungspasswort für die linke bzw. rechte Seite fest.

/fat-like1=yes|no /fat-like2=yes|no – Behandelt die linke bzw. rechte Seite als FAT-ähnliches Dateisystem.

/compress1=yes|no /compress2=yes|no – Verwendet NTFS-Komprimierung auf der linken bzw. rechten Seite.

/uncompress1=yes|no /uncompress2=yes|no – Entfernt die NTFS-Komprimierung auf der linken bzw. rechten Seite.

Rückgabe- und Exit-Codes

GSYNC gibt den Exit-Code des zuletzt ausgeführten Auftrags zurück. Automatisierungsskripte können anhand dieses Werts feststellen, ob der Auftrag abgeschlossen wurde, gestoppt wurde, auf einen Fehler gestoßen ist oder mit Konflikten beendet wurde.

Code Ergebnis
0 Normaler Abschluss: Analysieren hat keine Änderungen gefunden oder Synchronisieren wurde erfolgreich abgeschlossen.
1 Analysieren wurde nicht abgeschlossen, weil es vom Benutzer gestoppt wurde.
2 Analysieren wurde aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen, etwa wegen eines fehlenden Sync-Ordners.
3 Analysieren wurde mit nicht schwerwiegenden Fehlern und möglicherweise Konflikten abgeschlossen.
4 Analysieren wurde mit Konflikten, aber ohne Fehler abgeschlossen.
11 Synchronisieren wurde nicht abgeschlossen, weil es vom Benutzer gestoppt wurde.
12 Synchronisieren wurde aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen, etwa wegen eines fehlenden Sync-Ordners.
13 Synchronisieren wurde mit nicht schwerwiegenden Fehlern und möglicherweise Konflikten abgeschlossen.
14 Synchronisieren wurde mit Konflikten, aber ohne Fehler abgeschlossen.
Negativer Wert Beim Start von GSYNC ist ein Fehler aufgetreten.

Wichtig: Prüfen Sie das Auftragsprotokoll auch dann, wenn ein Befehl abgeschlossen wird. Manche nicht schwerwiegenden Zustände werden nur im Protokoll festgehalten.

Letzten Exit-Code in der Eingabeaufforderung prüfen:

echo %ERRORLEVEL%

Letzten Exit-Code in PowerShell prüfen:

$LASTEXITCODE

Letzten Exit-Code unter macOS oder Linux prüfen:

echo $?

Befehlsausgabe in eine Protokolldatei unter Windows umleiten:

gsync sync "Job Name" > "C:\Logs\GoodSync.log" 2>&1

Befehlsausgabe in eine Protokolldatei unter macOS oder Linux umleiten:

gsync sync "Job Name" > "/var/log/goodsync.log" 2>&1

Fehlerbehebung bei GSYNC

Problem Empfohlene Prüfung
Der Befehl GSYNC wird nicht gefunden Vergewissern Sie sich, dass GoodSync installiert ist, und führen Sie GSYNC aus dem Installationsordner aus oder fügen Sie diesen Ordner der Systemvariablen PATH hinzu.
Der Auftrag wird nicht gefunden Führen Sie gsync job-list aus, prüfen Sie den genauen Auftragsnamen und stellen Sie sicher, dass das richtige Profil geladen ist.
Pfad oder Auftragsname enthält Leerzeichen Setzen Sie den vollständigen Auftragsnamen oder Pfad in Anführungszeichen.
Zugriff verweigert Prüfen Sie die Berechtigungen des Benutzer- oder Dienstkontos, unter dem GSYNC läuft, für beide Auftragsordner.
Authentifizierung schlägt fehl Prüfen Sie Server-Konto, Benutzer-ID, Passwort, privaten Schlüssel, OAuth-Autorisierung und das Suffix der seitenspezifischen Option.
Der Auftrag ist gesperrt Stellen Sie sicher, dass kein anderer GoodSync- oder GSYNC-Prozess dieselben Sync-Ordner verwendet, bevor Sie eine Sperre aufheben.
Es werden unerwartete Änderungen erkannt Führen Sie nur Analysieren aus und prüfen Sie Richtung, Filter, Löscheinstellungen, Optionen der Statusdatei und das aktive Profil, bevor Sie Synchronisieren ausführen.
Es werden mehr Protokolldetails benötigt Erhöhen Sie die Detailstufe des Protokolls mit /ll=<number> und leiten Sie stdout in eine Protokolldatei um.

Um die in der installierten Version verfügbare Befehlsliste anzuzeigen, führen Sie gsync /help oder gsync /? aus.

GSYNC-Glossar

Analysieren – Vergleicht beide Seiten des Auftrags und ermittelt die Änderungen, die Synchronisieren durchführen würde.

Synchronisieren – Führt die bei Analysieren ermittelten Aktionen aus.

Auftrag – Eine gespeicherte Zusammenstellung aus Sync-Ordnern, Richtung, Filtern und Betriebsoptionen.

Profil – Der Speicherort der GoodSync-Konfiguration mit Aufträgen, Server-Konten, Programmoptionen und Protokollen.

Linke und rechte Seite – Die beiden Ordner bzw. Dateisysteme, die ein GoodSync-Auftrag miteinander vergleicht.

Server-Konto – Eine gespeicherte Verbindungs- und Authentifizierungskonfiguration für ein unterstütztes Dateisystem.

Connectoid – Die Verbindungseigenschaften, mit denen ein lokales, Netzwerk- oder entferntes Dateisystem erreicht wird.

Statusdatei (State File) – GoodSync-Daten, mit denen der vorherige Auftragszustand nachverfolgt und die Änderungen zwischen Ausführungen ermittelt werden.

Runner – Ein GSYNC-Hintergrundprozess, der für den Auto-Modus konfigurierte Aufträge startet und ausführt.

Auto-Modus – Auftragseinstellungen, die Analysieren oder Synchronisieren anhand von Ereignissen, Zeitplänen, Timern oder der Verfügbarkeit von Ordnern auslösen.

stdout – Die Standardausgabe eines Befehls, die im Terminal angezeigt oder in eine Datei umgeleitet werden kann.

Verwenden Sie für die von der installierten GoodSync-Version unterstützten Befehle immer gsync /help als versionsspezifische Referenz.

Nach oben