Anda dapat menggunakan perintah sync-cmd dan Google Cloud Directory Sync (GCDS) untuk menjalankan sinkronisasi dari command line.
Kapan sebaiknya menggunakan command line untuk sinkronisasi
Saat menyiapkan atau mengubah konfigurasi, Anda harus menjalankan sinkronisasi manual dari Configuration Manager. Tindakan ini memungkinkan Anda memeriksa data yang disinkronkan dan memastikannya sudah sesuai keinginan. Untuk mengetahui detailnya, buka Melakukan sinkronisasi manual.
Setelah selesai melakukan perubahan konfigurasi, Anda dapat mengotomatiskan proses sinkronisasi menggunakan command line. Anda dapat menyertakan sinkronisasi ke dalam skrip penjadwalan atau skrip batch mana saja yang ingin digunakan. Sebagai alternatif, Anda dapat menggunakan alat pihak ketiga untuk mengotomatiskan sinkronisasi. Untuk mengetahui detailnya, buka Menjadwalkan sinkronisasi otomatis.
Menggunakan command line
Jalankan perintah sync-cmd dari direktori penginstalan GCDS dan masukkan perintah pada satu baris. Anda dapat menggunakan argumen perintah yang tercantum di bawah untuk melakukan berbagai tindakan seperti:
- Menerapkan perubahan apa pun yang terdeteksi.
- Membaca file tertentu.
- Menyetel tingkat detail logging.
Tips: Anda bisa mendapatkan informasi tentang argumen perintah yang tersedia dengan memasukkan sync-cmd -h.
Argumen perintah & contoh
Luaskan semua | Ciutkan semua & ke bagian atas
Argumen perintah| Argumen (gunakan salah satu opsi) | Deskripsi |
|---|---|
-a |
Menerapkan perubahan apa pun yang terdeteksi.
Catatan: Jika Anda tidak menggunakan argumen ini, sinkronisasi hanya dijalankan sebagai uji coba, dan Akun Google Anda tidak akan mengalami perubahan apa pun. Untuk mendapatkan hasil terbaik, jalankan sinkronisasi uji coba tanpa argumen ini sebelum menjalankan sinkronisasi penuh dengan argumen tersebut. |
-c |
Menentukan file konfigurasi XML yang akan dimuat.
Penting: Anda harus menyertakan file XML yang valid dengan argumen ini. Untuk mengetahui detailnya, buka Menangani file konfigurasi. |
-cs |
Mengecualikan skema kustom.
Gunakan opsi ini jika Anda tidak ingin menyinkronkan data skema kustom untuk pengguna. |
-d |
Mengabaikan batas penghapusan yang dikonfigurasi. |
-f |
Menghapus salinan data Akun Google yang disimpan dalam cache sebelum menjalankan sinkronisasi.
Penting: Penggunaan yang tidak benar dapat menyebabkan penurunan performa. Jangan gunakan opsi ini kecuali jika diperintahkan untuk melakukannya oleh dukungan. |
-g |
Mengecualikan grup.
Gunakan opsi ini jika Anda ingin menyinkronkan pengguna tanpa menyinkronkan grup. |
-h |
Menampilkan informasi bantuan lalu keluar. |
-l |
Mengganti tingkat log default atau yang dikonfigurasi dengan nilai tertentu. Nilai yang valid (dari yang kurang sampai paling detail) adalah FATAL, ERROR, WARN, INFO, DEBUG, dan TRACE.
Dalam kebanyakan kasus, sebaiknya setel tingkat log ke INFO. |
-lic |
Mengecualikan lisensi.
Gunakan opsi ini jika Anda tidak ingin menyinkronkan data lisensi untuk pengguna. |
-o |
Membatasi setiap sinkronisasi yang berjalan agar hanya melibatkan satu instance per file konfigurasi XML. Tindakan ini mencegah beberapa instance berjalan secara tidak sengaja (misalnya, melalui scheduler atau cron job). Argumen ini hanya valid dengan argumen Untuk memecahkan masalah, buka Mengapa GCDS tidak menjalankan sinkronisasi dari command line? |
-ou |
Mengecualikan unit organisasi. |
-r |
Menulis laporan pada file output tertentu, selain log. |
-s |
Mengecualikan kontak bersama. |
-u |
Mengecualikan pengguna.
Gunakan opsi ini jika Anda ingin menyinkronkan grup tanpa menyinkronkan pengguna. |
-v |
Menampilkan informasi versi aplikasi singkat. |
-V |
Menampilkan informasi versi aplikasi mendetail, namun tidak menyinkronkannya. |
Windows
Contoh 1: Menjalankan sinkronisasi simulasi menggunakan file konfigurasi XML C:\Users\user\gdcs-config.xml:
sync-cmd -c C:\Users\pengguna\gdcs-config.xml
Contoh 2: Menjalankan sinkronisasi penuh, termasuk menerapkan perubahan apa pun yang terdeteksi, menggunakan file konfigurasi XML C:\Users\user\gdcs-config.xml:
sync-cmd -a -c C:\Users\pengguna\gdcs-config.xml
Linux
Contoh 1: Menjalankan sinkronisasi simulasi menggunakan file konfigurasi XML /path/gcds-config.xml:
sync-cmd -c /path/gcds-config.xml
Contoh 2: Menjalankan sinkronisasi penuh, termasuk menerapkan perubahan apa pun yang terdeteksi, menggunakan file konfigurasi XML /path/gcds-config.xml:
sync-cmd -a -c /path/gcds-config.xml
Meninjau kode keluar
Setelah menjalankan sinkronisasi atau simulasi dari command line, Anda akan mendapatkan salah satu kode keluar berikut:
- 0—Sinkronisasi selesai tanpa masalah sinkronisasi dan semua modifikasi tidak melebihi batas yang dikonfigurasi.
- 255—Simulasi selesai. Atau, sinkronisasi selesai dan ada masalah sinkronisasi, seperti modifikasi yang melebihi batas yang dikonfigurasi atau pengguna gagal menyinkronkan.
Langkah berikutnya
Google, Google Workspace, serta merek dan logo yang terkait adalah merek dagang Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang masing-masing perusahaan yang terkait.
