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