Вы можете использовать команду sync-cmd и Google Cloud Directory Sync (GCDS), чтобы запускать синхронизацию из командной строки.
В каких случаях следует выполнять синхронизацию из командной строки
На этапе настройки или изменения конфигурации необходимо выполнить синхронизацию вручную в Диспетчере конфигураций. Это позволит проверить данные и убедиться, что синхронизация выполнена правильно. Подробнее о том, как выполнить синхронизацию вручную…
После завершения настройки можно автоматизировать синхронизацию с помощью командной строки. Вы можете включить синхронизацию в любой скрипт, например выполняемый по расписанию. Кроме того, команды можно использовать при автоматизации с помощью сторонних инструментов. Подробнее о настройке графика автоматической синхронизации…
Как использовать командную строку
Выполните команду sync-cmd из каталога установки GCDS. Ее следует вводить в одной строке. С помощью перечисленных ниже аргументов можно выполнять различные действия, например:
- применять обнаруженные изменения;
- читать указанный файл;
- задавать уровень детализации журналов.
Совет. Чтобы посмотреть информацию о доступных аргументах, выполните команду sync-cmd -h.
Аргументы команды и примеры их использования
Аргументы команды
| Аргумент (используйте любой из вариантов) | Описание |
|---|---|
-a |
Применяет обнаруженные изменения.
Примечание. Без этого аргумента синхронизация запускается в тестовом режиме и не приводит к изменениям в аккаунте Google. Для оптимального результата рекомендуется сначала запустить синхронизацию в тестовом режиме, а уже потом добавить аргумент и повторить операцию. |
-c |
Задает XML-файл конфигурации, который нужно загрузить.
Важно! Команда не будет работать, если не указать корректно составленный XML-файл. Подробнее о том, как работать с файлами конфигурации… |
-cs |
Исключает специальные схемы.
Задайте этот аргумент, если не хотите синхронизировать данные специальных схем для пользователей. |
-d |
Игнорирует установленные ограничения на удаление. |
-f |
Удаляет кешированную копию данных аккаунта Google перед выполнением синхронизации.
Важно! Неправильное применение этого аргумента может снижать производительность системы. Используйте его, только получив указания от службы поддержки. |
-g |
Исключает группы.
Этот аргумент позволяет пропустить группы и синхронизировать только пользователей. |
-h |
Открывает Справку и завершает работу. |
-l |
Устанавливает заданный уровень ведения журнала, переопределяя установленное ранее или используемое по умолчанию значение. Допустимы следующие значения (по возрастанию уровня детализации): FATAL, ERROR, WARN, INFO, DEBUG, TRACE.
В большинстве ситуаций рекомендуем задавать уровень ведения журнала INFO. |
-lic |
Исключает лицензии.
Задайте этот аргумент, если не хотите синхронизировать данные лицензий для пользователей. |
-o |
Ограничивает выполнение синхронизации до одного экземпляра на каждый XML-файл конфигурации. Это позволяет предотвратить случайный запуск нескольких экземпляров, например с помощью планировщика или задания Cron. Аргумент можно использовать только с аргументом Сведения об устранении неполадок можно найти в разделе Почему GCDS не выполняет синхронизацию при ее запуске с помощью командной строки? |
-ou |
Исключает организационные подразделения. |
-r |
Записывает отчеты не только в журнал, но и в указанный файл выходных данных. |
-s |
Исключает общие контакты. |
-u |
Исключает пользователей.
Этот аргумент позволяет синхронизировать только группы, а пользователей пропускать. |
-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. Все другие названия компаний и продуктов являются товарными знаками соответствующих компаний.