Set-MailboxRestoreRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
创建请求后，使用 Set-MailboxRestoreRequest cmdlet 更改还原请求选项。 可以使用此 cmdlet 从失败的还原请求中恢复。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-AcceptLargeDataLoss]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Priority <RequestPriority>]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>] Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-RehomeRequest]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>] 说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-MailboxRestoreRequest -Identity "Ayla\MailboxRestore1" -BadItemLimit 10本示例将 Ayla\MailboxRestore1 的第二个还原请求更改为跳过 10 个损坏的邮箱项目。
示例 2
Set-MailboxRestoreRequest -Identity "Kweku\MailboxRestore" -BadItemLimit 100 -AcceptLargeDataLoss此示例将 Kweku 邮箱的第一个还原请求更改为跳过 100 个损坏的项目。 由于 BadItemLimit 大于 50，因此必须指定 AcceptLargeDataLoss 参数。
参数
-AcceptLargeDataLoss
AcceptLargeDataLoss 开关指定即使无法将源邮箱中的大量项目复制到目标邮箱，该请求也应继续。 不必为此开关指定值。
在 Exchange 2013 或更高版本或 Exchange Online 中，如果将 LargeItemLimit 参数设置为值 51 或更高的值，则需要使用此开关。 否则，该命令将失败。
在 Exchange2010 中，如果将 BadItemLimit 参数设置为 51 或更高的值，则需要使用此开关。 否则，该命令将失败。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BadItemLimit
BadItemLimit 参数指定在请求失败之前允许出现的最大无效项目数。 无效项目是源邮箱中无法复制到目标邮箱的损坏项目。 无效项目限制还包括缺少的项目。 缺少的项目是请求即将完成时在目标邮箱中找不到的源邮箱项目。
此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何无效项目，请求将失败。 如果你认为有几个损坏项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。 如果检测到的损坏项目太多，请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中的已损坏项目，然后重试请求。
在 Exchange 2010 中，如果将此值设置为 51 或更高版本，则还需要使用 AcceptLargeDataLoss 开关。 否则，该命令将失败。
注意：在基于云的服务中不建议使用此参数。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BatchName
BatchName 参数指定批次的名称。 使用此参数可更改、创建或删除批名称。
若要删除批名称，请将 BatchName 参数值设置为空字符串或 null，例如 ，-BatchName“”或 -BatchName $null。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompletedRequestAgeLimit
CompletedRequestAgeLimit 参数指定完成的还原请求的状态设置为 Completed 的时间长度。 如果此参数设置为值 0，则会立即清除状态，而不是将其更改为“已完成”。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity 参数指定还原请求的标识。 Identity 参数由要还原的邮箱的别名和创建还原请求时指定的名称组成。 还原请求的标识使用以下语法： Alias\Name
如果在创建还原请求时未指定名称，则 Exchange 会自动生成默认名称 MailboxRestore。 Exchange 最多生成 10 个名称，从 MailboxRestore 开始，然后是 MailboxRestoreX (其中 X = 1-9) 。
| Type: | MailboxRestoreRequestIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-InternalFlags
此参数仅在本地 Exchange 中有效。
InternalFlags 参数指定请求中的可选步骤。 此参数主要用于调试。
| Type: | InternalMrsFlag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LargeItemLimit
LargeItemLimit 参数指定在请求失败之前允许出现的最大大项目数。 大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。 如果目标邮箱没有专门配置最大邮件大小值，则使用组织范围的值。
有关最大邮件大小值的详细信息，请参阅下列主题：
- Exchange 2016：Exchange Server中的邮件大小限制
- Exchange Online：Exchange Online 限制
此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何大项目，请求将失败。 如果你认为有几个大项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。
如果将此值设置为 51 或更高，则还需使用 AcceptLargeDataLoss 开关。 否则，该命令将失败。
注意：在基于云的服务中不建议使用此参数。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
此参数仅在本地 Exchange 中有效。
Priority 参数指定该请求在请求队列中应有的处理顺序。 请求根据服务器运行状况、状态、优先级和最后更新时间按顺序处理。 有效的优先级值为：
- Lowest
- Lower
- Low
- Normal：此值为默认值。
- High
- Higher
- Highest
- Emergency
| Type: | RequestPriority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RehomeRequest
此参数仅在本地 Exchange 中有效。
RehomeRequest 开关将邮箱还原请求移动到其他邮箱数据库。 不必为此开关指定值。
如果必须删除原始移动请求中的源邮箱数据库，请使用此开关编辑邮箱还原请求。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteHostName
保留此参数以供 Microsoft 内部使用。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RequestExpiryInterval
RequestExpiryInterval 参数指定已完成或失败的请求的保留期限。 如果使用此参数，那么在指定的时间间隔过期后，已完成或失败的请求会自动删除。 如果不使用此参数：
- 已完成的请求根据 CompletedRequestAgeLimit 参数值自动删除。
- 如果请求失败，则需要使用相应的 Remove-*Request cmdlet 手动将其删除。
若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。
如果使用值 Unlimited，则不会自动删除已完成的请求。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipInitialConnectionValidation
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SkipMerging
SkipMerging 参数指定在还原邮箱时要跳过的文件夹相关项目。 使用下列值之一：
- FolderACLs
- FolderProperties
- FolderRules
- InitialConnectionValidation
仅当由于文件夹规则、文件夹访问控制列表 (ACL) 或初始连接验证的原因而导致还原请求失败时，才使用此参数。
| Type: | SkippableMergeComponent[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkippedItemApprovalTime
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceWlmLevel
此参数仅在基于云的服务中可用。
{{ Fill SourceWlmLevel Description }}
| Type: | WlmLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TargetWlmLevel
此参数仅在基于云的服务中可用。
{{ Fill TargetWlmLevel Description }}
| Type: | WlmLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 不返回任何数据。