Complete-MigrationBatch
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能是一个环境或另一个环境独占。
使用 Complete-MigrationBatch cmdlet 完成已成功完成初始同步的迁移批处理。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Complete-MigrationBatch
[[-Identity] <MigrationBatchIdParameter>]
[-CompletePublicFolderMigrationWithDataLoss]
[-Confirm]
[-DomainController <Fqdn>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-SyncAndComplete]
[-WhatIf]
[<CommonParameters>]
说明
在迁移批处理成功运行并且状态为 Synced 或 SyncedWithErrors 后,使用 Complete-MigrationBatch cmdlet 完成迁移批处理。 在最终完成迁移批次时,该 cmdlet 将对迁移批次中的每个邮箱执行以下操作:
- 运行最后一次增量同步。
- 将用户的 Microsoft Outlook 配置文件配置为指向新的目标域。
- 将源邮箱转换为源域中启用邮件的用户。
在基于云的服务中,此 cmdlet 将 CompleteAfter 值设置为当前 UTC 时间,这指示迁移服务尽快完成批处理。 这等效于运行 Set-MigrationBatch -CompleteAfter (Get-Date),但没有时区转换歧义。
在 Exchange Online 中使用此 cmdlet 时,请注意以下行为:
- 任何应用于批处理中单个用户的 CompleteAfter 设置都会替代批处理级别设置,因此某些用户的完成可能会延迟到其配置的时间。
- 如果在批处理已发出完成信号后的 8 小时内多次运行此 cmdlet,迁移服务可能不会重新处理请求。 此行为旨在防止重复调用使服务耗尽。 如果批处理在运行 cmdlet 后出现停滞,则检查未批准的跳过项目 (使用
Set-MigrationUser -ApproveSkippedItems) 。
最终完成过程完成时,可以使用 Remove-MigrationBatch cmdlet 删除该批次。
如果迁移批处理的状态为“已完成但出现错误”,您可以重新尝试最终确定失败的用户。 在 Exchange Online 中,使用 Start-MigrationBatch cmdlet 重试失败用户的迁移。 在 Exchange 2013 或更高版本中,使用 Complete-MigrationBatch 重试这些失败的用户。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果分配给你的权限中未包含某些参数,则可能无权访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Complete-MigrationBatch -Identity LocalMove1 -NotificationEmails admin@contoso.com,lucio@contoso.com
此示例完成了迁移批次 LocalMove1,并将通知电子邮件发送给指定用户。
参数
-CompletePublicFolderMigrationWithDataLoss
适用:Exchange Online
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 有何影响取决于 cmdlet 在继续操作前是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。
此 cmdlet 具有内置的暂停,因此请跳 -Confirm:$false 过确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DomainController
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 参数指定要完成的迁移批处理的名称。 此参数的值由 Name 参数为 New-MigrationBatch cmdlet 指定。 使用 Get-MigrationBatch cmdlet 可以为迁移批次确定此参数的值。
参数属性
| 类型: | MigrationBatchIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-NotificationEmails
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
NotificationEmails 参数指定在迁移批次完成后接收状态报告的一个或多个电子邮件地址。 可以指定多个电子邮件地址,中间用逗号分隔。
如果不使用此参数,则会将最终状态报告发送到运行 Complete-MigrationBatch cmdlet 的管理员。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Partition
适用:Exchange Online
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SyncAndComplete
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SyncAndComplete 开关指定是否在同步成功时立即触发最终增量同步,然后完成迁移批处理。 不必为此开关指定值。
使用此开关时,批处理必须为零个故障、损坏或停止的项;否则,cmdlet 将返回错误。
注意: 对于公用文件夹迁移批处理,默认情况下启用此开关,除非还指定了 CompletePublicFolderMigrationWithDataLoss 开关。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 开关显示命令执行的操作,而无需进行任何更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | WI |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的“输入类型”字段为空,则 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果“输出类型”字段为空,则 cmdlet 不会返回数据。
备注
在 Exchange Online 中,以下迁移类型支持此 cmdlet:
- Exchange 本地移动
- Exchange 远程移动
- Gmail
- Google 资源
- 本地搬迁
- 文件夹移动
- PST 导入
- 公用文件夹
- 统一组的公用文件夹
在 Exchange Online 中,IMAP、暂存 Exchange Outlook Anywhere (直接转换) 或批量预配迁移不支持此 cmdlet,这些迁移没有最终确定步骤。