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. Więcej informacji 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
Rozwiń wszystko | Zwiń wszystko i przejdź na górę strony
Argumenty polecenia| Argument (użyj dowolnej opcji) | Opis |
|---|---|
-a |
Stosuje wszystkie wykryte zmiany.
Uwaga: jeśli nie użyjesz tego tagu, zostanie przeprowadzona tylko synchronizacja testowa, a w domenie Google nie zostaną zastosowane ż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. |
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:\Użytkownicy\użytkownik\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:\Użytkownicy\użytkownik\gdcs-config.xml
Komputery z systemem Linux
Przykład 1: uruchomienie symulowanej synchronizacji przy użyciu pliku konfiguracji XML /ścieżka/gcds-config.xml:
sync-cmd -c /ścieżka/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 /ścieżka/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
Google, Google Workspace oraz powiązane znaki i logotypy są znakami towarowymi firmy Google LLC. Wszystkie inne nazwy firm i produktów są znakami towarowymi odpowiednich podmiotów.
