使用指令列執行同步處理

您可以使用 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`	顯示詳細的應用程式版本資訊，但不同步處理該資訊。

範例

查看結束程式碼

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

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

下一步

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

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

選擇要提供意見的區段

這對您有幫助嗎？

我們應如何改進呢？

使用指令列執行同步處理

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

使用指令列

指令引數和範例

Windows

Linux

查看結束程式碼

下一步

這對您有幫助嗎？

還有其他問題嗎？

嘗試以下步驟：

這個部分有什麼問題？

分享更多資訊或建議