Menyinkronkan menggunakan command line

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 --apply	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 --config file-name	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 --customschemas	Mengecualikan skema kustom. Gunakan opsi ini jika Anda tidak ingin menyinkronkan data skema kustom untuk pengguna.
-d --deletelimits	Mengabaikan batas penghapusan yang dikonfigurasi.
-f --flush	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 --groups	Mengecualikan grup. Gunakan opsi ini jika Anda ingin menyinkronkan pengguna tanpa menyinkronkan grup.
-h --help	Menampilkan informasi bantuan lalu keluar.
-l --loglevel value	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 --license	Mengecualikan lisensi. Gunakan opsi ini jika Anda tidak ingin menyinkronkan data lisensi untuk pengguna.
-o --oneinstance	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 -a. Untuk memecahkan masalah, buka Mengapa GCDS tidak menjalankan sinkronisasi dari command line?
-ou --orgunit	Mengecualikan unit organisasi.
-r --report-out	Menulis laporan pada file output tertentu, selain log.
-s --sharedcontacts	Mengecualikan kontak bersama.
-u --users	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.

Contoh

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

Anda harus memantau semua sinkronisasi dengan memeriksa pesan pemberitahuan secara rutin. Untuk mengetahui detailnya, buka Menyetel notifikasi.

_{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.}