Exchange Online 中 IMAP 迁移批处理的 CSV 文件

项目
04/04/2023

在 IMAP 迁移中你用于迁移用户邮箱的内容的逗号分隔值 (CSV) 文件包含每个用户的行。每行都包含有关用户的 Office 365 邮箱和 IMAP 邮箱的信息，并且 Office 365 使用此信息来处理迁移。

必需的特性

以下是每个用户的必需特性：

EmailAddress 指定用户的 Office 365 邮箱的用户 ID。
UserName 指定 IMAP 服务器上的用户邮箱的用户登录名。可以使用用户名或域\用户名格式。例如，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 服务器上设置虚拟共享文件夹后迁移邮箱，你需要将可选属性 UserRoot 包括在 CSV 文件中。此特性可指定每个用户的邮箱在 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

通过