适用于邮箱迁移的 CSV 文件

适用于:Exchange Server 2013

您可以使用 CSV 文件批量迁移大量用户邮箱。 使用 Exchange 管理中心 (EAC) 或 Exchange 命令行管理程序 中的 New-MigrationBatch cmdlet,您可以指定一个 CSV 文件来创建迁移批处理。 如果出现以下迁移情况,支持使用 CSV 文件指定要通过迁移批处理迁移的多个用户:

  • 移入本地 Exchange 组织

    • 本地移动: 本地移动是指将邮箱从一个邮箱数据库移动到另一个邮箱数据库的情况。 本地移动发生在单个林内部。

    • 跨林企业移动: 在跨林企业移动中,将邮箱移到一个不同的林。 跨林移动可从目标林(邮箱移动的目标林)启动,也可从源林(当前托管邮箱的林)启动。

    • Onboarding and offboarding in Exchange Online

    • 加入远程移动迁移: 在 Exchange 混合部署中,您可以将邮箱从本地 Exchange 组织移动到 Exchange Online 中。 这也称为载入远程移动迁移,因为你将邮箱加入到Exchange Online。

    • 卸载远程移动迁移:还可以执行卸载远程移动迁移,将Exchange Online邮箱迁移到本地 Exchange 组织。

    注意

    加入和分离远程移动迁移均从 Exchange Online 组织启动。

    • 暂存 Exchange 迁移: 您还可以将邮箱的一个子集从本地 Exchange 组织迁移到 Exchange Online 中。 这是另一种类型的加入迁移。 仅可以使用分步 Exchange 迁移来迁移 Exchange 2003 和 Exchange 2007 邮箱。 不支持对 Exchange 2010 和 Exchange 2013 邮箱进行暂存迁移。 在运行暂存迁移之前,您必须使用目录同步或其他一些设置来设置 Exchange Online 组织中的邮件用户。

    • IMAP 迁移: 这种类型的加入迁移将邮箱数据从 IMAP 服务器(包括 Exchange)迁移到 Exchange Online 中。 对于 IMAP 迁移,您必须先在 Exchange Online 中设置邮箱,然后才能迁移邮箱数据。

注意

直接转换 Exchange 迁移不支持使用 CSV 文件,因为所有本地用户邮箱都是通过一个批处理迁移到 Exchange Online 中。

在您执行批量移动或迁移时 CSV 文件支持的属性

用于迁移用户的 CSV 文件的第一行(即“标题行”)列出了后续行中的指定属性名称或字段。 每个属性名称之间以逗号分隔。 标题行下的每一行均代表各个用户,并提供了迁移所需的信息。 每个用户行中的属性顺序必须与标题行中的属性名称顺序相同。 每个属性值均用逗号分隔。 如果特定记录的属性值为 Null,切勿为该属性输入任何数据。 但请务必使用逗号分隔 Null 值和下一个属性。

如果您在通过 EAC 或 Exchange 命令行管理程序 创建迁移批处理时使用了对应参数,那么 CSV 文件中的属性值将替代对应参数的值。 有关详细信息和示例,请参阅CSV 文件中的属性值替代迁移批处理的值一节。

提示

可以使用任何文本编辑器创建 CSV 文件,但使用 Microsoft Excel 等应用程序能更轻松地导入数据并且配置和整理 CSV 文件。 请务必将 CSV 文件保存为 .csv 或 .txt 文件。

以下部分针对每种迁移类型介绍了 CSV 文件标题行支持的属性。 每个部分包括列出每种受支持属性(无论其是否是必需的)的表格,用于该属性的值的示例以及说明。

注意

  • 在以下部分中,源环境表示用户邮箱或数据库的当前位置。 目标环境表示您要将邮箱迁移至的位置,或者您要将邮箱移动到的数据库。
  • 将迁移 CSV 文件中指定的所有邮箱,即使它们不在 RBAC 范围 (例如,授予管理员迁移邮箱权限的 OU) 。

本地移动

下表介绍了您在执行本地移动时 CSV 文件支持的属性。 有关详细信息,请参阅管理内部部署移动

属性 必需还是可选 可接受的值 说明
EmailAddress 必需 用户的 SMTP 地址 指定要移动的用户。
TargetDatabase 可选 数据库名称 指定要将用户的主邮箱移动到的邮箱数据库。 您可以在 CSV 文件的不同行中指定不同的数据库,这样可以将同一迁移批处理中的邮箱移动到不同的数据库。
TargetArchiveDatabase 可选 数据库名称 指定要将用户的存档邮箱移动到的邮箱数据库。 您可以在 CSV 文件的不同行中指定不同的数据库,这样可以将同一迁移批处理中的存档邮箱移动到不同的数据库。

注意:如果指定特定的存档数据库,存档邮箱 (是否存在) 将移动到主邮箱所在的同一数据库。
BadItemLimit 可选 Unlimited 或非负整数,从 0 (默认) 到最大值 2147483647 指定当迁移服务在邮箱中遇到损坏的项目时要跳过的错误项目数。 如果在 CSV 文件中包括此属性,它将替代默认值或指定的值(如果在使用 EAC 或 Exchange 命令行管理程序创建迁移批处理时包含 BadItemLimit 参数)。

提示:建议使用默认值 0,并且仅在特定用户的移动或迁移失败时提高该用户的不良项限制。
MailboxType 可选 使用下列值之一:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive(默认值)
指定是移动用户的主邮箱、存档邮箱,还是两种邮箱都移动。

混合部署中的加入远程移动迁移

在混合部署中,您可以将邮箱从本地 Exchange 组织移动到 Exchange Online 中。 当您在加入邮箱时,迁移批处理是在 Exchange Online 组织中创建,并由 Exchange Online 管理员启动。 有关详细信息,请参阅在混合部署中在本地和Exchange Online组织之间移动邮箱

下表介绍了您在执行加入远程移动迁移时 CSV 文件支持的属性。

属性 必需还是可选 可接受的值 说明
EmailAddress 必需 用户的 SMTP 地址 指定 Exchange Online 组织中与要迁移的本地用户邮箱对应的启用邮件的用户的电子邮件地址。
BadItemLimit 可选 Unlimited 或非负整数,从 0 (默认) 到最大值 2147483647 指定当迁移服务在邮箱中遇到损坏的项目时要跳过的错误项目数。 如果在 CSV 文件中包括此属性,它将替代默认值或指定的值(如果在使用 EAC 或 Exchange 命令行管理程序创建迁移批处理时包含 BadItemLimit 参数)。

提示:建议使用默认值 0,并且仅在特定用户的移动或迁移失败时提高该用户的不良项限制。
LargeItemLimit 可选 Unlimited 或从 0 默认) 到最大值 (非负整数。 指定用户邮箱中将跳过的大型项目数。 如果大项目数超过了此值,则相应邮箱的迁移将失败。

默认值为 0,表示邮箱中包含任何大项目都会导致迁移失败。

将邮箱载入Exchange Online时,将迁移最大 35 MB 的项目。
MailboxType 可选 使用下列值之一:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive(默认值)
指定是移动用户的主邮箱、存档邮箱,还是两种邮箱都移动。

混合部署中的跨林企业移动和分离远程移动迁移

如前所述,您既可以从目标林开始跨林移动,也可以从源林开始跨林移动。 分离远程移动迁移是从 Exchange Online 组织启动。 有关更多信息,请参阅:

下表介绍了您在 Exchange 混合部署中执行跨林企业移动和分离远程移动迁移时 CSV 文件支持的属性。

属性 必需还是可选 可接受的值 说明
EmailAddress 必需 用户的 SMTP 地址 对于跨林企业移动,该属性指定了源林中的邮箱或启用邮件的用户。

对于卸载远程移动迁移,它指定Exchange Online邮箱。
TargetDatabase 对于分离远程移动迁移和从源林启动的跨林企业移动,该属性是必需的。 或者,在 EAC 中创建迁移批处理或使用 Exchange 命令行管理程序时,可以指定此属性。

对于从目标林启动的跨林企业移动,该属性是可选的。
数据库名称 指定要将用户的主邮箱移动到的邮箱数据库(目标林中)。 您可以在 CSV 文件的不同行中指定不同的数据库,这样可以将同一迁移批处理中的邮箱移动到不同的数据库。
TargetArchiveDatabase 可选 数据库名称 指定要将用户的存档邮箱移动到的邮箱数据库(目标林中)。 您可以在 CSV 文件的不同行中指定不同的数据库,这样可以将同一迁移批处理中的存档邮箱移动到不同的数据库。
BadItemLimit 可选 Unlimited 或非负整数,从 0 (默认) 到最大值 2147483647 指定当迁移服务在邮箱中遇到损坏的项目时要跳过的错误项目数。 如果在 CSV 文件中包括此属性,它将替代默认值或指定的值(如果在使用 EAC 或 Exchange 命令行管理程序创建迁移批处理时包含 BadItemLimit 参数)。

提示:建议使用默认值 0,并且仅在特定用户的移动或迁移失败时提高该用户的不良项限制。
LargeItemLimit 可选 Unlimited 或从 0 默认) 到最大值 (非负整数。 指定用户邮箱中将跳过的大型项目数。 如果大项目数超过了此值,则相应邮箱的迁移将失败。

默认值为 0,表示邮箱中包含任何大项目都会导致迁移失败。

将邮箱载入Exchange Online时,将迁移最大 35 MB 的项目。
MailboxType 可选 使用下列值之一:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive(默认值)
指定是移动用户的主邮箱、存档邮箱,还是两种邮箱都移动。

暂存 Exchange 迁移

如果您想要使用暂存 Exchange 迁移将 Exchange 2003 和 Exchange 2007 本地邮箱迁移到 Exchange Online 中,必须使用 CSV 文件确认迁移批处理的用户组。 使用暂存 Exchange 迁移可以迁移到云中的邮箱数没有限制。 不过,迁移批处理的 CSV 文件最多可包含 1,000 行。 若要迁移超过 1,000 个邮箱,您需要创建其他 CSV 文件,然后使用每个文件新建一个迁移批处理。 有关暂存 Exchange 迁移的详细信息,请参阅使用暂存迁移将邮箱迁移到 Exchange Online

下表介绍了您在执行暂存 Exchange 迁移时 CSV 文件支持的属性。

属性 必需还是可选 可接受的值 说明
EmailAddress 必需 用户的 SMTP 地址 指定 Exchange Online 组织中与要迁移的本地用户邮箱对应的启用邮件的用户的电子邮件地址(或邮箱,前提是您要重试迁移)。 目录同步或其他设置过程会在 Exchange Online 中创建启用邮件的用户。 已启用邮件的用户的电子邮件地址必须与相应本地邮箱的 WindowsEmailAddress 属性匹配。
Password 可选 密码的长度必须至少为 8 个字符,并且满足应用于 Microsoft 365 或 Office 365 组织的任何密码限制。 当 Exchange Online 中对应的启用邮件的用户在迁移过程中转换为邮箱时,该密码设置在用户帐户上。
ForceChangePassword 可选 TrueFalse 指定用户在首次登录自己的 Exchange Online 邮箱时是否必须更改密码。

注意:如果已通过在本地组织中部署 Active Directory 联合身份验证服务 2.0 (AD FS 2.0) 来实现单一登录解决方案,则必须使用 False 作为此属性的值。

IMAP 迁移

IMAP 迁移批处理的 CSV 文件最多可包含 50,000 行。 但最好是将用户分成多个较小的批处理来进行迁移。 有关 IMAP 迁移的详细信息,请参阅下列主题:

下表介绍了您在执行 IMAP 迁移时 CSV 文件支持的属性。

属性 必需还是可选 可接受的值 说明
EmailAddress 必需 用户的 SMTP 地址 指定用户 Exchange Online 邮箱的用户 ID。
UserName 必需 用于在 IMAP 邮件系统上标识用户的字符串(采用 IMAP 服务器支持的格式) 指定 IMAP 邮件系统(源环境)中用户帐户的登录名。 除了用户名之外,您还可以使用已分配有访问 IMAP 服务器上的邮箱所必需的权限的帐户凭据。 有关详细信息,请参阅 IMAP 迁移批处理的 CSV 文件
Password 必需 密码字符串 指定“UserName”属性指定的用户帐户密码。

CSV 文件中的属性值替代迁移批处理的值

如果您在通过 EAC 或 Exchange 命令行管理程序 创建迁移批处理时使用了对应参数,那么 CSV 文件中的属性值将替代对应参数的值。 如果您想要对用户应用迁移批处理值,请将 CSV 文件中的相应单元格留空。 这样,您可以为一个迁移批处理中的选定用户混合和匹配特定属性值。

例如,假设您使用以下 Exchange 命令行管理程序 命令在 Exchange 命令行管理程序 中为跨林企业移动创建了批处理,以将用户的主邮箱和存档邮箱移动到目标林中:

New-MigrationBatch -Name CrossForestBatch1 -SourceEndpoint ForestEndpoint1 -TargetDeliveryDomain forest2.contoso.com -TargetDatabases @(EXCH-MBX-02,EXCH-MBX-03) -TargetArchiveDatabases @(EXCH-MBX-A02,EXCH-MBX-A03) -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\CrossForestBatch1.csv")) -AutoStart

注意

由于默认移动的是主邮箱和存档邮箱,因此您无需在 Exchange 命令行管理程序 命令中明确指定这一点。

该迁移批处理的 CrossForestBatch1.csv 文件的一部分如下所示:

EmailAddress,TargetDatabase,TargetArchiveDatabase
user1@contoso.com,EXCH-MBX-01,EXCH-MBX-A01
user2@contoso.com,,
user3@contoso.com,EXCH-MBX-01,
...

由于 CSV 文件中的值替代迁移批处理的值,因此用户 1 的主邮箱和存档邮箱分别移动到目标林中的 EXCH-MBX-01 和 EXCH-MBX-A01。 用户 2 的主邮箱和存档邮箱移动到 EXCH-MBX-02 或 EXCH-MBX-03。 用户 3 的主邮箱移动到 EXCH-MBX-01,存档邮箱移动到 EXCH-MBX-A02 或 EXCH-MBX-A03。

再举一个示例,假设您使用以下命令为混合部署中的加入远程移动迁移创建了批处理,以将存档邮箱移动到 Exchange Online 中:

New-MigrationBatch -Name OnBoarding1 -SourceEndpoint RemoteEndpoint1 -TargetDeliveryDomain cloud.contoso.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\OnBoarding1.csv")) -MailboxType ArchiveOnly -AutoStart

但由于您还希望移动选定用户的主邮箱,因此该迁移批处理的 OnBoarding1.csv 文件的一部分如下所示:

EmailAddress,MailboxType
user1@contoso.com,
user2@contoso.com,
user3@cloud.contoso.com,PrimaryAndArchive
user4@cloud.contoso.com,PrimaryAndArchive
...

由于 CSV 文件中邮箱类型的值会替代命令中 MailboxType 参数的值以创建批处理,因此只有 user1 和 user2 的存档邮箱会迁移到Exchange Online。 但是,user3 和 user4 的主邮箱和存档邮箱会移到Exchange Online。