Set-MoveRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Set-MoveRequest cmdlet 在创建移动请求之后更改移动请求选项。 您可以使用 Set-MoveRequest cmdlet 从失败的移动请求中恢复。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-MoveRequest
[-Identity] <MoveRequestIdParameter>
[-AcceptLargeDataLoss]
[-ArchiveTargetDatabase <DatabaseIdParameter>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-IgnoreRuleLimitErrors <Boolean>]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-PreventCompletion <Boolean>]
[-Priority <RequestPriority>]
[-Protect <Boolean>]
[-ProxyToMailbox <MailboxIdParameter>]
[-RemoteCredential <PSCredential>]
[-RemoteGlobalCatalog <Fqdn>]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-SkippedItemApprovalTime <DateTime>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-StartAfter <DateTime>]
[-SuspendWhenReadyToComplete <Boolean>]
[-TargetDatabase <DatabaseIdParameter>]
[-WhatIf]
[<CommonParameters>] 说明
您可以从 Get-MoveRequestStatistics、Get-MoveRequest 或 Get-Mailbox cmdlet 中管道传输 Set-MoveRequest cmdlet。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-MoveRequest -Identity Ayla@humongousinsurance.com -BadItemLimit 5本示例将 Ayla 的移动请求设置更改为最多接受五个损坏的邮箱项目。
示例 2
Set-MoveRequest -Identity Sruthi@contoso.com -SkippedItemApprovalTime $(Get-Date).ToUniversalTime()本示例更改 Sruthi 的移动请求，以批准当前时间之前遇到的所有跳过项。
参数
-AcceptLargeDataLoss
AcceptLargeDataLoss 开关指定即使无法将源邮箱中的大量项目复制到目标邮箱，该请求也应继续。 不必为此开关指定值。
在 Exchange 2013 或更高版本或 Exchange Online 中，如果将 LargeItemLimit 参数设置为值 51 或更高的值，则需要使用此开关。 否则，该命令将失败。
在 Exchange2010 中，如果将 BadItemLimit 参数设置为 51 或更高的值，则需要使用此开关。 否则，该命令将失败。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ArchiveTargetDatabase
此参数只在本地 Exchange 中可用。
ArchiveTargetDatabase 参数指定个人存档的目标邮箱数据库。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
仅当移动请求具有 Queued 的 MoveStatus 值时，才可以使用此参数更改目标数据库。
| 类型: | DatabaseIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BadItemLimit
BadItemLimit 参数指定在请求失败之前允许出现的最大无效项目数。 无效项目是源邮箱中无法复制到目标邮箱的损坏项目。 无效项目限制还包括缺少的项目。 缺少的项目是请求即将完成时在目标邮箱中找不到的源邮箱项目。
此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何无效项目，请求将失败。 如果你认为有几个损坏项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。 如果检测到的损坏项目太多，请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中的已损坏项目，然后重试请求。
在 Exchange 2010 中，如果将此值设置为 51 或更高版本，则还需要使用 AcceptLargeDataLoss 开关。 否则，该命令将失败。
注意：在基于云的服务中不建议使用此参数。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。
| 类型: | Unlimited |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BatchName
BatchName 参数为批处理指定一个其他名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompleteAfter
CompleteAfter 参数指定完成请求之前的延迟。 请求已启动，但将在使用此参数指定的日期/时间之前才能完成。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
在 Exchange Online PowerShell 中，如果指定日期/时间值而不指定时区，则该值位于协调世界时 (UTC) 中。
若要指定此参数的日期/时间值，请使用下列方法之一：
- 指定 UTC 中的日期/时间值：例如，“2021-05-06 14：30：00z”。
- 将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 有关详细信息，请参阅 Get-Date。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompletedRequestAgeLimit
CompletedRequestAgeLimit 参数指定已完成的请求在被自动删除之前保留的时间。 默认的 CompletedRequestAgeLimit 参数值为 30 天。
| 类型: | Unlimited |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| 类型: | Fqdn |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定邮箱或邮件用户的标识。 可以使用下列值：
- GUID
- 可分辨名称 (DN)
- 域\帐户
- 用户主体名称 (UPN)
- LegacyExchangeDN
- SMTP 地址
- 别名
| 类型: | MoveRequestIdParameter |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreRuleLimitErrors
IgnoreRuleLimitErrors 参数指定命令不会将用户的规则移动到运行 Microsoft Exchange 的目标服务器。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013 |
-IncrementalSyncInterval
IncrementalSyncInterval 参数指定增量同步之间的等待时间。 该参数与 CompleteAfter 参数一起使用，以创建将在初始同步完成后执行定期增量同步的移动请求。
若要指定值，请以时间跨度格式 dd.hh:mm:ss 输入值（其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒）。
有效值为 00:00:00 至 120.00:00:00（120 天）。 默认值为 24 小时。
| 类型: | TimeSpan |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-InternalFlags
此参数只在本地 Exchange 中可用。
InternalFlags 参数指定请求中的可选步骤。 此参数主要用于调试。
| 类型: | InternalMrsFlag[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LargeItemLimit
LargeItemLimit 参数指定在请求失败之前允许出现的最大大项目数。 大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。 如果目标邮箱没有专门配置最大邮件大小值，则使用组织范围的值。
有关最大邮件大小值的详细信息，请参阅下列主题：
- Exchange 2016：Exchange Server中的邮件大小限制
- Exchange Online：Exchange Online 限制
此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何大项目，请求将失败。 如果你认为有几个大项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。
如果将此值设置为 51 或更高，则还需使用 AcceptLargeDataLoss 开关。 否则，该命令将失败。
注意：在基于云的服务中不建议使用此参数。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。
| 类型: | Unlimited |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MoveOptions
MoveOptions 参数指定为进行调试而要跳过的移动阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
此参数不能与 SkipMoving 参数一起使用。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PreventCompletion
PreventCompletion 参数指定是否运行移动请求但不允许其完成。 有效值包含:
- $true：移动请求运行，但不允许完成。 建议使用 CompleteAfter 参数，而不是此值。
- $false：这是默认值。 移动请求将运行并允许完成。 如果使用 SuspendWhenReadyToComplete 或 PreventCompletion 开关创建了移动请求，请在运行 Resume-MoveRequest cmdlet 以完成移动请求之前，将此参数设置为 $false。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
此参数只在本地 Exchange 中可用。
Priority 参数指定该请求在请求队列中应有的处理顺序。 请求根据服务器运行状况、状态、优先级和最后更新时间按顺序处理。 有效的优先级值为：
- Lowest
- Lower
- Low
- Normal：此值为默认值。
- High
- Higher
- Highest
- Emergency
| 类型: | RequestPriority |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Protect
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ProxyToMailbox
此参数仅在基于云的服务中可用。
ProxyToMailbox 参数通过指定邮箱（也称为代理）的位置来指定移动目标。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
| 类型: | MailboxIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-RemoteCredential
RemoteCredential 参数指定有权执行邮箱移动的管理员的用户名和密码。
此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。 或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。 有关详细信息，请参阅 Get-Credential。
| 类型: | PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteGlobalCatalog
RemoteGlobalCatalog 参数指定远程林的全局编录服务器的 FQDN。
| 类型: | Fqdn |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteHostName
RemoteHostName 参数指定用于移动邮箱的跨林组织的 FQDN。
| 类型: | Fqdn |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RequestExpiryInterval
RequestExpiryInterval 参数指定已完成或失败的请求的保留期限。 如果使用此参数，那么在指定的时间间隔过期后，已完成或失败的请求会自动删除。 如果不使用此参数：
- 已完成的请求根据 CompletedRequestAgeLimit 参数值自动删除。
- 如果请求失败，则需要使用相应的 Remove-*Request cmdlet 手动将其删除。
若要指定值，请以时间跨度格式 dd.hh:mm:ss 输入值（其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒）。
如果使用值 Unlimited，则不会自动删除已完成的请求。
| 类型: | Unlimited |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipMoving
此参数已被 MoveOptions 参数替换。
SkipMoving 参数指定为进行调试而要跳过的移动阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
| 类型: | SkippableMoveComponent[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkippedItemApprovalTime
此参数仅在基于云的服务中可用。
SkippedItemApprovalTime 参数将指定时间之前发现的所有跳过项标记为已批准。 如果在此迁移过程中检测到的数据丢失严重，则如果不批准跳过的项，迁移将无法完成。 项目可能已跳过，因为它们在源邮箱中已损坏，无法复制到目标邮箱，它们大于为租户配置的最大允许邮件大小，或者当迁移准备好完成时，它们被检测到目标邮箱中缺失。
有关最大消息大小值的详细信息，请参阅以下主题Exchange Online限制。
若要指定此参数的日期/时间值，请使用下列方法之一：
- 指定 UTC 中的日期/时间值：例如，“2021-05-06 14：30：00z”。
- 将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 有关详细信息，请参阅 Get-Date。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SourceEndpoint
此参数仅在基于云的服务中可用。
{{ Fill SourceEndpoint Description }}
| 类型: | MigrationEndpointIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-StartAfter
StartAfter 参数指定启动请求之前的延迟。 请求将到你使用此参数指定的日期/时间才会启动。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
在 Exchange Online PowerShell 中，如果指定日期/时间值而不指定时区，则该值位于协调世界时 (UTC) 中。
若要指定此参数的日期/时间值，请使用下列方法之一：
- 指定 UTC 中的日期/时间值：例如，“2021-05-06 14：30：00z”。
- 将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 有关详细信息，请参阅 Get-Date。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuspendWhenReadyToComplete
SuspendWhenReadyToComplete 参数指定是否在移动请求达到 CompletionInProgress 状态之前挂起移动请求。 请勿使用此参数，我们建议使用 CompleteAfter 参数。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetDatabase
此参数只在本地 Exchange 中可用。
TargetDatabase 参数指定邮箱的目标邮箱数据库。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
仅当移动请求具有 Queued 的 MoveStatus 值时，才可以使用此参数更改目标数据库。
| 类型: | DatabaseIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。