Синхронизация с помощью командной строки

Для выполнения синхронизации из командной строки можно использовать команду sync-cmd и Google Cloud Directory Sync (GCDS).

Когда следует выполнять синхронизацию из командной строки?

При настройке или изменении конфигурации следует выполнить ручную синхронизацию через Configuration Manager. Это позволит проверить синхронизированные данные и убедиться в их корректности. Подробности см. в разделе «Выполнение ручной синхронизации» .

После внесения изменений в конфигурацию вы можете автоматизировать процесс синхронизации с помощью командной строки. Вы можете интегрировать синхронизацию в любой скрипт планирования или пакетный скрипт по вашему желанию. В качестве альтернативы вы можете использовать сторонний инструмент для автоматизации синхронизации. Подробности см. в разделе «Планирование автоматической синхронизации» .

Используйте командную строку

Вы запускаете команду sync-cmd из каталога установки GCDS, вводя команду в одну строку. Вы можете использовать приведенные ниже аргументы команды для выполнения ряда действий, таких как:

  • Примените все обнаруженные изменения.
  • Прочитать указанный файл.
  • Установите уровень детализации логирования.

Совет : Информацию о доступных аргументах команды можно получить, введя sync-cmd -h .

Аргументы и примеры команд

Аргументы команды

Аргумент (используйте любой из вариантов) Описание
-a
--apply		 Применяет все обнаруженные изменения.

Примечание: Если вы не используете этот аргумент, синхронизация будет выполнена только в тестовом режиме, и никаких изменений в вашу учетную запись Google не будет внесено. Для достижения наилучших результатов выполните тестовую синхронизацию без этого аргумента, прежде чем запускать полную синхронизацию с ним.

-c
--config file-name		 Указывает XML-файл конфигурации для загрузки.

Важно : к этому аргументу необходимо приложить действительный XML-файл. Подробнее см. раздел «Работа с файлами конфигурации» .

-cs
--customschemas		 Исключаются пользовательские схемы.

Используйте этот параметр, если вы не хотите синхронизировать данные пользовательской схемы для пользователей.

-d
--deletelimits		 Игнорирует установленные ограничения на удаление.
-f
--flush		 Перед запуском синхронизации очищает кэшированную копию данных вашей учетной записи Google.

Важно : Неправильное использование может привести к снижению производительности. Не используйте эту опцию без рекомендации службы поддержки.

-g
--groups		 Исключаются группы.

Используйте этот параметр, если хотите синхронизировать пользователей, но не группы.

-h
--help		 Информационные табло и указатели выходов.
-l
--loglevel value		 Заменяет уровень детализации логирования по умолчанию или заданный пользователем значение. Допустимые значения (в порядке возрастания детализации): FATAL, ERROR, WARN, INFO, DEBUG и TRACE.

В большинстве случаев мы рекомендуем установить уровень детализации логов на INFO.

-lic
--license		 Исключая лицензии.

Используйте этот параметр, если вы не хотите синхронизировать данные лицензий для пользователей.

-o
--oneinstance

Ограничивает выполнение любых синхронизаций одним экземпляром на каждый XML-файл конфигурации. Это предотвращает непреднамеренное запуск нескольких экземпляров (например, через планировщик или задание cron). Этот аргумент действителен только с аргументом -a .

Для устранения неполадок перейдите к разделу «Почему GCDS не выполняет синхронизацию из командной строки?»

-ou
--orgunit		 Исключая организационные подразделения.
-r
--report-out		 Помимо журнала, записывает отчеты в указанный выходной файл.
-s
--sharedcontacts		 Исключаются общие контакты.
-u
--users		 Исключает пользователей.

Используйте этот параметр, если хотите синхронизировать группы, но не отдельных пользователей.

-v Отображает краткую информацию о версии приложения.
-V Отображает подробную информацию о версии приложения, но не синхронизирует её.

Примеры

Windows

Пример 1 : Запустите имитацию синхронизации, используя XML-файл конфигурации C:\Users\user\gdcs-config.xml:

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

Пример 2 : Выполните полную синхронизацию, включая применение всех обнаруженных изменений, используя XML-файл конфигурации C:\Users\user\gdcs-config.xml:

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

Linux

Пример 1: Выполните имитацию синхронизации, используя XML-файл конфигурации /path/gcds-config.xml:

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

Пример 2: Выполните полную синхронизацию, включая применение всех обнаруженных изменений, используя XML-файл конфигурации /path/gcds-config.xml:

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

Проверьте код завершения

После запуска синхронизации или моделирования из командной строки вы получите один из следующих кодов завершения:

  • 0 — Синхронизация завершена без каких-либо проблем, и все изменения не превышают заданные пределы.
  • 255 — Моделирование завершено. Или синхронизация завершена, но возникли проблемы с синхронизацией, например, изменения превысили установленные лимиты или пользователь не смог выполнить синхронизацию.

Следующий шаг

Рекомендуется регулярно отслеживать все синхронизации, проверяя наличие уведомлений. Подробную информацию см. в разделе «Настройка уведомлений» .


Google, Google Workspace, а также связанные с ними знаки и логотипы являются товарными знаками Google LLC. Все остальные названия компаний и продуктов являются товарными знаками компаний, с которыми они связаны.