Set-PublicFolderMigrationRequest

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Set-PublicFolderMigrationRequest cmdlet 修改由 New-PublicFolderMigrationRequest cmdlet) 创建的串行公用文件夹迁移请求 (请求。可以使用此 cmdlet 从失败的迁移请求中恢复。

注意：对公用文件夹的串行迁移的支持在 Exchange 2013 累积更新 8 (CU8) 中结束，并且 cmdlet 在 Exchange Online 中不再可用。请改用相应的 *-MigrationBatch 和 *-PublicFolderMailboxMigration* cmdlet。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Set-PublicFolderMigrationRequest
   [-Identity] <PublicFolderMigrationRequestIdParameter>
   [-AcceptLargeDataLoss]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-PreventCompletion <Boolean>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-WhatIf]
   [<CommonParameters>]

Set-PublicFolderMigrationRequest
   [-Identity] <PublicFolderMigrationRequestIdParameter>
   -RehomeRequest
   [-Confirm]
   [-DomainController <Fqdn>]
   [-PreventCompletion <Boolean>]
   [-RequestExpiryInterval <Unlimited>]
   [-WhatIf]
   [<CommonParameters>]

说明

可以通过管道输出 Get-PublicFolderMigrationRequestStatistics、Get-PublicFolderMigrationRequest 或 Get-PublicFolder 到此 cmdlet。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-PublicFolderMigrationRequest -Identity PublicFolderMigration -BadItemLimit 5

此示例更改了 PublicFolderMigration 迁移请求的设置以接受最多五个损坏的公用文件夹项目。

参数

-AcceptLargeDataLoss

AcceptLargeDataLoss 开关指定即使无法将源邮箱中的大量项目复制到目标邮箱，该请求也应继续。不必为此开关指定值。

如果将 LargeItemLimit 参数设置为 51 或更高值，则需要使用此开关。否则，该命令将失败。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BadItemLimit

BadItemLimit 参数指定在请求失败之前允许出现的最大无效项目数。无效项目是源邮箱中无法复制到目标邮箱的损坏项目。无效项目限制还包括缺少的项目。缺少的项目是请求即将完成时在目标邮箱中找不到的源邮箱项目。

此参数的有效输入是一个整数或值 unlimited。默认值为 0，这意味着如果检测到任何无效项目，请求将失败。如果你认为有几个损坏项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。如果检测到的损坏项目太多，请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中的已损坏项目，然后重试请求。

类型:	Unlimited
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BatchName

BatchName 参数为公用文件夹批处理迁移指定描述性名称。在使用 Get-PublicFolderMigrationRequest cmdlet 时，可以使用 BatchName 参数作为搜索字符串。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CompletedRequestAgeLimit

CompletedRequestAgeLimit 参数指定已完成的请求在被自动删除之前保留的时间。默认的 CompletedRequestAgeLimit 参数值为 30 天。

类型:	Unlimited
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Identity

Identity 参数指定要修改的迁移请求。可以使用下列值：

名称
RequestGUID

类型:	PublicFolderMigrationRequestIdParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-InternalFlags

InternalFlags 参数指定请求中的可选步骤。此参数主要用于调试。

类型:	InternalMrsFlag[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LargeItemLimit

LargeItemLimit 参数指定在请求失败之前允许出现的最大大项目数。大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。如果目标邮箱没有专门配置最大邮件大小值，则使用组织范围的值。

有关最大邮件大小值的详细信息，请参阅下列主题：

Exchange 2016：Exchange Server中的邮件大小限制
Exchange Online：Exchange Online 限制

此参数的有效输入是一个整数或值 unlimited。默认值为 0，这意味着如果检测到任何大项目，请求将失败。如果你认为有几个大项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。

如果将此值设置为 51 或更高，则还需使用 AcceptLargeDataLoss 开关。否则，该命令将失败。

类型:	Unlimited
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PreventCompletion

PreventCompletion 参数指定是否运行迁移请求但不允许其完成。有效值包含:

$true：迁移请求运行，但不允许完成。若要完成迁移请求，请在运行 Resume-PublicFolderMigrationRequest cmdlet 之前将此参数设置为 $false。
$false：迁移请求运行并允许完成。此值为默认值。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Priority

Priority 参数指定该请求在请求队列中应有的处理顺序。请求根据服务器运行状况、状态、优先级和最后更新时间按顺序处理。有效的优先级值为：

Lowest
Lower
Low
Normal：此值为默认值。
High
Higher
Highest
Emergency

类型:	RequestPriority
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RehomeRequest

RehomeRequest 开关告知 Microsoft Exchange 邮箱复制服务 (MRS) 需要将请求移动到与要迁移的公用文件夹相同的数据库。不必为此开关指定值。

此开关主要用于调试目的。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RequestExpiryInterval

RequestExpiryInterval 参数指定已完成或失败的请求的保留期限。如果使用此参数，那么在指定的时间间隔过期后，已完成或失败的请求会自动删除。如果不使用此参数：

已完成的请求根据 CompletedRequestAgeLimit 参数值自动删除。
如果请求失败，则需要使用相应的 Remove-*Request cmdlet 手动将其删除。

若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。

如果使用值 Unlimited，则不会自动删除已完成的请求。

类型:	Unlimited
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipMerging

SkipMerging 参数指定是否为了调试目的而跳过迁移的某些阶段。除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。

类型:	SkippableMergeComponent[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。