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ć, czy zsynchronizowane dane są prawidłowe. 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 |
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 |
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 |
Wyklucza schematy niestandardowe.
Użyj tej opcji, jeśli nie chcesz synchronizować danych schematu niestandardowego użytkowników. |
-d |
Ignoruje skonfigurowane limity usuwania. |
-f |
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 |
Wyklucza grupy.
Użyj tej opcji, jeśli chcesz synchronizować użytkowników, ale nie grupy. |
-h |
Wyświetla pomoc i kończy działanie aplikacji. |
-l |
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 |
Wyklucza licencje.
Użyj tej opcji, jeśli nie chcesz synchronizować danych licencji na kontach użytkowników. |
-o |
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 Jeśli potrzebujesz pomocy przy rozwiązywaniu problemów, przeczytaj ten artykuł. |
-ou |
Wyklucza jednostki organizacyjne. |
-r |
Zapisuje raporty w określonym pliku wyjściowym oprócz zapisywania ich w dzienniku. |
-s |
Wyklucza udostępnione kontakty. |
-u |
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.