Для запуска синхронизации из командной строки можно использовать команду sync-cmd и Google Cloud Directory Sync (GCDS).
Когда следует выполнять синхронизацию из командной строки
При настройке или изменении конфигурации следует запустить синхронизацию вручную из Configuration Manager. Это позволит проверить синхронизированные данные и убедиться в их правильности. Подробнее см. в статье «Выполнение синхронизации вручную» .
После внесения изменений в конфигурацию вы можете автоматизировать процесс синхронизации с помощью командной строки. Вы можете включить синхронизацию в любой планировщик или пакетный скрипт. Кроме того, вы можете использовать сторонний инструмент для автоматизации синхронизации. Подробнее см. в статье «Планирование автоматической синхронизации» .
Используйте командную строку
Команда 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 | Отображает подробную информацию о версии приложения, но не синхронизирует ее. |
Примеры
Окна
Пример 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
Линукс
Пример 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. Все остальные названия компаний и продуктов являются товарными знаками компаний, с которыми они связаны.