使用指令列執行同步處理

您可以使用 sync-cmd 指令和 Google Cloud Directory Sync (GCDS) 透過指令列執行同步處理作業。

何時可透過指令列執行同步處理

配置或修改設定時，您應該透過「設定管理員」執行手動同步處理，以便檢查同步資料，並確認資料內容正確無誤。詳情請參閱「執行手動同步處理」。

完成設定變更後，即可使用指令列讓同步處理程序自動化。您可以在任何排程執行的指令碼或批次指令碼中加入同步指令。或者，您也可以使用第三方工具自動進行同步。詳情請參閱「安排自動同步處理時間」。

使用指令列

請從 GCDS 的安裝目錄中執行 sync-cmd 指令 (每行僅限輸入一組指令)。您可以使用下列指令引數執行各種操作，例如：

• 套用系統偵測到的所有變更。
• 讀取指定的檔案。
• 設定記錄的詳細程度。

提示：如要取得可用指令引數的相關資訊，請輸入 sync-cmd -h。

指令引數和範例

全部展開  |  全部收合並返回頁首

指令引數

引數 (使用任一選項)	說明
-a --apply	套用系統偵測到的所有變更。 注意：如果您並未使用這個引數，系統只會以測試的方式執行同步處理，不會對您的 Google 帳戶進行任何變更。最理想的做法是一開始不要使用這個引數，先進行測試性的同步處理作業，然後再加上這個引數來執行完整的同步處理。
-c --config 檔案名稱	指定要載入的 XML 設定檔。 重要事項：您必須使用這個引數指定有效的 XML 檔案。詳情請參閱「使用設定檔處理作業」。
-cs --customschemas	排除自訂結構定義。 如果您不想同步處理使用者的自訂架構資料，請使用這個引數。
-d --deletelimits	忽略已設定的刪除限制。
-f --flush	執行同步處理前，請先清除 Google 帳戶資料的快取副本。 重要資訊：使用方式不正確可能會導致效能降低。除非支援小組指示您使用這個選項，否則請勿使用。
-g --groups	排除群組。 如要同步處理使用者，但不將群組保持同步，請使用這個引數。
-h --help	顯示說明資訊，然後自動結束指令。
-l --loglevel 值	以特定的值覆寫預設或設定好的記錄層級。有效的值是 FATAL、ERROR、WARN、INFO、DEBUG 和 TRACE (依資料詳細程度遞增排列)。 在大部分情況下，我們建議您將記錄層級設為「INFO」。
-lic --license	排除授權。 如果您不想同步處理使用者的授權資料，請使用這個引數。
-o --oneinstance	限制目前執行的所有同步處理作業，只透過單一執行個體處理個別 XML 設定檔。這種做法可防止多個執行個體在意外情況下同時運作 (例如受到排程器或 Cron 工作影響)。引數僅適用於 -a 引數。 如要排解問題，請參閱「為什麼 GCDS 無法透過指令列執行同步處理？」
-ou --orgunit	排除機構單位。
-r --report-out	系統除了將報告寫入記錄，也會將報告寫入指定的輸出檔案中。
-s --sharedcontacts	排除共用聯絡人。
-u --users	排除使用者。 如要同步處理群組，但不將使用者保持同步，請使用這個引數。
-v	顯示簡要的應用程式版本資訊。
-V	顯示詳細的應用程式版本資訊，但不同步處理該資訊。

範例

Windows

範例 1：使用 XML 設定檔 (路徑為 C:\Users\user\gdcs-config.xml) 執行模擬同步處理作業：

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

範例 2：使用 XML 設定檔 (路徑為 C:\Users\user\gdcs-config.xml) 執行完整同步處理作業，包括套用系統偵測到的所有變更：

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

Linux

範例 1：使用 XML 設定檔 (路徑為 /path/gcds-config.xmll) 執行模擬同步處理作業：

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

範例 2：使用 XML 設定檔 (路徑為 /path/gcds-config.xml) 執行完整同步處理作業，包括套用系統偵測到的所有變更：

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

查看結束程式碼

透過指令列執行同步處理或模擬作業後，您會取得下列其中一個結束程式碼：

• 0：同步處理完成，且沒有任何同步處理問題，所有修改內容皆未超出設定限制。
• 255：模擬作業已完成，或是同步處理作業完成但有發生同步處理問題，例如修改項目超出設定限制，或使用者無法同步。

下一步

建議您定期檢查所有通知訊息，藉此監控所有同步處理作業。詳情請參閱「設定通知」。

_{Google、Google Workspace 與相關符號和標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。}