Đồng bộ hoá bằng dòng lệnh

Bạn có thể sử dụng lệnh sync-cmd và Google Cloud Directory Sync (GCDS) để chạy quá trình đồng bộ hoá từ dòng lệnh.

Thời điểm đồng bộ hoá từ dòng lệnh

Khi thiết lập hoặc sửa đổi cấu hình, bạn nên chạy quá trình đồng bộ hoá thủ công từ Trình quản lý cấu hình. Việc này cho phép bạn kiểm tra dữ liệu đã đồng bộ hoá và đảm bảo dữ liệu đó được sắp xếp đúng thứ tự. Để biết thông tin chi tiết, hãy chuyển đến phần Thực hiện quá trình đồng bộ hoá thủ công.

Sau khi hoàn tất việc thay đổi cấu hình, bạn có thể tự động hoá quy trình đồng bộ hoá bằng dòng lệnh. Bạn có thể kết hợp quá trình đồng bộ hoá vào bất kỳ tập lệnh hàng loạt hoặc lên lịch nào mà bạn muốn sử dụng. Ngoài ra, bạn có thể sử dụng một công cụ của bên thứ ba để tự động hoá quá trình đồng bộ hoá. Để biết thông tin chi tiết, hãy chuyển đến phần Lên lịch đồng bộ hoá tự động.

Sử dụng dòng lệnh

Bạn chạy lệnh sync-cmd từ thư mục cài đặt GCDS và nhập lệnh trên một dòng. Bạn có thể sử dụng các đối số lệnh được liệt kê bên dưới để thực hiện một loạt hành động, chẳng hạn như:

  • Áp dụng mọi thay đổi được phát hiện.
  • Đọc một tệp được chỉ định.
  • Đặt cấp độ chi tiết ghi nhật ký.

Mẹo: Bạn có thể xem thông tin về các đối số lệnh hiện có bằng cách nhập sync-cmd -h.

Đối số lệnh và ví dụ

Đối số lệnh

Đối số (sử dụng một trong hai lựa chọn) Mô tả
-a
--apply		 Áp dụng mọi thay đổi được phát hiện.

Lưu ý: Nếu bạn không sử dụng đối số này, thì quá trình đồng bộ hoá sẽ chỉ chạy dưới dạng kiểm thử và không có thay đổi nào được thực hiện đối với Tài khoản Google của bạn. Để có kết quả tốt nhất, hãy chạy quá trình đồng bộ hoá kiểm thử mà không có đối số này trước khi chạy quá trình đồng bộ hoá đầy đủ có đối số này.
-c
--config file-name		 Chỉ định tệp cấu hình XML cần tải.

Quan trọng: Bạn phải đưa một tệp XML hợp lệ vào đối số này. Để biết thông tin chi tiết, hãy chuyển đến phần Làm việc với tệp cấu hình.
-cs
--customschemas		 Loại trừ các lược đồ tuỳ chỉnh.

Hãy sử dụng lựa chọn này nếu bạn không muốn đồng bộ hoá dữ liệu lược đồ tuỳ chỉnh cho người dùng.
-d
--deletelimits		 Bỏ qua các giới hạn xoá đã định cấu hình.
-f
--flush		 Xoá bản sao được lưu trong bộ nhớ đệm của dữ liệu trong Tài khoản Google trước khi chạy quá trình đồng bộ hoá.

Quan trọng: Việc sử dụng không đúng cách có thể làm giảm hiệu suất. Đừng sử dụng lựa chọn này trừ phi được bộ phận hỗ trợ hướng dẫn.
-g
--groups		 Loại trừ các nhóm.

Hãy sử dụng lựa chọn này nếu bạn muốn đồng bộ hoá người dùng nhưng không đồng bộ hoá nhóm.
-h
--help		 Hiển thị thông tin trợ giúp và thoát.
-l
--loglevel value		 Ghi đè cấp độ nhật ký mặc định hoặc đã định cấu hình bằng một giá trị được chỉ định. Các giá trị hợp lệ (theo thứ tự tăng dần về mức độ chi tiết) là FATAL, ERROR, WARN, INFO, DEBUG và TRACE.

Trong hầu hết các trường hợp, bạn nên đặt cấp độ nhật ký thành INFO.
-lic
--license		 Loại trừ giấy phép.

Hãy sử dụng lựa chọn này nếu bạn không muốn đồng bộ hoá dữ liệu giấy phép cho người dùng.
-o
--oneinstance

Hạn chế mọi quá trình đồng bộ hoá đang chạy thành một thực thể duy nhất cho mỗi tệp cấu hình XML. Việc này giúp ngăn nhiều thực thể chạy vô tình (ví dụ: thông qua một trình lên lịch hoặc dịch vụ chạy ngầm theo thời gian định trước). Đối số này chỉ hợp lệ với đối số -a.

Để khắc phục sự cố, hãy chuyển đến phần Tại sao GCDS không chạy quá trình đồng bộ hoá từ dòng lệnh?
-ou
--orgunit		 Loại trừ các đơn vị tổ chức.
-r
--report-out		 Ghi báo cáo vào một tệp đầu ra được chỉ định, ngoài nhật ký.
-s
--sharedcontacts		 Loại trừ các danh bạ dùng chung.
-u
--users		 Loại trừ người dùng.

Hãy sử dụng lựa chọn này nếu bạn muốn đồng bộ hoá nhóm nhưng không đồng bộ hoá người dùng.
-v Hiển thị thông tin ngắn gọn về phiên bản ứng dụng.
-V Hiển thị thông tin chi tiết về phiên bản ứng dụng nhưng không đồng bộ hoá thông tin đó.

Ví dụ

Windows

Ví dụ 1: Chạy quá trình đồng bộ hoá mô phỏng bằng tệp cấu hình XML C:\Users\user\gdcs-config.xml:

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

Ví dụ 2: Chạy quá trình đồng bộ hoá đầy đủ, bao gồm cả việc áp dụng mọi thay đổi được phát hiện, bằng tệp cấu hình XML C:\Users\user\gdcs-config.xml:

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

Linux

Ví dụ 1: Chạy quá trình đồng bộ hoá mô phỏng bằng tệp cấu hình XML /path/gcds-config.xml:

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

Ví dụ 2: Chạy quá trình đồng bộ hoá đầy đủ, bao gồm cả việc áp dụng mọi thay đổi được phát hiện, bằng tệp cấu hình XML /path/gcds-config.xml:

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

Xem mã thoát

Sau khi chạy quá trình đồng bộ hoá hoặc mô phỏng từ dòng lệnh, bạn sẽ nhận được một trong các mã thoát sau:

  • 0—Quá trình đồng bộ hoá đã hoàn tất mà không gặp vấn đề nào về đồng bộ hoá và tất cả các sửa đổi đều không vượt quá giới hạn đã định cấu hình.
  • 255 – Quá trình mô phỏng đã hoàn tất. Hoặc quá trình đồng bộ hoá đã hoàn tất và có các vấn đề về đồng bộ hoá, chẳng hạn như các sửa đổi vượt quá giới hạn đã định cấu hình hoặc người dùng không đồng bộ hoá được.

Bước tiếp theo

Bạn nên theo dõi tất cả các quá trình đồng bộ hoá bằng cách thường xuyên kiểm tra xem có thông báo nào hay không. Để biết thông tin chi tiết, hãy chuyển đến phần Đặt thông báo.


Google, Google Workspace và những nhãn hiệu cũng như biểu tượng có liên quan là nhãn hiệu của Google LLC. Tất cả các tên sản phẩm và công ty khác là nhãn hiệu của những công ty mà chúng liên kết.