适用于邮箱迁移的 CSV 文件

Exchange 2013
 

适用于:Exchange Online, Exchange Server 2013

上一次修改主题:2016-04-29

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

  • 移入本地 Exchange 组织

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

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

  • Exchange Online 中的加入和分离

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

    • 分离远程移动迁移: 您也可以执行“分离”远程移动迁移,即将 Exchange Online 邮箱迁移到本地 Exchange 组织中。

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

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

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

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

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

提示提示:
您可以使用任意文本编辑器创建 CSV 文件,但使用诸如 Microsoft Excel 之类的应用程序可以更轻松地导入数据以及配置和组织 CSV 文件。请务必将 CSV 文件保存为 .csv 或 .txt 文件。

以下部分针对每种迁移类型介绍了 CSV 文件标题行支持的属性。每个部分均包含一份表格,其中列出了所有的支持属性以及是否必需、供使用的属性值示例和说明。

注意注意:
在以下部分中,源环境表示用户邮箱或数据库的当前位置。目标环境表示您要将邮箱迁移至的位置,或者您要将邮箱移动到的数据库。

下表介绍了您在执行本地移动时 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 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 个字符,并且必须符合 Office 365 组织适用的所有密码限制。

当 Exchange Online 中对应的启用邮件的用户在迁移过程中转换为邮箱时,该密码设置在用户帐户上。

ForceChangePassword

可选

TrueFalse

指定用户在首次登录自己的 Exchange Online 邮箱时是否必须更改密码。

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

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

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

 

属性 必需还是可选 可接受的值 说明

EmailAddress

必需

用户的 SMTP 地址

指定用户 Exchange Online 邮箱的用户 ID。

UserName

必需

用于在 IMAP 邮件系统上标识用户的字符串(采用 IMAP 服务器支持的格式)

指定用户帐户在 IMAP 邮件系统(源环境)中的登录名。除了用户名之外,您还可以使用已分配有访问 IMAP 服务器上的邮箱所必需的权限的帐户凭据。有关详细信息,请参阅 IMAP 迁移批处理的 CSV 文件

Password

必需

密码字符串

指定“UserName”属性指定的用户帐户密码。

如果您在通过 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 参数值,因此只有用户 1 和 2 的存档邮箱会迁移到 Exchange Online 中,而用户 3 和 4 的主邮箱和存档邮箱则移动到 Exchange Online 中。

 
显示: