在 Exchange Online 中用於 IMAP 移轉批次的 CSV 檔案

發行項
04/04/2023

IMAP 移轉會使用逗點分隔值 (CSV) 檔案來移轉使用者信箱的內容，該檔案每一列僅列出一個使用者。每一列包含使用者 Office 365 信箱和 IMAP 信箱的相關資訊，而 Office 365 會使用此資訊來處理移轉程序。

必要屬性

以下是供每個使用者使用的必要屬性。

EmailAddress 指定使用者 Office 365 信箱的使用者識別碼。
UserName 指定 IMAP 伺服器上使用者信箱的使用者登入名稱。您可以使用使用者名稱或 domain\username 格式。例如，hollyh 或 contoso\hollyh。
Password 是 IMAP 郵件系統中使用者帳戶的密碼。

如果這些屬性中有任何一個未包含在 CSV 檔案的標題列中，移轉將會失敗。此外，請務必完全依照屬性顯示的格式輸入這些屬性。屬性不可包含空格。它們必須是一個單字。例如， Email Address 無效。您必須使用 EmailAddress 。

CSV 檔案格式

以下是 CSV 檔案格式的範例。在此範例中，會使用使用者認證來移轉三個信箱：

EmailAddress,UserName,Password
terrya@contoso.edu,contoso\terry.adams,1091990
annb@contoso.edu,contoso\ann.beebe,2111991
paulc@contoso.edu,contoso\paul.cannon,3281986

CSV 檔案的第一列 (或標題列) 會列出屬性或欄位 (在後續列中指定) 的名稱。每個屬性名稱皆以逗號分隔。

標題列底下的每一列都代表一個使用者，並且提供將用來移轉使用者信箱的資訊。每一列中屬性值的順序都必須與標題列中屬性名稱的順序相同。每個屬性值皆以逗號分隔。

使用任何文字編輯器或 Microsoft Excel 之類的應用程式來建立 CSV 檔案。將檔案儲存為.csv 或.txt 檔案。

提示

如果 CSV 檔案包含非 ASCII 或特殊字元，請以 UTF-8 或其他 Unicode 編碼來儲存 CSV 檔案。視應用程式而定，當電腦的系統地區設定與 CSV 檔案中使用的語言相符時，以 UTF-8 或其他 Unicode 編碼來儲存 CSV 檔案可能會比較容易。

將大型移轉分成數個批次

CSV 檔案最多可以包含 50,000 個資料列，一列一個使用者，檔案最大可達 10 MB。但是最好是分成數個較小的批次來移轉使用者。

如果您打算移轉大量使用者，請決定每個批次中要包含哪些使用者。舉例來說，如果您有 10,000 帳戶要進行移轉，您可以分成四個批次來執行，每個批次包含 2,500 個使用者。您也可以依字母順序、依使用者類型 (例如教職員、學生及校友)、依年級 (例如大一、大二、大三及大四) 或以其他符合您組織需求的方式，來劃分批次。

提示

其中一個策略是建立 Office 365 信箱，然後移轉同一群使用者的電子郵件。例如，如果您將 100 個新使用者匯入 Microsoft 365 或Office 365組織，請為相同的 100 位使用者建立移轉批次。這個方法可有效組織和管理從內部部署郵件系統移轉到 Office 365 的程序。

提供使用者或系統管理員認證

在 CSV 檔案中，您必須提供使用者內部部署帳戶的使用者名稱和密碼。這可讓移轉程式存取帳戶。執行這項作業的方法有兩種：

使用使用者認證：這需要您取得使用者的密碼，或是將其密碼變更為您知道的值，才能將其包含在 CSV 檔案中。

提示

如果您使用此選項，請防止使用者變更其內部部署帳戶的密碼。如果使用者在初始移轉後變更其密碼，則 IMAP 伺服器上信箱與 Office 365 信箱之間的後續同步處理將會失敗。
使用進階使用者或系統管理員認證：這需要您在 IMAP 訊息系統中使用具有存取所有使用者信箱必要許可權的帳戶。在 CSV 檔案中，您會針對每個資料列使用此帳戶的認證。若要瞭解您的 IMAP 伺服器是否支援此方法，以及如何加以啟用，請參閱 IMAP 伺服器的檔。

注意事項

建議使用系統管理員認證，因為這不會影響使用者或對使用者造成不便。舉例來說，如果使用者在初始移轉後變更其密碼，使用這個方法將不會有任何影響。

適用於不同 IMAP 伺服器的系統管理員認證格式

您可以在 CSV 檔案的每個資料列的 [ 使用者 名稱] 和 [密碼] 欄位中，使用系統管理員帳戶的使用者名稱和密碼。系統管理員認證的使用者名稱是要移轉電子郵件之人員的使用者名稱，以及有權存取所有使用者信箱之系統管理員帳戶的使用者名稱。支援的系統管理員認證格式會依據您要從中移轉電子郵件的 IMAP 伺服器而有所不同。如需有關如何使用系統管理員認證的詳細資訊，請參閱您 IMAP 伺服器的文件。

注意事項

當您送出新的移轉要求時，CSV 檔案會透過安全通訊端層 (SSL) 連線上傳到 Microsoft 資料中心。 CSV 檔案中的資訊會經過加密並儲存在位於 Microsoft 資料中心的 Microsoft Exchange 伺服器上。

下列各節將針對從不同類型的 IMAP 伺服器移轉電子郵件時所使用的 CSV 檔案，說明如何設定其中系統管理員認證的格式。

Microsoft Exchange

如果您要從 Microsoft Exchange 的 IMAP 實作移轉電子郵件，請針對 CSV 檔案中的 UserName 屬性使用 Domain/Admin_UserName/User_UserName 格式。假設您要從 Exchange 移轉 Terry Adams、Ann Beebe 及 Paul Cannon 的電子郵件。您有一個郵件系統管理員帳戶，其中的使用者名稱是 mailadmin，密碼會P@ssw0rd。您的 CSV 檔案看起來會像這樣：

EmailAddress,UserName,Password
terrya@contoso.edu,contoso-students/mailadmin/terry.adams,P@ssw0rd
annb@contoso.edu,contoso-students/mailadmin/ann.beebe,P@ssw0rd
paulc@contoso.edu,contoso-students/mailadmin/paul.cannon,P@ssw0rd

Dovecot

對於支援簡單驗證和安全性層 (SASL) 的 IMAP 伺服器，例如 Dovecot IMAP 伺服器，請使用 User_UserName*Admin_UserName格式，其中星號 ( * ) 是可設定的分隔符號。假設您要使用系統管理員認證 mailadmin 和 P@ssw0rd 從 Dovecot IMAP 伺服器移轉這些相同使用者的電子郵件。您的 CSV 檔案看起來會像這樣：

EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams*mailadmin,P@ssw0rd
annb@contoso.edu,ann.beebe*mailadmin,P@ssw0rd
paulc@contoso.edu,paul.cannon*mailadmin,P@ssw0rd

Mirapoint

如果您要從 Mirapoint Message Server 移轉電子郵件，請針對系統管理員認證使用 #user@domain#Admin_UserName# 格式。若要使用系統管理員認證 mailadmin 和 P@ssw0rd 從 Mirapoint 移轉電子郵件，您的 CSV 檔案看起來會像這樣：

EmailAddress,UserName,Password
terrya@contoso.edu,#terry.adams@contoso-students.edu#mailadmin#,P@ssw0rd
annb@contoso.edu,#ann.beebe@contoso-students.edu#mailadmin#,P@ssw0rd
paulc@contoso.edu,#paul.cannon@contoso-students.edu#mailadmin#,P@ssw0rd

使用選擇性 UserRoot 屬性

有些 IMAP 伺服器 (例如 Courier IMAP) 不支援使用系統管理員認證將信箱移轉到 Office 365。若要使用系統管理員認證來移轉信箱，您可以將您的 IMAP 伺服器設定成使用虛擬共用資料夾。虛擬共用資料夾可讓系統管理員使用系統管理員的登入認證來存取 IMAP 伺服器上的使用者信箱。如需有關如何為 Courier IMAP 設定虛擬共用資料夾的詳細資訊，請參閱共用資料夾。

在 IMAP 伺服器上設定虛擬共用資料夾之後，若要移轉信箱，您必須在 CSV 檔案中包含選擇性屬性 UserRoot 。這個屬性可指定 IMAP 伺服器上虛擬共用資料夾結構中每個使用者信箱的位置。

以下是包含 UserRoot 屬性的 CSV 檔案範例：

EmailAddress,UserName,Password,UserRoot
terrya@contoso.edu,mailadmin,P@ssw0rd,/users/terry.adams
annb@contoso.edu,mailadmin,P@ssw0rd,/users/ann.beebe
paulc@contoso.edu,mailadmin,P@ssw0rd,/users/paul.cannon

共用方式為