Uruchamianie synchronizacji za pomocą wiersza poleceń

Za pomocą polecenia sync-cmd i Google Cloud Directory Sync (GCDS) możesz przeprowadzać synchronizację z poziomu wiersza poleceń.

Kiedy można wykonywać synchronizację za pomocą wiersza poleceń

Zanim rozpoczniesz konfigurację lub ją zmodyfikujesz, wykonaj synchronizację ręczną przy użyciu Menedżera konfiguracji. Dzięki temu możesz sprawdzić zsynchronizowane dane i upewnić się, że są poprawne. Szczegółowe informacje znajdziesz w artykule Przeprowadzanie synchronizacji ręcznej.

Gdy skończysz wprowadzać zmiany w konfiguracji, możesz zautomatyzować proces synchronizacji, korzystając z wiersza poleceń. Synchronizacje możesz uwzględnić w dowolnym harmonogramie lub skrypcie wsadowym. Możesz też zautomatyzować synchronizację przy użyciu narzędzia innej firmy. Szczegółowe informacje znajdziesz w artykule Planowanie automatycznych synchronizacji.

Korzystanie z wiersza poleceń

Polecenie sync-cmd uruchom w katalogu instalacyjnym GCDS, wpisując je w jednym wierszu. Przy użyciu wymienionych poniżej argumentów polecenia możesz wykonać wiele czynności, na przykład:

  • zastosować wszystkie wykryte zmiany,
  • odczytać określony plik,
  • ustawić poziom szczegółowości rejestrowania.

Wskazówka: aby wyświetlić informacje o dostępnych argumentach polecenia, wpisz sync-cmd -h.

Argumenty polecenia i przykłady

Argumenty polecenia

Argument (użyj dowolnej opcji) Opis
-a
--apply		 Stosuje wszystkie wykryte zmiany.

Uwaga: jeśli nie użyjesz tego argumentu, zostanie przeprowadzona tylko synchronizacja testowa, a na koncie Google nie zostaną wprowadzone żadne zmiany. Aby uzyskać najlepsze wyniki, uruchom synchronizację testową bez tego argumentu, zanim wykonasz pełną synchronizację z jego użyciem.
-c
--config file-name		 Określa plik konfiguracji XML do załadowania.

Ważne: z tym argumentem musisz podać poprawny plik XML. Więcej informacji znajdziesz w artykule Praca z plikami konfiguracji.
-cs
--customschemas		 Wyklucza schematy niestandardowe.

Użyj tej opcji, jeśli nie chcesz synchronizować danych schematu niestandardowego użytkowników.
-d
--deletelimits		 Ignoruje skonfigurowane limity usuwania.
-f
--flush		 Przed uruchomieniem synchronizacji usuwa kopię danych konta Google przechowywaną w pamięci podręcznej.

Ważne: nieprawidłowe użycie może spowodować pogorszenie wydajności. Nie używaj tej opcji, jeśli nie poprosi Cię o to pracownik pomocy.
-g
--groups		 Wyklucza grupy.

Użyj tej opcji, jeśli chcesz synchronizować użytkowników, ale nie grupy.
-h
--help		 Wyświetla pomoc i kończy działanie aplikacji.
-l
--loglevel value		 Zastępuje domyślny lub skonfigurowany poziom rejestrowania określoną wartością. Prawidłowe wartości (kolejność według rosnącej liczby szczegółów) to FATAL, ERROR, WARN, INFO, DEBUG i TRACE.

W większości przypadków zalecamy ustawienie poziomu rejestrowania na INFO.
-lic
--license		 Wyklucza licencje.

Użyj tej opcji, jeśli nie chcesz synchronizować danych licencji na kontach użytkowników.
-o
--oneinstance

Ogranicza wszystkie uruchomione synchronizacje do jednego wystąpienia na plik konfiguracji XML. Zapobiega to niezamierzonemu uruchomieniu wielu wystąpień (na przykład w wyniku działania algorytmu szeregowania lub zadania cron). Ten argument jest prawidłowy tylko z argumentem -a.

Jeśli potrzebujesz pomocy przy rozwiązywaniu problemów, przeczytaj ten artykuł.
-ou
--orgunit		 Wyklucza jednostki organizacyjne.
-r
--report-out		 Zapisuje raporty w określonym pliku wyjściowym oprócz zapisywania ich w dzienniku.
-s
--sharedcontacts		 Wyklucza udostępnione kontakty.
-u
--users		 Wyklucza użytkowników.

Użyj tej opcji, jeśli chcesz synchronizować grupy, ale nie użytkowników.
-v Wyświetla krótkie informacje o wersji aplikacji.
-V Wyświetla szczegółowe informacje o wersji aplikacji, ale ich nie synchronizuje.

Przykłady

Windows

Przykład 1: uruchomienie symulowanej synchronizacji przy użyciu pliku konfiguracji XML C:\Użytkownicy\użytkownik\gdcs-config.xml:

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

Przykład 2: uruchomienie pełnej synchronizacji z zastosowaniem zmian przy użyciu pliku konfiguracji XML C:\Użytkownicy\użytkownik\gdcs-config.xml:

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

Linux

Przykład 1: uruchomienie symulowanej synchronizacji przy użyciu pliku konfiguracji XML /ścieżka/gcds-config.xml:

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

Przykład 2: uruchomienie pełnej synchronizacji z zastosowaniem zmian przy użyciu pliku konfiguracji XML /ścieżka/gcds-config.xml:

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

Sprawdzanie kodu wyjścia

Po uruchomieniu synchronizacji lub symulacji z poziomu wiersza poleceń otrzymasz jeden z tych kodów wyjścia:

  • 0 – synchronizacja została ukończona bez problemów, a żadna zmiana nie przekracza skonfigurowanych limitów.
  • 255 – symulacja została ukończona. Synchronizacja została ukończona, lecz wystąpiły problemy, np. zmiany przekraczające skonfigurowane limity lub niepowodzenie synchronizacji użytkownika.

Następny krok

Zalecamy monitorowanie wszystkich synchronizacji przez regularne sprawdzanie komunikatów z powiadomieniami. Więcej informacji znajdziesz w artykule na temat ustawiania powiadomień.


Google, Google Workspace i inne powiązane nazwy są znakami towarowymi Google LLC. Wszystkie inne nazwy firm i produktów są znakami towarowymi odpowiednich podmiotów.