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 programada 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:

  • Aplicar los cambios detectados
  • Leer un archivo especificado
  • Establecer el nivel de detalle del registro

Sugerencia: Para obtener información sobre los argumentos de comando disponibles, ingresa sync-cmd -h.

Argumentos y ejemplos de comandos

Argumentos del comando

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

Nota: Si no usas este argumento, la sincronización se ejecuta solo como prueba y no se realizan 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 en formato XML válido con este argumento. Para obtener más información, consulta Cómo trabajar con archivos de configuración.
-cs
--customschemas		 Excluye los esquemas personalizados.

Usa esta opción si no quieres sincronizar datos de esquemas personalizados 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 causar 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 los 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 las licencias.

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

Restringe las sincronizaciones 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 involuntaria (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 las unidades organizativas.
-r
--report-out		 Escribe informes en un archivo de salida especificado, además del registro.
-s
--sharedcontacts		 Excluye los contactos compartidos.
-u
--users		 Excluye los usuarios.

Usa esta opción si quieres 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, se completó la sincronización 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 notificaciones 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 comerciales de Google LLC. Todos los demás nombres de productos y empresas son marcas comerciales de las empresas con las que se encuentran asociados.