排解 GWMME 問題

Google Workspace Migration for Microsoft Exchange

如果您在使用 Google Workspace Migration for Microsoft Exchange (GWMME) 時遇到問題,可以透過該產品中的測試、報表和記錄排解問題。如需詳細說明,請參閱下方的「排解問題」一節,瞭解如何解決常見的 GWMME 遷移問題。

試用 Log 分析工具

大多數情況下,這項工具很快就能確認問題癥結所在。

GWMME 追蹤記錄位於電腦的以下位置:C:\Users\*使用者名稱*\AppData\Local\Google\Google Apps Migration\Tracing\ExchangeMigration

如要查看 GWMME 追蹤記錄檔範例,請參閱下方的檢查記錄一節。

使用 GWMME 進行疑難排解

GWMME 產品中的測試和報表可以協助您排解遷移問題。

方法 說明 更多資訊
診斷測試 如要找出設定或使用者清單方面的問題,請在遷移資料前執行診斷測試。這項公用程式可提示錯誤,並在輸出畫面中顯示相關資訊。 GWMME 管理指南》的「Migrate data」(遷移資料) 一章
遷移報表

遷移作業執行完成後,請查看遷移報告,瞭解過程中是否發生錯誤、發生錯誤的原因及受到影響的使用者。

注意:這些報告資料會儲存在本機電腦的 Microsoft Windows 使用者設定檔中,僅供執行 GWMME 的 Windows 使用者查看。

GWMME 管理指南》的「Migration reports」(遷移報表) 一章

排解問題

請參考下列說明以及常見遷移問題的建議解決方法。

修正遷移問題 | 修正遷移失敗問題 | 解讀錯誤訊息 | Google Workspace 服務與 GWMME

修正遷移問題

無法建立管理員的 Exchange 設定檔

這個問題的可能原因如下:

  • Exchange 伺服器並未執行。
  • 網路問題導致用戶端電腦無法與 Exchange 伺服器連線。如要驗證連線狀態,請透過用戶端電腦對伺服器進行連線偵測 (ping)。
  • 您使用的 Exchange 伺服器或管理員名稱有誤。如何驗證這項資訊:
    1. 在用戶端電腦上依序點選「控制台」 接下來「郵件」,為您要用於遷移作業的管理員帳戶建立 Microsoft Outlook 設定檔。
    2. 在 GWMME 中的步驟 1「Server Details」(伺服器詳細資料) 畫面上進行以下操作:
      • 在「主機名稱/IP 位址」欄位中,輸入設定檔中的 Exchange 主機名稱。
      • 在「Admin username」(管理員使用者名稱) 欄位中,輸入設定檔中的使用者名稱。

如果您是從代管伺服器遷移資料,管理員帳戶的設定檔必須採用預設設定才能連線至伺服器。如果您從「控制台」 接下來「郵件」 接下來「設定檔名稱」 接下來「內容」 接下來「電子郵件帳戶」 接下來「設定檔名稱」 接下來「變更電子郵件帳戶」 接下來「其他設定」 中修改任何設定,就會導致連線失敗。

Exchange 伺服器無法識別我要用於遷移作業的管理員名稱

請確認您輸入的管理員名稱和密碼正確無誤。

如果問題仍未解決,請確認您輸入的 Exchange 伺服器名稱正確無誤:

  1. 在用戶端電腦上依序點選「控制台」接下來「郵件」,為您要用於遷移作業的管理員帳戶建立 Outlook 設定檔。
  2. 在 GWMME 中的步驟 1「Server Details」(伺服器詳細資料) 畫面上進行以下操作:
    • 在「主機名稱/IP 位址」欄位中,輸入設定檔中的 Exchange 主機名稱。
    • 在「Admin username」(管理員使用者名稱) 欄位中,輸入設定檔中的使用者名稱。

GWMME 啟動後不久隨即當機

如果 GWMME 在啟動後不久隨即當機,請確認您是在用戶端電腦而非在 Exchange 伺服器上執行 GWMME,因為在伺服器上執行公用程式可能導致當機。詳情請參閱 Microsoft 說明文件。

如果您認為 GWMME 可能是因為負載平衡問題而當機,請參閱《GWMME 管理指南》的「Prepare your Windows client machines」(準備 Windows 用戶端電腦) 一節。

防毒軟體或外掛程式造成的問題

在遷移期間,電腦上執行的其他程序 (例如防毒、搜尋或備份等軟體) 有時會中斷 GWMME 對資料庫檔案的存取作業。如果發生這類問題,記錄檔會顯示以下錯誤代碼:

0x80040109
Fail:While stamping the message

雖然郵件已遷移完畢,但 GWMME 並未儲存遷移成功的資訊。如果您在勾選「Only New Data」(僅限新資料) 的情況下重新執行遷移作業,GWMME 會嘗試再次遷移這些郵件。這項操作不會產生重複的郵件,但可能導致日曆活動或聯絡人重複。

修正遷移失敗問題

單一使用者的遷移作業失敗

如有使用者的遷移作業失敗,請確認以下事項:

  • 使用者檔案中的使用者名稱或 SMTP 地址格式正確無誤。
  • 使用者在全域通訊清單 (GAL) 中並未受到隱藏。
  • 使用者在 Exchange 伺服器擁有帳戶。
  • 使用者已登入 Google Workspace、接受《服務條款》,並完成 Google Workspace 帳戶建立作業。

OAuth 錯誤導致遷移失敗

下列疑難排解步驟通常可解決所有 GWMME OAuth 驗證錯誤:

  • 確定您已按照「為帳戶授權 GWMME」一文的說明,為網域正確授權軟體。
  • 確認 CSV 檔案列出的 Google Workspace 使用者和密碼正確無誤。即使 CSV 檔案中只有一項錯誤,也可能造成遷移失敗。詳情請參閱「為遷移作業建立 CSV 檔案」。
  • 在您執行 GWMME 的電腦上,確認系統時鐘設定的時間正確無誤。如果電腦的時鐘有誤差,系統會在執行 OAuth 驗證檢查時將錯誤的本機時間戳記傳送至 Google 伺服器,進而導致遷移失敗。請將您的電腦與網際網路時間伺服器保持同步。
  • 確認用於驗證 GWMME 的 Google Workspace 超級管理員帳戶有效,且您在 GWMME 設定中輸入的使用者名稱正確無誤。

Google Workspace 中沒有該名使用者,導致遷移作業失敗

GWMME 不會在 Google Workspace 中佈建使用者。請先建立 Google Workspace 使用者帳戶,再開始遷移資料。

解讀錯誤訊息

檢查網路或傳輸層安全標準 (TLS) 問題的記錄檔

如果您遇到網路錯誤 (例如網路逾時和連線遭拒等) 或者安全資料傳輸層/傳輸層安全標準問題 (亦稱 SSL/TLS 問題,例如安全連線問題),相關記錄會顯示這項工具嘗試連線的 IP 位址。如果有安全連線問題,記錄中會顯示原因 (例如憑證名稱不符、憑證已過期或無法檢查 CRL 等等) 和憑證詳細資料 (例如 Google 憑證或 HTTPS 檢查 Proxy)。有了這些記錄,應該就能大幅減少需要取得網路擷取資料來排解問題的情況。無論是主要記錄 (Trace-*.log) 還是授權記錄 (位於「Identity」資料夾) 都很有參考價值。

授權記錄範例

[2022-09-21T03:59:46:ERROR:windows_http.cc(331)] TLS connection failure. See details below. [Status: 0x00010000. Status Info: 0x00000001]
[2022-09-21T03:59:46:ERROR:windows_http.cc(340)] Certificate details:
---Validity--
Valid from: 2017-09-13 17:23:55 UTC
Valid until: 2017-12-06 17:10:00 UTC
---Subject---
US
California
Mountain View
Google Inc
*.googleapis.com
---Issuer----
US
Google Inc
Google Internet Authority G2
-------------
[2022-09-21T03:59:46:ERROR:windows_http.cc(282)] WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED: Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable.
[2022-09-21T03:59:46:ERROR:windows_http.cc(197)] Error from API WinHttpSendRequest with WinHTTP proxy. Will try direct (without proxy). Code: 0x00002f8f
[2022-09-21T03:59:46:ERROR:windows_http.cc(107)] Network connection destination details: 216.58.194.170:443 (sfo07s13-in-f170.1e100.net)

上例顯示,由於電腦上當前日期的年份已變更為 2022 年,導致系統誤以為憑證已經過期。您可以在每行記錄的開頭找到當前日期,並發現該日期晚於憑證的「Valid from」和「Valid until」日期。出現 WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED 錯誤標記則代表系統未能檢查憑證撤銷情況。

在最後一行記錄的「Network connection destination details」後方,您也可以找到目的地 IP 位址和經過解析的主機名稱。這個 1e100.net address 即代表 Google。

追蹤記錄範例

注意:以下範例是 GWMMO 的記錄。當 GWMME、密碼同步或 GWSMO 遇到網路/TLS 問題時,這些產品中也會顯示類似的追蹤記錄項目。

2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2025 ()> Secure connection failure. Status: 0x00010000. Info 0x00000009
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2030 ()> Failure details:
WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED: Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable.
WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA: The function is unfamiliar with the Certificate Authority that generated the server's certificate.
Certificate details:
---Validity--
Valid from: 2016-09-20T04:08:45.000Z
Valid until: 2022-09-20T04:08:45.000Z
---Subject---
Created by http://www.fiddler2.com
DO_NOT_TRUST
*.google.com
---Issuer----
Created by http://www.fiddler2.com
DO_NOT_TRUST
DO_NOT_TRUST_FiddlerRoot
-------------
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2071 ()> Error result 5, hr = 0x80072f8f. Setting event 0000000000001638.
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2076 ()> Network connection destination details: 127.0.0.1:8888 (COMPUTERNAME)

上例顯示使用者已安裝 Fiddler 並設定使用這項工具來執行 HTTPS 解密作業 (這表示 Fiddler 使用的是自身的憑證),但是因為相關憑證已從 Windows 的信任憑證清單中移除,所以 Fiddler 處於不受信任的狀態。請注意,由於 Fiddler 是 Proxy,所以是連線至 127.0.0.1 (而不是 Google)。錯誤標記包含 WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA,代表系統不信任憑證授權單位 (CA). 。另請注意,此例中的憑證不是由 Google 核發。

遷移作業失敗,發生 0x80070005 錯誤

輸出畫面或追蹤記錄檔會顯示類似以下內容的錯誤訊息:

E:Generic ExchangeMigration!SetPropertyGuid @ 641 (user@example.com)> Failed with 0x80070005, last successful line = 637.

造成這個問題的原因通常是使用者帳戶不具備必要權限。如要解決這個問題,請務必在 Exchange 將「接收身分」權限授予帳戶。

如果帳戶具備「接收身分」權限,錯誤卻仍未解決,表示您的 Exchange 環境可能要求使用者帳戶須同時具備「傳送身分」權限。

從 Exchange 2010 遷移資料時發生 GWMME 0x80004005 錯誤

部分使用者無法從 Exchange 2010 遷移資料,並且會在追蹤記錄檔中收到「Failed with 0x80004005」錯誤訊息。記錄中還包括以下內容:

  • 對 Exchange 2010 隨機發出的 MAPI 呼叫。
  • 在 Exchange Server 2010 用戶端存取伺服器中,遠端程序呼叫 (RPC) 用戶端存取記錄顯示「BufferTooSmall」錯誤。

這是 Exchange 2010、Outlook 2007 和 Outlook 2010 的已知問題。您可能需要更新至 Exchange 2010 SP2 RU3。詳情請參閱有關 MAPI 呼叫失敗錯誤的 Microsoft 說明文件。

郵件無法上傳,並產生 0x8004106a 錯誤

如果記錄中多次出現 500、502 和 503 這些 HTTP 錯誤代碼,而且郵件無法上傳並顯示 0x8004106a 錯誤代碼,表示目標信箱可能發生問題,原因通常是負載過高。

如要解決這個問題,請避免過度使用目標信箱。您可以:

  • 停用所有同步處理用戶端 (例如 IMAP、POP、行動裝置和郵件用戶端)。
  • 一次只從一個來源遷移郵件。

Google Workspace 服務與 GWMME

經過遷移的 Google 日曆活動未正確更新

如果發生下列問題,表示您並未正確佈建使用者:

  • 系統未將日曆活動的變更和參與者共用。
  • 日曆通知及更新未反映到參與者的日曆上。

即使您只要執行局部遷移作業,也請先在 Google Workspace 中佈建所有使用者,再開始遷移帳戶。請務必新增所有網域別名和暱稱。接著,如要解決這個問題,請將使用者身為主辦人或邀請對象的活動全部刪除,然後重新建立活動。

遷移聯絡人和日曆時發生 403 錯誤和相關問題

根據預設,GWMME 遷移資料的速率為每秒 25 位使用者,超出了 Contacts API 和 Calendar API 的預設每秒查詢次數 (QPS)。

如要解決這個問題,請按照下列方式執行聯絡人和日曆的遷移作業:

  • 與電子郵件遷移作業分開執行。
  • 將速率調降至每秒 4 至 8 位使用者。

部分郵件無法遷移

如有部分郵件無法遷移,表示這些郵件可能超出 Gmail 規定的大小限制,或含有 Gmail 封鎖的附件類型。詳情請參閱「Gmail 封鎖的檔案類型」。

您可能也需要移除資料夾大小限制,並確保資料夾能透過 IMAP 顯示。詳情請參閱「為使用者啟用及停用 POP 和 IMAP」。

Gmail 所含的郵件數量與我的來源帳戶不符

Google Workspace 會在遷移完成後「估算」您收件匣中的郵件數量,估算結果不一定符合實際數量,因此 Gmail 收件匣顯示的郵件數量可能會與舊收件匣不同。

如果發現有部分郵件遺失,請確認:

  • 該郵件 (含附件) 大小未超過 25 MB (您無法遷移大小超過 25 MB 的郵件)。詳情請參閱「透過 Gmail 郵件傳送附件」。
  • Gmail 並未封鎖該郵件的附件 (Gmail 禁用特定類型的附件,例如執行檔)。詳情請參閱「Gmail 封鎖的檔案類型」。
  • 本次遷移涵蓋該郵件所在的資料夾或日期範圍。

郵件遺失或遷移後的郵件寄件者/收件者有誤

執行 Exchange 或 PST 檔案遷移作業時,可能會發生郵件遺失,或者遷移後的郵件寄件者或收件者有誤等問題。系統可能遺漏了郵件寄件者或收件者的 SMTP 地址,因此改用 Exchange X.500 地址。如果未建立全域通訊清單 (GAL) 設定檔,或是已從 GAL 中移除使用者,就可能會發生這個問題。

GWMME 如果發現 X.500 地址,會怎麼樣?

GWMME 如果發現 X.500 地址,會搜尋已在遷移伺服器上註冊且與 X.500 Exchange 機構名稱相同的 MAPI 郵件設定檔。如果找到這個設定檔,GWMME 會使用 MAPI 郵件設定檔中的通訊錄註冊來解析 X.500 地址。

如果 GWMME 在 Exchange 通訊錄中找不到這項資訊,則會嘗試將 X.500 地址轉換為 SMTP 地址。為了執行這項作業,GSMME 會評估 X.500 地址的最後一個 CN 值,並將這個值用作電子郵件地址使用者名稱。舉例來說,X.500 地址 /O=ExchangeOrg/OU=CA/CN=RECIPIENTS/CN=EX_ALIAS 會轉換為 SMTP 電子郵件地址 ex_alias@example.com。

如何使用 Exchange 通訊錄解析 X.500 地址

  1. 在執行遷移作業的伺服器上建立 (非快取模式) MAPI 郵件設定檔。
  2. 確認您已在要用於執行 PST 遷移作業的伺服器上設定 MAPI 郵件設定檔。
  3. MAPI 郵件設定檔必須連線至原始 Exchange 伺服器,GWMME 才能使用 GAL 正確解析收件者。
  4. 透過目前登入的使用者或服務帳戶設定 MAPI 郵件設定檔,避免發生驗證錯誤。

重要注意事項

測試並確認您已妥善設定遷移作業。如果問題沒有解決,即使您再次執行遷移作業,系統也不會更新已遷移到 Google 帳戶的資料。請刪除電子郵件資料,並將刪除的資料從垃圾桶中移除,然後再重新遷移。

Gmail 中的郵件顯示錯誤日期

已遷移的郵件可能會顯示「遷移」日期和時間,而非原始郵件的時間和日期。

這很有可能是因為原始郵件的日期標頭不符合 RFC 5322 規範。如果郵件的日期標頭格式不正確,Gmail 就會為該郵件套用遷移時間和日期。

我收到「User neither attendee or organizer for event」警告訊息

這是因為您為特定使用者匯入某些活動,但這些使用者並非活動的原始發起人或參與者。

即使您收到這則警告訊息,系統仍會將該活動遷移至 Google Workspace,並在 Google 日曆中將 Google Workspace 目標使用者顯示為活動的參與者。這是必要的功能設計,因為如果使用者不是日曆活動的發起人或參與者,Google 日曆就不會對其顯示該活動的相關資訊。


Google、Google Workspace 和其他相關符號及標誌均為 Google LLC 的商標,所有其他公司和產品名稱則是與個別公司關聯的商標。