Sincroniza con la línea de comandos

Puedes usar el comando sync-cmd y Google Cloud Directory Sync (GCDS) para ejecutar sincronizaciones desde la línea de comandos.

Cuándo sincronizar desde la línea de comandos

Cuando configures o modifiques tu configuración, debes ejecutar una sincronización manual desde el Administrador de configuración. De esta manera, puedes verificar los datos sincronizados y asegurarte de que estén en orden. Para obtener más información, consulta Cómo realizar una sincronización manual.

Después de realizar los cambios de configuración, puedes automatizar el proceso de sincronización con la línea de comandos. Puedes incorporar sincronizaciones en cualquier secuencia de comandos de programación o por lotes que desees usar. Como alternativa, puedes usar una herramienta externa para automatizar las sincronizaciones. Para obtener más información, consulta Cómo programar la sincronización automática.

Usa la línea de comandos

Ejecuta el comando sync-cmd desde el directorio de instalación de GCDS y, luego, ingresa el comando en una sola línea. Puedes usar los argumentos de comando que se indican a continuación para realizar una variedad de acciones, como las siguientes:

  • Aplica los cambios detectados.
  • Lee un archivo especificado.
  • Establece el nivel de detalle del registro.

Nota: Puedes obtener información sobre los argumentos de comandos disponibles ingresando sync-cmd -h.

Argumentos y ejemplos de comandos

Argumentos del comando

Argumento (usa una de las dos opciones) Descripción
-a
--apply		 Aplica los cambios detectados.

Nota: Si no usas este argumento, la sincronización se ejecutará solo como prueba y no se realizarán cambios en tu Cuenta de Google. Para obtener los mejores resultados, ejecuta una sincronización de prueba sin este argumento antes de ejecutar una sincronización completa con él.
-c
--config file-name		 Especifica el archivo de configuración XML que se cargará.

Importante: Debes incluir un archivo XML válido con este argumento. Para obtener más información, consulta Cómo trabajar con archivos de configuración.
-cs
--customschemas		 Se excluyen los esquemas personalizados.

Usa esta opción si no quieres sincronizar los datos del esquema personalizado para los usuarios.
-d
--deletelimits		 Ignora los límites de eliminación configurados.
-f
--flush		 Borra la copia almacenada en caché de los datos de tu Cuenta de Google antes de ejecutar la sincronización.

Importante: El uso inadecuado puede provocar una degradación del rendimiento. No uses esta opción a menos que el equipo de asistencia al cliente te lo indique.
-g
--groups		 Excluye grupos.

Usa esta opción si quieres sincronizar usuarios, pero no grupos.
-h
--help		 Muestra información de ayuda y sale.
-l
--loglevel value		 Anula el nivel de registro predeterminado o configurado con un valor especificado. Los valores válidos (en orden creciente de detalle) son FATAL, ERROR, WARN, INFO, DEBUG y TRACE.

En la mayoría de los casos, te recomendamos que establezcas el nivel de registro en INFO.
-lic
--license		 Excluye licencias.

Usa esta opción si no quieres sincronizar los datos de licencias de los usuarios.
-o
--oneinstance

Restringe cualquier sincronización en ejecución a una sola instancia por archivo de configuración XML. De esta manera, se evita que se ejecuten varias instancias de forma inadvertida (por ejemplo, a través de un programador o un trabajo cron). El argumento solo es válido con el argumento -a.

Para solucionar problemas, consulta ¿Por qué GCDS no ejecuta una sincronización desde la línea de comandos?
-ou
--orgunit		 Excluye unidades organizativas.
-r
--report-out		 Escribe informes en un archivo de salida especificado, además del registro.
-s
--sharedcontacts		 No incluye los contactos compartidos.
-u
--users		 Excluye a los usuarios.

Usa esta opción si deseas sincronizar grupos, pero no usuarios.
-v Muestra información breve sobre la versión de la aplicación.
-V Muestra información detallada sobre la versión de la aplicación, pero no la sincroniza.

Ejemplos

Windows

Ejemplo 1: Ejecuta una sincronización simulada con el archivo de configuración XML C:\Users\user\gdcs-config.xml:

sync-cmd -c C:\Users\user\gdcs-config.xml

Ejemplo 2: Ejecuta una sincronización completa, incluida la aplicación de los cambios detectados, con el archivo de configuración XML C:\Users\user\gdcs-config.xml:

sync-cmd -a -c C:\Users\user\gdcs-config.xml

Linux

Ejemplo 1: Ejecuta una sincronización simulada con el archivo de configuración XML /path/gcds-config.xml:

sync-cmd -c /path/gcds-config.xml

Ejemplo 2: Ejecuta una sincronización completa, incluida la aplicación de los cambios detectados, con el archivo de configuración XML /path/gcds-config.xml:

sync-cmd -a -c /path/gcds-config.xml

Revisa el código de salida

Después de ejecutar la sincronización o la simulación desde la línea de comandos, obtendrás uno de los siguientes códigos de salida:

  • 0: La sincronización se completó sin problemas y todas las modificaciones no superan los límites configurados.
  • 255: Se completó la simulación. O bien, la sincronización se completó y hay problemas de sincronización, como modificaciones que superaron los límites configurados o un usuario que no se pudo sincronizar.

Próximo paso

Debes supervisar todas las sincronizaciones y verificar si hay mensajes de notificación con regularidad. Para obtener más información, consulta Cómo configurar tus notificaciones.


Google, Google Workspace y las marcas y los logotipos relacionados son marcas de Google LLC. Todos los demás nombres de productos y empresas son marcas de las empresas con las que se encuentran asociados.