Tarea de GoodSync por línea de comandos (GSYNC)

Volver arriba

Referencia de la línea de comandos de GSYNC

GSYNC es la versión de línea de comandos de GoodSync. Se puede utilizar en archivos por lotes, scripts, herramientas de automatización y entornos Linux.

GSYNC no muestra la interfaz gráfica de GoodSync y permanece abierto hasta que finaliza la tarea o la acción solicitadas. En Windows y Mac, GSYNC requiere una licencia GoodSync Personal o superior.

Formato general de los comandos:

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

GSYNC ejecuta las tareas de forma secuencial, en el orden en que aparecen en Lista de Tareas.

La salida del registro se escribe en stdout, a menos que se redirija.

gsync /runner reproduce el comportamiento de la interfaz gráfica de GoodSync para las tareas Auto:

  • Inicia y ejecuta todas las tareas que están en Auto Mode, como las tareas Al cambiar Archivo.
  • No muestra la interfaz gráfica. Los resultados de las tareas están disponibles en los registros globales y de tarea.
  • No utiliza recursos gráficos, porque se ejecuta como un proceso de línea de comandos.
  • Para detener GSYNC Runner, envíe CTRL+C a su consola.
  • Si no se especifica /runner, se aplican las opciones habituales de GSYNC.

gsync /? o gsync /help: muestra todos los comandos de GSYNC.

En esta página

Seleccione una de las secciones siguientes para ir directamente a la información de línea de comandos correspondiente.

Primeros pasos

Comandos y opciones globales

Comandos y opciones de tarea

Opciones avanzadas

Automatización y soporte

Inicio rápido de GSYNC

Siga el flujo de trabajo siguiente para verificar GSYNC, localizar una tarea existente, revisar los cambios propuestos y, a continuación, ejecutarla.

Antes de comenzar: confirme que GoodSync está instalado y con licencia, y abra el símbolo del sistema, PowerShell, Terminal o el shell que prefiera.

  1. Confirme la versión de GoodSync instalada y la licencia:
    gsync /version
  2. Muestre la lista de las tareas disponibles en el perfil activo de GoodSync:
    gsync job-list
  3. Ejecute Analizar en la tarea para revisar los cambios propuestos:
    gsync analyze "Job Name"
  4. Después de revisar los resultados de Analizar, ejecute la tarea:
    gsync sync "Job Name"

Importante: ejecute Analizar y revise los cambios propuestos antes del primer Sincronizar, especialmente cuando la tarea permita eliminaciones, utilice Modo Mover o se ejecute en una sola dirección.

Guía de sintaxis de los comandos

GSYNC requiere que las opciones se introduzcan en el orden correcto. Primero van las opciones de perfil (Profile Options), seguidas de las opciones de ejecución (Run Options), las opciones globales (Global Options), el comando y las opciones de tarea (Job Options) que le correspondan.

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

Para un comando global que no ejecuta una tarea, utilice:

gsync [profile-options] global-command

Notación Significado
<value> Reemplace el marcador de posición por un valor real.
[option] La opción es opcional.
yes|no Seleccione uno de los valores disponibles.
Sufijo 1 o 2 Use 1 para el Lado Izquierdo y 2 para el Lado Derecho.
"Job Name" Use comillas cuando el nombre de una tarea o una ruta contenga espacios.

Importante: no mezcle las opciones de tarea con las opciones globales ni coloque las opciones globales antes de las opciones de perfil. GSYNC exige que se respete el orden de las opciones.

Descripción del ámbito de los comandos

Cada comando u opción se aplica a un área concreta de GoodSync. Confirme el ámbito de la opción antes de agregarla a un comando.

Ámbito Finalidad
Profile Selecciona el perfil de GoodSync, la lista de tareas y la ubicación de los registros.
Run Controla la salida y el comportamiento del proceso actual de GSYNC.
Global Controla las acciones y la configuración de GoodSync a nivel de programa.
Job Crea, actualiza, analiza, sincroniza o configura una tarea específica.
Connectoid Define la URL de una carpeta de una tarea, un Server Account o un ajuste de conexión.
Side Se aplica al Lado Izquierdo con el sufijo 1 o al Lado Derecho con el sufijo 2.

Ejemplos habituales de GSYNC

Mostrar la lista de todas las tareas disponibles:

gsync job-list

Ejecutar Analizar en una tarea existente:

gsync analyze "Job Name"

Ejecutar Analizar y Sincronizar en una tarea existente:

gsync sync "Job Name"

Ejecutar Analizar y Sincronizar en todas las tareas:

gsync sync /all

Crear una tarea de copia de seguridad local unidireccional: gsync job-new "Local Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor /deletions=no /analyze

Crear una tarea de sincronización bidireccional: gsync job-new "Two-Way Sync" /f1="file:///C:/Folder A" /f2="file:///D:/Folder B" /dir=2way /analyze

Ejecutar una tarea temporal sin guardarla: gsync job-tmp "Temporary Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor /analyze

Crear una tarea de copia de seguridad local en Linux: gsync job-new "Linux Backup" /f1="file:///home/user/Documents" /f2="file:///mnt/backup/Documents" /dir=ltor /deletions=no /analyze

Configurar una tarea existente para que se ejecute todos los días a las 2:00 a. m.: gsync job-update "Backup Job" /on-schedule=sync /schedule-hour=2 /schedule-min=0

Para procesar las tareas configuradas en Auto Mode, inicie GSYNC con gsync /runner.

Seguridad y protección

Revise las consideraciones siguientes antes de utilizar GSYNC en scripts de producción o en entornos desatendidos.

  • Analizar antes de Sincronizar: ejecute Analizar y revise los cambios propuestos antes del primer Sincronizar o después de modificar las opciones de una tarea.
  • Opciones de eliminación: /deletions=yes propaga las eliminaciones al otro lado. Confirme primero la dirección de la tarea y los filtros.
  • Modo Mover: /move-mode=yes elimina los archivos de origen después de copiarlos.
  • Archivos de bloqueo: /override-locks=yes puede anular la protección creada por otra tarea activa. Utilícela solo después de confirmar que ningún otro proceso de GoodSync o GSYNC está usando las carpetas.
  • Comportamiento del State File: /no-gsdata1=yes o /no-gsdata2=yes impide que GoodSync utilice su carpeta normal de State File en ese lado y puede cambiar la forma en que se registra el historial de la tarea.
  • Validación de certificados: /bad-certs1=yes o /bad-certs2=yes desactiva la validación normal de certificados SSL en ese lado y solo debe utilizarse en un entorno controlado.
  • Contraseñas: las contraseñas introducidas directamente en un comando pueden quedar visibles en el historial del shell, en scripts, en registros o en la información de los procesos activos.
  • Selección del perfil: confirme cuál es el perfil activo antes de actualizar o eliminar tareas. Puede existir una tarea con el mismo nombre en otro perfil de GoodSync.

Opciones de perfil

Utilice las opciones de perfil para controlar qué perfil de GoodSync, lista de tareas y configuración de registros se usan al ejecutar GSYNC.

/profile=<folder-path>: carpeta donde se encuentran jobs.tic y options.tic.

/lf=<folder>: carpeta donde se escribe el archivo de registro global.

/ll=<number>: nivel de detalle del registro. Valor predeterminado: 2 - Acciones.

Niveles de detalle del registro:

  • 0 - Críticos
  • 1 - Errores
  • 2 - Acciones: valor predeterminado
  • 3 - Detalles
  • 4 - Transacción
  • 5 - Depurar

/jobs-file=<file-path>: carga la lista de tareas desde este archivo en formato TIC o TIX.

/no-load-tic: no carga las tareas, los grupos ni las opciones antes de aplicar los cambios.

/no-save-tic: no guarda las tareas, los grupos ni las opciones después de aplicar los cambios.

Opciones de ejecución

Utilice las opciones de ejecución para controlar la salida de los comandos, el progreso, la limpieza, los bloqueos y el comportamiento de comparación de Analizar al ejecutar tareas.

/progress: muestra mensajes de progreso al ejecutar una tarea.

/noprint: no imprime los argumentos de la línea de comandos para su verificación.

/no-log-stamp: no agrega una marca de tiempo a cada línea del registro.

/list-changes: imprime la lista de cambios detectados por Analizar.

/cleanup: limpia los registros antiguos y los archivos temporales al iniciar GSYNC.

/override-locks: anula y elimina los archivos de bloqueo durante Analizar. Valor predeterminado: No.

/comp-cksums: compara las sumas de comprobación de los archivos durante Analizar. Esta opción es lenta.

/comp-bodies: compara el contenido de los archivos durante Analizar. Esta opción es muy lenta.

Comandos globales

Utilice estos comandos para mostrar información de ayuda y de versión, administrar la licencia y las acciones de la cuenta, ejecutar los modos de runner de GSYNC, y sincronizar o mostrar la lista de Jobs-Groups y Server Accounts.

/version o /license: muestra la versión y la licencia de GoodSync y sale.

/help: muestra este mensaje de ayuda.

/check-ver: comprueba la versión de GoodSync en www.goodsync.com.

/gs-account-enroll=Email: inscribe este equipo en la cuenta de GoodSync identificada por Email.

/manage-account: abre el sitio web de GoodSync para administrar su cuenta de GoodSync.

/buy-license: abre el sitio web de GoodSync para comprar licencias.

/activate: activa la licencia mediante la cuenta de GoodSync inscrita localmente.

/runner: se ejecuta como Local Job Runner.

/cc-runner: se ejecuta como Control Center Job Runner.

/sync-jobs-accts: sincroniza los Jobs-Groups y los Server Accounts de este equipo con la cuenta de GoodSync.

/list-jga: muestra la lista de todas las tareas, grupos y Server Accounts de este equipo.

Servicio GSYNC Runner

El servicio GSYNC Runner ejecuta tareas Auto sin necesidad de mantener abierta la interfaz gráfica de GoodSync.

/auto-unattended=yes|no: ejecuta una tarea Auto en el servicio gs-runner.

Cuando /auto-unattended=yes está activada:

  • La tarea se ejecuta mediante el servicio GoodSync Runner.
  • En Windows, la tarea se puede ejecutar incluso cuando el usuario ha cerrado la sesión.
  • El Runner Service se crea cuando se configura la primera tarea para ejecutarse en modo Unattended Auto.
  • No inicie manualmente el comando del Runner Service. Lo inicia el sistema operativo.
  • Para devolver la tarea a la interfaz gráfica de GoodSync, desactive la opción Ejecutar sin interfaz de usuario (Desatendido) en Opciones.

Comandos globales para Server Accounts

Utilice estos comandos para crear, mostrar, actualizar, renombrar, eliminar y autenticar Server Accounts desde la línea de comandos.

/sa-list [prefix]: muestra la lista de Server Accounts, con la posibilidad de limitarla a las cuentas que comienzan por prefix.

/sa-create : crea un nuevo Server Account y lo rellena con ConnectOptions.

/sa-oauth: realiza la autenticación mediante el navegador (OAuth2) y guarda los resultados en el Server Account.

  • Ejemplos de URL de inicio de OAuth:
  • goodrive://: inicia OAuth para Google All Drive.
  • gcp://: inicia OAuth para Google Cloud Storage.
  • gteamdrive://: inicia OAuth para Google Team Drive.
  • gdocs3://: inicia OAuth para Google Docs.
  • dropbox://: inicia OAuth para Dropbox.
  • box://: inicia OAuth para Box.com.
  • msgraph://: inicia OAuth para OneDrive, Office 365 y SharePoint.
  • pcloud://: inicia OAuth para pCloud.

/sa-update AcctKey/AcctName ConnectOptions: actualiza un Server Account existente con ConnectOptions.

/sa-rename AcctKey/AcctName NewAcctName: cambia el nombre de un Server Account a NewAcctName.

/sa-delete AcctKey/AcctName: elimina un Server Account por su clave (Key) o nombre (Name).

/encrypt-plain=clear-password: genera una contraseña cifrada a partir de una contraseña en texto sin cifrar.

Opciones globales

Utilice estas opciones para configurar el comportamiento general del programa GoodSync, incluidos los ajustes de la bandeja del sistema, los registros, la ordenación de tareas, el tratamiento de las tareas Auto, la configuración del proxy y la configuración del correo SMTP.

General

/sort-jobs-alpha=yes|no: ordena las tareas alfabéticamente en la vista Lista de Tareas.

/system-tray=yes|no: muestra el icono de la bandeja del sistema. Se aplica solo a Windows.

/tray-on-close=yes|no: envía GoodSync a la bandeja del sistema cuando se cierra la aplicación. Se aplica solo a Windows.

/compare-prog=<FilePath>: utiliza el programa especificado para comparar dos archivos al estilo diff.

/warn-time-range=yes|no: avisa cuando la hora de modificación de un archivo o una carpeta está fuera del intervalo permitido.

/group-log-lines=yes|no: agrupa las líneas de registro similares.

/log-retain-days=NNN: establece el número de días que se conservan los registros antiguos.

Auto

/auto-hide-mini-win=yes|no: oculta automáticamente la miniventana cuando no hay actividad de tareas. Se aplica solo a Windows.

/months-old-gens=NNN: conserva el historial de generaciones durante el número de meses especificado.

/parallel-auto-jobs=NNN: establece el número máximo de tareas en modo Auto que pueden ejecutarse en paralelo.

/auto-jobs-quant=NNN: establece el intervalo de tiempo, en segundos, para iniciar las tareas Auto.

/encrypted-passwords: guarda localmente las contraseñas de conexión en forma cifrada.

Filtros

/exclude=<file-mask>: excluye los archivos y las carpetas que coinciden con la máscara especificada.

/include=<file-mask>: incluye solo los archivos y las carpetas que coinciden con la máscara especificada.

/exclude-empty=yes|no: excluye las carpetas vacías.

/exclude-hidden=yes|no: excluye los archivos y las carpetas ocultos.

/exclude-system=yes|no: excluye los archivos y las carpetas del sistema.

Configuración de proxy

/proxy-auto=yes|no: utiliza la configuración automática del proxy de Internet Options > Connections.

/proxy-host=hostname: utiliza el servidor proxy especificado.

/proxy-port=port: establece el puerto del servidor proxy.

/proxy-userid=<userid>: establece el ID de usuario del proxy para los proxies con autenticación.

/proxy-passwd=<password>: establece la contraseña del proxy.

SMTP

/smtp-host=hostname: establece el servidor SMTP que se utiliza para los correos posteriores a Analizar y a Sincronizar.

/smtp-port=port: establece el puerto del servidor SMTP.

/smtp-secure=yes|no: utiliza SSL para conectarse al servidor SMTP.

/smtp-starttls=yes|no: utiliza STARTTLS para conectarse al servidor SMTP.

/smtp-userid=<userid>: establece el ID de usuario del servidor SMTP.

/smtp-passwd=<password>: establece la contraseña del servidor SMTP.

/smtp-sender=<name-email>: establece la dirección de correo electrónico y el nombre del remitente.

Comandos de tarea

Utilice estos comandos para analizar, sincronizar, crear, actualizar, eliminar o mostrar la lista de tareas de GoodSync desde la línea de comandos.

analyze /all: ejecuta Analizar en todas las tareas.
Ejemplo: gsync analyze /all

analyze <job list>: ejecuta Analizar en las tareas indicadas.
Ejemplo: gsync analyze "Job Name"

sync /all: ejecuta Analizar y Sincronizar en todas las tareas.
Ejemplo: gsync sync /all

sync <job list>: ejecuta Analizar y Sincronizar en las tareas indicadas.
Ejemplo: gsync sync "Job Name"

job <job name> [<job options>]: crea una tarea nueva o actualiza una existente.
Ejemplo: gsync job "Backup Job" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor

job-new <job name> [<job options>]: crea una tarea nueva.
Ejemplo: gsync job-new "Backup Job" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor

job-tmp <job name> [<job options>]: utiliza una tarea temporal que no se guarda.
Ejemplo: gsync job-tmp "Temp Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /sync

job-update <job name> [<job options>]: actualiza una tarea existente.
Ejemplo: gsync job-update "Backup Job" /deletions=yes /worker-threads=4

job-delete <job name>: elimina una tarea existente.
Ejemplo: gsync job-delete "Old Backup Job"

job-list: muestra la lista de tareas disponibles.
Ejemplo: gsync job-list

Opciones de tarea

Utilice estas opciones para ejecutar Analizar o Sincronizar después de crear o actualizar una tarea.

/analyze: ejecuta Analizar en la tarea después de crearla o actualizarla.

/sync: ejecuta Analizar y Sincronizar en la tarea después de crearla o actualizarla.

/autoclear: elimina el árbol después de un Sincronizar correcto, o después de Analizar cuando no hay cambios en modo Auto.

Opciones de URL y Connectoid de los lados de la tarea

Utilice estas opciones para definir los lados izquierdo y derecho de una tarea.

/f1=<full folder URL>: URL completa de la carpeta de sincronización Izquierda.

/f2=<full folder URL>: URL completa de la carpeta de sincronización Derecha.

/u1=<account URL>: URL del Lado Izquierdo de un Server Account guardado en Account Manager.

/u2=<account URL>: URL del Lado Derecho de un Server Account guardado en Account Manager.

/n1=<AccountName>: nombre del Server Account del Lado Izquierdo. Requiere /u1.

/n2=<AccountName>: nombre del Server Account del Lado Derecho. Requiere /u2.

/d1=<folder path>: ruta de la carpeta Izquierda dentro del Server Account cuando se utiliza Account Manager.

/d2=<folder path>: ruta de la carpeta Derecha dentro del Server Account cuando se utiliza Account Manager.

Use comillas en las rutas que contengan espacios.

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

ConnectOptions y opciones de lado

Estas opciones se pueden utilizar con los comandos de Server Account o como opciones de lado en los comandos de tarea.

/userid1=<userid> /userid2=<userid>: ID de usuario de la conexión para el Lado Izquierdo o Derecho.

/password1=<password> /password2=<password>: contraseña de la conexión para el Lado Izquierdo o Derecho.

/time-trans1=yes|no /time-trans2=yes|no: utiliza la traducción de hora cuando no se puede copiar o establecer la hora de modificación de un archivo.

/bad-certs1=yes|no /bad-certs2=yes|no: desactiva la validación normal de certificados SSL en el Lado Izquierdo o Derecho.

/useproxy1=yes|no /useproxy2=yes|no: utiliza la configuración del proxy en el Lado Izquierdo o Derecho.

/wininet1=yes|no /wininet2=yes|no: utiliza WinInet en lugar de sockets nativos para DAV, S3 o FTP en el Lado Izquierdo o Derecho.

/utf8-1=yes|no /utf8-2=yes|no: utiliza la codificación UTF-8 o ANSI para los nombres de archivo en el Lado Izquierdo o Derecho.

/temp-dest-file1=yes|no /temp-dest-file2=yes|no: utiliza archivos temporales al copiar al Lado Izquierdo o Derecho.

/hostbased1=yes|no /hostbased2=yes|no: utiliza Host-Based Addressing para S3 en el Lado Izquierdo o Derecho.

/reduced-redundancy1=yes|no /reduced-redundancy2=yes|no: utiliza Reduced Redundancy para S3 en el Lado Izquierdo o Derecho.

/server-encrypt1=yes|no /server-encrypt2=yes|no: utiliza Server-Side Encryption para S3 en el Lado Izquierdo o Derecho.

/accesspolicy1=<policy> /accesspolicy2=<policy>: utiliza la S3 Access Policy especificada en el Lado Izquierdo o Derecho.

/aws4-auth1=yes|no /aws4-auth2=yes|no: utiliza la autenticación AWS Signature Version 4 en el Lado Izquierdo o Derecho.

/show-native1=yes|no /show-native2=yes|no: exporta o importa archivos nativos de Google Docs en el Lado Izquierdo o Derecho.

/active1=yes|no /active2=yes|no: utiliza el modo FTP activo o pasivo en el Lado Izquierdo o Derecho.

/mdtm1=yes|no /mdtm2=yes|no: utiliza MDTM para FTP en el Lado Izquierdo o Derecho.

/mlsd1=yes|no /mlsd2=yes|no: utiliza MLSD para FTP en el Lado Izquierdo o Derecho.

/implicit1=yes|no /implicit2=yes|no: utiliza el modo Implicit para FTPS en el Lado Izquierdo o Derecho.

/listla1=yes|no /listla2=yes|no: utiliza la opción LIST -la para FTP en el Lado Izquierdo o Derecho.

/move-level-only=yes|no: permite que MOVE funcione en un solo nivel de carpetas. Se aplica a FTP.

/tls-sess-reuse=yes|no: exige la reutilización de sesiones TLS. Se aplica a FTPS.

/pk1=<file-path> /pk2=<file-path>: especifica la clave privada de SFTP o la ruta del certificado de DAV/GSTP para el Lado Izquierdo o Derecho.

/can-otp1=yes|no /can-otp2=yes|no: habilita la compatibilidad con OTP para GSTP en el Lado Izquierdo o Derecho. Esta opción no es persistente.

/otp1=value /otp2=value: especifica el valor de OTP para el Lado Izquierdo o Derecho. Esta opción no es persistente.

Opciones generales de la tarea

Utilice estas opciones para configurar el comportamiento principal de la tarea, incluida la dirección de sincronización, las eliminaciones, las versiones anteriores de los archivos, los intentos de reconexión, los subprocesos en paralelo y los límites de velocidad.

/dir=2way|ltor|rtol: establece la dirección de la tarea: bidireccional, de izquierda a derecha o de derecha a izquierda.

/deletions=yes|no: propaga las eliminaciones.

/fast-1way=yes|no: habilita el modo unidireccional rápido Fast NoState NoLock.

/create-if-not-found=yes|no: crea las carpetas de sincronización de la tarea si no se encuentran.

/balloon-msg=none|errors|changes: muestra las notificaciones emergentes nunca, solo en caso de errores o solo en caso de cambios.

/save-prev-version=yes|no: guarda los archivos eliminados o reemplazados en _gsdata_/_saved_. Solo se guarda la última versión.

/cleanup-prev-version=yes|no: limpia las versiones anteriores de los archivos.

/days-prev-version=<number>: establece el número de días que se conservan las versiones anteriores de los archivos.

/save-past-versions=yes|no: guarda los archivos eliminados o reemplazados en _gsdata_/_history_. Se guardan varias versiones.

/cleanup-past-versions=yes|no: limpia las versiones pasadas de los archivos.

/days-past-versions=<number>: establece el número de días que se conservan las versiones pasadas de los archivos.

/reconnect-secs=<number>: establece el número total de segundos para los intentos de reconexión.

/run-parallel-threads=yes|no: ejecuta subprocesos en paralelo durante Sincronizar.

/worker-threads=N: establece el número de subprocesos que se ejecutan en paralelo durante Sincronizar.

/speed-limit=<number>: establece el límite de velocidad de copia de archivos en Kb/s.

Opciones de filtro de la tarea

Utilice estas opciones para controlar qué archivos y carpetas se incluyen o se excluyen cuando se ejecuta Analizar o Sincronizar en una tarea.

/exclude=<file-mask>: excluye los archivos y las carpetas que coinciden con la máscara especificada.

Las máscaras de archivo pueden usar patrones como *.obj o \folder\file.

Se pueden indicar varias opciones /exclude. Sus valores se combinan y se separan con |.

/include=<file-mask>: incluye los archivos y las carpetas que coinciden con la máscara especificada.

Las máscaras de archivo pueden usar patrones como *.obj o \folder\file.

Se pueden indicar varias opciones /include. Sus valores se combinan y se separan con |.

/exclude-empty=yes|no: excluye las carpetas vacías.

/exclude-hidden=yes|no: excluye los archivos y las carpetas ocultos.

/exclude-system=yes|no: excluye los archivos y las carpetas del sistema.

Opciones Auto de la tarea

Utilice estas opciones para controlar cuándo se ejecuta una tarea automáticamente, por ejemplo cuando cambian archivos, se conectan carpetas, se inicia GoodSync, se llega a una hora programada o se ejecuta un temporizador.

/on-file-change=analyze|sync|no: ejecuta Analizar o Sincronizar automáticamente cuando se detectan cambios en los archivos de las carpetas de sincronización locales.

/onfilechange-delay=NNN: establece el retraso de Al cambiar Archivo en segundos.

/on-folder-connect=analyze|sync|no: ejecuta Analizar o Sincronizar automáticamente cuando se conecta una carpeta.

/on-start=analyze|sync|no: ejecuta Analizar o Sincronizar automáticamente cuando se inicia GoodSync.

/autostart-delay=NNN: establece el retraso de On Start en segundos.

/on-timer=analyze|sync|no: ejecuta Analizar o Sincronizar automáticamente mediante un temporizador.

/timer-period=<NN>: establece el período del temporizador, en minutos, para /on-timer.

/on-logout=sync: ejecuta Sincronizar automáticamente al cerrar la sesión de la cuenta de Windows.

/on-schedule=analyze|sync|no: ejecuta Analizar o Sincronizar automáticamente según una programación.

/schedule-min=list-of-number-ranges (de 0 a 59): establece el minuto de la programación.

/schedule-hour=list-of-number-ranges (de 0 a 23): establece la hora de la programación.

/schedule-day=list-of-number-ranges (de 1 a 31): establece el día del mes de la programación.

/schedule-month=list-of-number-ranges (de 1 a 12): establece el mes de la programación.

/schedule-dow=list-of-number-ranges (de 0=domingo a 6=sábado): establece el día de la semana de la programación.

/auto-unattended=yes|no: ejecuta la tarea Auto en el servicio gs-runner.

/limit-changes=<NN>: no ejecuta Sincronizar si el porcentaje de archivos modificados es superior a NN.

/wait-for-locks=yes|no: espera a los archivos de bloqueo en lugar de producir un error.

/autoclear=yes|no: borra automáticamente el árbol de sincronización después de Sincronizar.

Opciones de conflictos

/resolve-weak-conflicts=yes|no: resuelve automáticamente los conflictos débiles cuando un lado no tiene generaciones.

/autoresolve=no|left|right|newer|stopsync: establece la opción Auto-Resolve Conflicts.

/rename-losing-file=yes|no: cambia el nombre del archivo perdedor en un conflicto en lugar de eliminarlo.

Opciones de script

Utilice estas opciones para ejecutar un programa o enviar un correo electrónico antes o después de Analizar o Sincronizar en una tarea.

/pre-analyze-action=<file-path>: ejecuta el programa especificado antes de Analizar.

/post-analyze-action=<email>|<file-path>: envía un correo electrónico o ejecuta el programa especificado después de Analizar.

/post-sync-action=<email>|<file-path>: envía un correo electrónico o ejecuta el programa especificado después de Sincronizar.

Opciones avanzadas

Utilice estas opciones para controlar el tratamiento de los archivos durante Analizar y Sincronizar, incluidos los métodos de comparación, los metadatos, los permisos, los archivos bloqueados, los vínculos simbólicos y el comportamiento específico de cada lado.

Opciones aplicadas durante Sincronizar

Utilice estas opciones para controlar cómo se tratan los archivos durante Sincronizar, incluidas las horas de los archivos, los atributos, los permisos, el comportamiento de movimiento, los archivos bloqueados y los archivos que cambian después de Analizar.

/do-not-sync-changed-files=yes|no: no sincroniza los archivos que cambiaron después de Analizar.

/wait-sync-after-analyze=seconds: espera el número de segundos especificado después de Analizar antes de iniciar Sincronizar.

/copy-create-time=yes|no: copia la hora de creación de los archivos y las carpetas.

/copy-attrs=yes|no: copia los bits de atributos de los archivos y las carpetas, como rwx.

/copy-ext-attrs=yes|no: copia los atributos extendidos. Se aplica solo a Mac.

/copy-owner=yes|no: copia la información del propietario de los archivos y las carpetas. No es necesaria cuando /copy-acl está habilitada.

/copy-acl=yes|no: copia la información de seguridad de ACL, incluidos el propietario y la ACL.

/move-mode=yes|no: elimina el origen después de copiar para emular Move.

/delete-empty-folders-on-move=yes|no: elimina las carpetas vacías cuando se usa Modo Mover.

/copy-locked=yes|no: copia los archivos bloqueados mediante el Shadow Copy Service.

/uber-unlocked=yes|no: habilita el modo Uber-Unlocked, que permite eliminar archivos que se están leyendo.

Opciones aplicadas durante Analizar

Utilice estas opciones para controlar cómo se comparan los archivos durante Analizar, incluidas las sumas de comprobación, la detección de movimientos, los vínculos simbólicos, las estimaciones del espacio necesario y los cambios en el lado de destino.

/compare-md5=yes|no: compara todos los archivos mediante sumas de comprobación MD5 durante Analizar.

/detect-moves=yes|no: detecta los movimientos y los cambios de nombre de archivos y carpetas en lugar de procesarlos como Copy y Delete.

/ignore-changes-on-dest-side: ignora los cambios en el lado de destino.

/est-req-space=yes|no: estima el espacio libre necesario para Sincronizar.

/links=ignore|copy-asis|drill-down: establece cómo se procesan los vínculos simbólicos.

/copy-original-fs-names=yes|no: conserva los nombres originales del sistema de archivos y no cambia los símbolos prohibidos. Se aplica a tareas de Mac a Mac.

Opciones de carpeta de los lados Izquierdo/Derecho

Utilice estas opciones para configurar los ajustes del lado izquierdo o derecho de una tarea, incluidas las reglas de comparación, el comportamiento del State File, los archivos temporales, la compresión, el cifrado y el tratamiento del sistema de archivos.

/compare-checksums1=yes|no /compare-checksums2=yes|no: compara las sumas de comprobación cuando es necesario en el Lado Izquierdo o Derecho.

/compare-ext-attrs1=yes|no /compare-ext-attrs2=yes|no: compara los atributos extendidos en el Lado Izquierdo o Derecho.

/compare-attrs1=yes|no /compare-attrs2=yes|no: compara los atributos en el Lado Izquierdo o Derecho.

/compare-owner1=yes|no /compare-owner2=yes|no: compara la información del propietario en el Lado Izquierdo o Derecho.

/compare-acl1=yes|no /compare-acl2=yes|no: compara la información de seguridad de ACL en el Lado Izquierdo o Derecho.

/no-gsdata1=yes|no /no-gsdata2=yes|no: no crea ni utiliza la carpeta _gsdata_ en el Lado Izquierdo o Derecho.

/no-listdir1=yes|no /no-listdir2=yes|no: no realiza ListDir y confía en el State File en el Lado Izquierdo o Derecho.

/temp-dest-file1=yes|no /temp-dest-file2=yes|no: utiliza archivos temporales al copiar al Lado Izquierdo o Derecho.

/compress-type1=no|plain|deflate /compress-type2=no|plain|deflate: establece el método utilizado para comprimir el contenido de los archivos en el Lado Izquierdo o Derecho.

/cipher-type1=no|zipcrypto|aes-256 /cipher-type2=no|zipcrypto|aes-256: establece el método utilizado para cifrar el contenido de los archivos en el Lado Izquierdo o Derecho.

/encrypt-files1=yes|no /encrypt-files2=yes|no: cifra el contenido de los archivos en el Lado Izquierdo o Derecho.

/encrypt-paths1=yes|no /encrypt-paths2=yes|no: cifra las rutas de los archivos en el Lado Izquierdo o Derecho.

/encrypt-password1=str /encrypt-password2=str: establece la contraseña de cifrado para el Lado Izquierdo o Derecho.

/fat-like1=yes|no /fat-like2=yes|no: trata el Lado Izquierdo o Derecho como un sistema de archivos de tipo FAT.

/compress1=yes|no /compress2=yes|no: utiliza la compresión NTFS en el Lado Izquierdo o Derecho.

/uncompress1=yes|no /uncompress2=yes|no: quita la compresión NTFS en el Lado Izquierdo o Derecho.

Códigos de retorno y de salida

GSYNC devuelve el código de salida de la última tarea que se ejecutó. Los scripts de automatización pueden usar este valor para determinar si la tarea se completó, se detuvo, encontró un error o finalizó con conflictos.

Código Resultado
0 Finalización normal: Analizar no encontró cambios o Sincronizar se completó correctamente.
1 Analizar no finalizó porque el usuario lo detuvo.
2 Analizar no finalizó debido a un error terminal, como una carpeta de sincronización inexistente.
3 Analizar finalizó con errores no terminales y posiblemente con conflictos.
4 Analizar finalizó con conflictos pero sin errores.
11 Sincronizar no finalizó porque el usuario lo detuvo.
12 Sincronizar no finalizó debido a un error terminal, como una carpeta de sincronización inexistente.
13 Sincronizar finalizó con errores no terminales y posiblemente con conflictos.
14 Sincronizar finalizó con conflictos pero sin errores.
Valor negativo Se produjo un error al iniciar GSYNC.

Importante: revise el registro de la tarea aunque un comando se complete. Es posible que algunas condiciones no terminales solo consten en el registro.

Comprobar el código de salida más reciente en el símbolo del sistema:

echo %ERRORLEVEL%

Comprobar el código de salida más reciente en PowerShell:

$LASTEXITCODE

Comprobar el código de salida más reciente en macOS o Linux:

echo $?

Redirigir la salida del comando a un archivo de registro en Windows:

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

Redirigir la salida del comando a un archivo de registro en macOS o Linux:

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

Solución de problemas de GSYNC

Problema Comprobación recomendada
No se encuentra el comando GSYNC Confirme que GoodSync está instalado y ejecute GSYNC desde su carpeta de instalación o agregue esa carpeta al PATH del sistema.
No se encuentra la tarea Ejecute gsync job-list, verifique el nombre exacto de la tarea y confirme que se ha cargado el perfil correcto.
La ruta o el nombre de la tarea contiene espacios Escriba el nombre completo de la tarea o la ruta completa entre comillas.
Acceso denegado Confirme los permisos del usuario o de la cuenta de servicio que ejecuta GSYNC en ambas carpetas de la tarea.
Falla la autenticación Verifique el Server Account, el ID de usuario, la contraseña, la clave privada, la autorización OAuth y el sufijo de la opción específica de cada lado.
La tarea está bloqueada Confirme que otro proceso de GoodSync o GSYNC no esté usando ya las mismas carpetas de sincronización antes de anular un bloqueo.
Se detectan cambios inesperados Ejecute solo Analizar y revise la dirección, los filtros, la configuración de eliminaciones, las opciones del State File y el perfil activo antes de ejecutar Sincronizar.
Se necesita más detalle en el registro Aumente el nivel de detalle del registro con /ll=<number> y dirija stdout a un archivo de registro.

Para ver la lista de comandos disponibles en la versión instalada, ejecute gsync /help o gsync /?.

Glosario de GSYNC

Analizar: compara ambos lados de la tarea y determina los cambios que realizaría Sincronizar.

Sincronizar: aplica las acciones determinadas durante Analizar.

Tarea (Job): un conjunto guardado de carpetas de sincronización, dirección, filtros y opciones de funcionamiento.

Perfil (Profile): la ubicación de configuración de GoodSync que contiene las tareas, los Server Accounts, las opciones del programa y los registros.

Lados Izquierdo y Derecho: las dos carpetas o sistemas de archivos que compara una tarea de GoodSync.

Server Account: una configuración guardada de conexión y autenticación para un sistema de archivos compatible.

Connectoid: las propiedades de conexión utilizadas para acceder a un sistema de archivos local, de red o remoto.

State File: datos de GoodSync que se usan para hacer un seguimiento del estado anterior de la tarea y determinar los cambios entre ejecuciones.

Runner: un proceso GSYNC en segundo plano que inicia y ejecuta las tareas configuradas en Auto Mode.

Auto Mode: configuración de la tarea que activa Analizar o Sincronizar según eventos, programaciones, temporizadores o la disponibilidad de las carpetas.

stdout: salida estándar de los comandos, que se puede mostrar en el terminal o redirigir a un archivo.

Para conocer los comandos compatibles con la versión instalada de GoodSync, utilice siempre gsync /help como referencia específica de esa versión.

Volver arriba