New-MailboxRestoreRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 New-MailboxRestoreRequest cmdlet 还原软删除或已断开连接的邮箱。 此 cmdlet 启动将内容从恢复数据库中的软删除邮箱、已禁用邮箱或任何邮箱移动到已连接的主邮箱或存档邮箱中的过程。
用于查找断开连接的邮箱和还原邮箱的属性在Exchange Server和Exchange Online中有所不同。 有关Exchange Online的详细信息，请参阅还原非活动邮箱。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-MRSServer <Fqdn>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceEndpoint <MigrationEndpointIdParameter>
-SourceExchangeGuid <Guid>
-SourceTenant <SmtpDomain>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-CrossTenantRestore]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-RemoteDatabaseGuid <Guid>
-RemoteHostName <Fqdn>
-RemoteRestoreType <RemoteRestoreType>
-RemoteCredential <PSCredential>
-SourceMailbox <MailboxLocationIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceIsArchive]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] 说明
当邮箱从一个数据库移动到另一个数据库时，Exchange 不会在移动完成后立即从源数据库完全删除邮箱。 而源邮箱数据库中的邮箱将切换到“软删除”状态，即允许在邮箱还原操作期间使用新的 MailboxRestoreRequest cmdlet 集访问邮箱数据。 软删除邮箱将保留在源数据库中，直到已删除邮箱保留期过期或使用 Remove-StoreMailbox cmdlet 清除邮箱。
若要查看软删除邮箱，请对数据库运行 Get-MailboxStatistics cmdlet 并查找具有值为 SoftDeleted 的 DisconnectReason 的结果。 有关详细信息，请参阅本主题后面的示例 1。
在 Disable-Mailbox 或 Remove-Mailbox 命令完成后的短时间内，邮箱将标记为“已禁用”。
在 Microsoft Exchange 信息存储服务确定 Active Directory 已使用禁用邮箱的信息更新之前，邮箱不会标记为“已禁用”。 您可以通过对该数据库运行 Update-StoreMailboxState cmdlet 加快该过程。
Exchange 根据为该邮箱数据库配置的已删除邮箱保留设置，在邮箱数据库中保留禁用的邮箱。 在指定时间段后，将永久删除邮箱。
若要查看已禁用邮箱，请对数据库运行 Get-MailboxStatistics cmdlet 并查找具有值为 Disabled 的 DisconnectReason 的结果。 有关详细信息，请参阅本主题后面的示例 2 和 3。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
注意：若要将主邮箱的内容还原到存档邮箱，请使用 TargetRootFolder 参数指定要将内容迁移到的存档邮箱文件夹。 还原后，此内容将可见。 如果不使用此参数，则还原的内容不可见，因为它映射到存档邮箱中对用户不可见的位置。
示例
示例 1
Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox Ayla在本地 Exchange 中，此示例使用 Get-MailboxStatistics cmdlet 返回 DisplayName、LegacyExchangeDN 和 MailboxGUID， (有效的源邮箱标识值，) 邮箱数据库中名为 MBD01 且由于 SoftDeleted 或 Disabled 断开连接原因的所有邮箱。
使用此信息，将 MailboxGUID 值为 1d20855f-fd54-4681-98e6-e249f7326dddd 的源邮箱还原到具有别名值 Ayla 的目标邮箱。
示例 2
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive在本地 Exchange 中，本示例使用邮箱数据库 MBD01 上的 Tony Smith 的 DisplayName 将源邮箱的内容还原到 的 Tony@contoso.com存档邮箱。
参数
-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 |
-AllowLegacyDNMismatch
AllowLegacyDNMismatch 开关指定，如果源物理邮箱和目标邮箱的 LegacyExchangeDN 不匹配，则操作应继续。 不必为此开关指定值。
默认情况下，此 cmdlet 将进行检查以确保源物理邮箱上的 LegacyExchangeDN 以对应于 LegacyExchangeDN 的 LegacyExchangeDN 或 X500 代理地址的形式出现在目标用户上。 此检查防止您将源邮箱意外还原到不正确的目标邮箱中。
注意：在基于云的服务中不建议使用此参数。 若要完成对具有不匹配的 LegacyExchangeDN 的邮箱的邮箱还原请求，需要获取源邮箱的 LegacyExchangeDN 值，并将其作为 X500 代理地址添加到目标邮箱。 有关详细说明，请参阅 还原非活动邮箱。
| 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 |
-AssociatedMessagesCopyOption
AssociatedMessagesCopyOption 参数指定处理请求时是否复制关联邮件。 关联邮件指包含隐藏数据（其中包含有关规则、视图和窗体的信息）的特殊邮件。 有效值包含:
- DoNotCopy：不会复制关联的消息。
- MapByMessageClass：通过查找源消息的 MessageClass 属性来查找关联的消息。 如果源和目标文件夹中都有此类的关联邮件，则会覆盖目标中的关联邮件。 如果目标中没有关联的消息，则会在目标中创建一个副本。
- 复制：将关联的消息从源复制到目标。 如果源位置和目标位置中都存在相同的消息类型，则这些关联的消息会重复。 此值为默认值。
Copy：此选项将关联邮件从源位置复制到目标位置。如果源位置和目标位置存在同一邮件类型，这些关联邮件将造成重复。这是默认选项。
| Type: | FAICopyOption |
| 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 参数为一批邮箱的还原指定描述性名称。 可以在使用 Get-MailboxRestoreRequest cmdlet 时将 BatchName 参数中的名称用作搜索字符串。
| 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，则会立即清除该状态，而不是将状态更改为 Completed。
| 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 |
-ConflictResolutionOption
ConflictResolutionOption 参数指定目标中有多个匹配消息时要执行的操作。 有效值包含:
- ForceCopy
- KeepAll
- KeepLatestItem
- KeepLatestItem
- KeepTargetItem
- UpdateFromSource
| Type: | ConflictResolutionOption |
| Position: | Named |
| Default value: | KeepSourceItem |
| 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 |
-ContentFilter
此参数仅在基于云的服务中可用。
ContentFilter 参数使用 OPATH 筛选器语法按指定的属性和值筛选结果。 仅还原与 ContentFilter 参数匹配的内容。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"。
- 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如
$true、$false或$null) ，请改用单引号 ' 。 虽然此参数是一个字符串 (不是) 的系统块，但也可以使用大括号 { }，但前提是筛选器不包含变量。 - 属性是可筛选的属性。 有关可筛选属性，请参阅 ContentFilter 参数的可筛选属性。
- ComparisonOperator 是一个 OPATH 比较运算符， (例如
-eq用于等于和-like字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。 - Value 是要搜索的属性值。 将文本值和变量括在单引号 (
'Value'或'$Variable') 。 如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。 例如，使用'$($User -Replace "'","''")'而不是'$User'。 不要将整数或系统值括在引号 (例如，改用500、$true、$false或$null) 。
可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。 例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。
有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ContentFilterLanguage
此参数仅在基于云的服务中可用。
ContentFilterLanguage 参数指定在 ContentFilter 参数中用于进行字符串搜索的语言。
此参数的有效输入是 Microsoft .NET Framework CultureInfo 类支持的区域性代码值。 例如，da-DK 表示丹麦语，ja-JP 表示日语。 有关详细信息，请参阅 CultureInfo 类。
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-CrossTenantRestore
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 |
-ExcludeDumpster
ExcludeDumpster 开关指定是否排除“可恢复的项目”文件夹。 不必为此开关指定值。
如果不使用此开关，则会使用以下子文件夹复制“可恢复的项目”文件夹：
- 删除
- 版本
- 清除
| 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 |
-ExcludeFolders
ExcludeFolders 参数指定在还原请求期间要排除的文件夹的列表。
如果 exADNoMk 联合身份验证服务 (AD FS) 已部署，允许单一登录外部部署邮箱，且 AD FS 配置为对登录令牌请求使用除 ExchangeGUID 之外的其他属性，则您必须设置 ImmutableId 参数。 exExchangeNoVersion 和 AD FS 两者必须为同一用户请求相同的令牌，才能确保跨界 exExchangeNoVersion 部署应用场景的正常运行。
<FolderName>/*：使用此语法表示 SourceRootFolder 参数中指定的文件夹下的个人文件夹，例如“MyProjects”或“MyProjects/FY2010”。
#<FolderName>#/*：使用此语法表示已知文件夹，而不考虑该文件夹在其他语言中的名称。 例如，#Inbox# 表示收件箱文件夹，即使收件箱本地化为土耳其语（即 Gelen Kutusu）。 已知文件夹包括以下类型：
- Inbox
- SentItems
- DeletedItems
- 日历
- 联系人
- 草稿
- 日志
- 任务
- 注释
- JunkEmail
- CommunicatorHistory
- 语音邮件
- Fax
- 冲突
- SyncIssues
- LocalFailures
- ServerFailures
如果用户创建的个人文件夹与已知文件夹的名称相同，并且其周围带有 #符号，则可以使用反斜杠 (\) 作为转义字符来指定该文件夹。 例如，如果用户创建名为 #Notes# 的文件夹，并且你想要指定该文件夹而不是已知的 Notes 文件夹，请使用以下语法： \#Notes\#。
如果用户创建的个人文件夹的名称与已知文件夹的名称相同且周围有 # 符号，则可以将反斜杠 (\) 用作转义字符以指定该文件夹。例如，如果用户创建了一个名为 #Notes# 的文件夹且您想指定该文件夹，但不是已知的“Notes”文件夹，请使用以下语法：\#Notes\#.
| 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 |
-IncludeFolders
IncludeFolders 参数指定还原请求期间要包含的文件夹的列表。
如果 exADNoMk 联合身份验证服务 (AD FS) 已部署，允许单一登录外部部署邮箱，且 AD FS 配置为对登录令牌请求使用除 ExchangeGUID 之外的其他属性，则您必须设置 ImmutableId 参数。 exExchangeNoVersion 和 AD FS 两者必须为同一用户请求相同的令牌，才能确保跨界 exExchangeNoVersion 部署应用场景的正常运行。
<FolderName>/*：使用此语法表示 SourceRootFolder 参数中指定的文件夹下的个人文件夹，例如“MyProjects”或“MyProjects/FY2010”。
#<FolderName>#/*：使用此语法表示已知文件夹，而不考虑该文件夹在其他语言中的名称。 例如，#Inbox# 表示收件箱文件夹，即使收件箱本地化为土耳其语（即 Gelen Kutusu）。 已知文件夹包括以下类型：
- Inbox
- SentItems
- DeletedItems
- 日历
- 联系人
- 草稿
- 日志
- 任务
- 注释
- JunkEmail
- CommunicationHistory
- 语音邮件
- Fax
- 冲突
- SyncIssues
- LocalFailures
- ServerFailures
如果用户创建的个人文件夹与已知文件夹的名称相同，并且其周围带有 #符号，则可以使用反斜杠 (\) 作为转义字符来指定该文件夹。 例如，如果用户创建名为 #Notes# 的文件夹，并且你想要指定该文件夹而不是已知的 Notes 文件夹，请使用以下语法： \#Notes\#。
如果用户创建的个人文件夹的名称与已知文件夹的名称相同且周围有 # 符号，则可以将反斜杠 (\) 用作转义字符以指定该文件夹。例如，如果用户创建了一个名为 #Notes# 的文件夹且您想指定该文件夹，但不是已知的“Notes”文件夹，请使用以下语法：\#Notes\#.
| 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 |
-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 |
-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 |
-MRSServer
此参数仅在 2010 Exchange Server可用。
MRSServer 参数指定运行 Microsoft Exchange 邮箱复制服务 (MRS) 实例的客户端访问服务器的 FQDN。 此参数仅用于调试目的。 仅在支持人员的指导下使用此参数。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Name
Name 参数指定特定请求的名称，以供跟踪和显示。 由于每个邮箱可以有多个还原请求，因此 Exchange 在名称前面加上邮箱的别名。 例如，如果为别名为 Kweku 的用户邮箱创建一个导出请求并将此参数的值指定为 RestoreFailedMoves，则该导出请求的标识为 Kweku\RestoreFailedMoves。
如果在创建还原请求时未指定名称，Exchange 将自动生成默认名称 MailboxRestore。 Exchange 最多生成 10 个名称，从 MailboxRestore 开始，然后是 MailboxRestoreX (其中 X = 1-9) 。
| 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 |
-Priority
此参数只在本地 Exchange 中可用。
Priority 参数指定该请求在请求队列中应有的处理顺序。 请求根据服务器运行状况、状态、优先级和最后更新时间按顺序处理。 有效的优先级值为：
- Lowest
- Lower
- Low
- 正常 (这是默认值。)
- 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 |
-RemoteCredential
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteDatabaseGuid
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteHostName
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteRestoreType
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | RemoteRestoreType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RequestExpiryInterval
此参数只在本地 Exchange 中可用。
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 |
-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 |
-SourceDatabase
此参数只在本地 Exchange 中可用。
SourceDatabase 参数指定要从中还原软删除或已断开连接的邮箱的数据库的标识。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceEndpoint
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | MigrationEndpointIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceExchangeGuid
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceIsArchive
SourceIsArchive 开关指定源邮箱为存档邮箱。 不必为此开关指定值。
此开关仅可与 SourceMailbox 参数一起使用。
| Type: | SwitchParameter |
| 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 |
-SourceMailbox
SourceMailbox 参数指定要还原的软删除邮箱。 识别软删除邮箱的最佳方法是使用其 GUID 值。 可以通过运行以下命令查找 GUID 值：Get-Mailbox -SoftDeletedMailbox.
| Type: | SourceMailbox |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceRootFolder
SourceRootFolder 参数指定从中还原数据的邮箱的根文件夹。 如果未指定此参数，该命令将还原所有文件夹。
| 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 |
-SourceStoreMailbox
此参数仅在本地 Exchange 中有效。
SourceStoreMailbox 参数指定要从中还原内容的源邮箱的 MailboxGUID。
可以通过运行 Get-MailboxStatistics cmdlet 找到 MailboxGUID。
| Type: | StoreMailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceTenant
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | SmtpDomain |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Suspend
Suspend 开关指定是否搁置请求。 不必为此开关指定值。
如果您使用此开关，则会将请求排入队列，但在使用相关恢复 cmdlet 恢复请求之前，请求不会处于 InProgress 状态。
| 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 |
-SuspendComment
SuspendComment 参数指定有关搁置请求的原因的说明。 如果指定了 Suspend 参数，则只能使用此参数。
| 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 |
-TargetIsArchive
TargetIsArchive 开关指定将内容还原到指定目标邮箱的存档中。 不必为此开关指定值。
| 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 |
-TargetMailbox
TargetMailbox 参数指定要将内容还原到的目标邮箱或邮件用户的 GUID。 在您可以成功运行此命令之前，应存在目标邮箱或邮件用户。
可以通过运行 Get-Mailbox 或 Get-MailUser cmdlet 来查找邮箱或邮件用户的 GUID 值。
在 Exchange 2016 或更高版本和Exchange Online中，此参数的类型是 MailboxLocationIdParameter。
在 Exchange 2013 或更早版本中，此参数的类型是 MailboxOrMailUserIdParameter。
| Type: | MailboxLocationIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetRootFolder
TargetRootFolder 参数指定要还原数据的顶级文件夹。 如果不指定此参数，该命令会将文件夹还原到目标邮箱或存档中的文件夹结构的顶部。 内容会合并到现有文件夹下，如果目标文件夹结构中还未包含这些内容，则创建新文件夹。
注意：若要将主邮箱的内容还原到存档邮箱，请使用此参数指定要将内容迁移到的存档邮箱文件夹。 还原后，此内容将可见。 如果不使用此参数，则还原的内容不可见，因为它映射到存档邮箱中对用户不可见的位置。
| 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 |
-TargetType
TargetType 参数指定邮箱的类型，该邮箱是还原操作的目标。 有效值包含:
- 存档
- MailboxLocation
- 主 (这是默认值)
| Type: | TargetTypeComponent |
| 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 |
-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 |
-WorkloadType
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | RequestWorkloadType |
| 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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。