如果您無法設定及執行 Google Cloud Directory Sync (GCDS)，請先嘗試自行解決問題：
準備聯絡支援團隊
如果問題持續發生，請先收集下列資訊，再向支援團隊尋求協助。
步驟 1：檢查 GCDS 版本
在與支援團隊聯絡前，請確認您執行的 GCDS 是最新版本。 在許多情況下，只要使用新版 GCDS 就可以解決問題。如需最新版本的詳細資訊，請參閱「Google Cloud Directory Sync 版本資訊」。
如要找出版本號碼，請採取下列任一做法：
- 開啟「設定管理員」，然後依序前往「說明」
「關於」。 - 執行 sync-cmd -V 指令。
步驟 2：使用 Directory API Explorer 再次嘗試同步
GCDS 會與 Directory API 互動，在貴組織的目錄與您在目錄中設定的使用者、群組和其他外部聯絡人之間同步資料。如果問題發生在同步處理期間，您可以使用 Directory API Explorer 再次嘗試同步處理，判斷問題是出在 GCDS 還是 Directory API。詳情請參閱「Admin SDK：Directory API」。
步驟 3：說明問題和受影響的實體
您預期的目標為何？實際發生的情況為何？哪些類型的資料受到影響？
範例
- 預期的目標是不要修改使用者 Alex (alex@example.com)，但 GCDS 刪除了這位使用者。
- 預期的目標是讓 GCDS 將 alex@example.com 的住家地址設為 1800 Amphibious Blvd, Mountain View, CA 94045，但 GCDS 卻將其設為加州。
步驟 4：匯出 LDAP 資料交換格式 (LDIF) dump
如果問題會影響特定物件，請匯出屬性；如有必要，請一併提供受影響物件的屬性資料。如果您使用的是 Microsoft Active Directory，可以透過 LDIFDE 指令匯出這份資料。詳情請參閱「如何從 LDAP 目錄匯出資料？」。
步驟 5：回報目前的 XML 設定檔
回報您目前的 XML 設定檔。這個檔案的預設名稱是 Untitled-1.xml，位在 GCDS 使用者的設定檔資料夾 (Windows) 或 homedir (Linux) 中。
步驟 6：提供 LDAP 伺服器和 OS 詳細資料
- 包括您目前使用的 LDAP 目錄伺服器廠牌和版本
- 請提供您執行 GCDS 所用的電腦作業系統
步驟 7：收集追蹤層級同步處理記錄檔
如何啟用追蹤層級記錄功能：
- 在「設定管理員」的「Logging」(記錄) 頁面中，將「Log Level」(記錄層級) 變更為「TRACE」(追蹤)。
- 將記錄檔名稱變更為其他名稱，以便在下次同步時建立新的記錄檔。這可確保先前不相關的同步內容不會包括在內。
- 在「設定管理員」中開啟「Sync」(同步處理) 頁面。
- 如果問題只有在執行以下作業時才會發生：
- 模擬：按一下「Simulate sync」(模擬同步處理)。
- 完整同步處理：按一下「Sync & apply changes」(同步處理與套用變更)。
下一步
Google、Google Workspace 和其他相關符號及標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。