Restore-RecoverableItems
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Restore-RecoverableItems 项目 cmdlet 还原邮箱中已删除的项目。 使用 Get-RecoverableItems cmdlet 查找要恢复的已删除项。
此 cmdlet 仅在邮箱导入导出角色中可用，默认情况下，该角色不会分配给任何角色组。 要使用此 cmdlet，需将邮箱导入导出角色添加到角色组（例如，添加到“组织管理”角色组）。 有关详细信息，请参阅向角色组添加角色。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
OnPremises
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>]
Cloud
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter[]>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-MaxParallelSize <Int32>]
[-NoOutput]
[-PolicyTag <String[]>]
[-RestoreTargetFolder <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>]
说明
如果项目的信息可用，则项目将还原到原始文件夹位置。 如果找不到信息，项目将还原到项目类型的默认文件夹， (邮件的收件箱、会议和约会的日历等 ) 。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Restore-RecoverableItems -Identity laura@contoso.com -FilterItemType IPM.Note -SubjectContains "FY18 Accounting" -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"
使用 Get-RecoverableItems cmdlet 验证项目是否存在后，此示例从指定邮箱还原指定的已删除项目：
- 邮箱： laura@contoso.com
- 项目类型：Email消息
- 邮件主题：18 财年会计
- 位置：可恢复项目\删除
- 日期范围：2018/2/1 至 2/5/2018
示例 2
$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"
$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}
在 Exchange Server 中，本示例还原在 CSV () 文件 C：\My Documents\RestoreMessage.csv 的逗号分隔值中指定的邮箱的已删除电子邮件“Project X”。 CSV 文件使用标头值 SMTPAddress，并在单独的行中包含每个邮箱的电子邮件地址，如下所示：
SMTPAddress
chris@contoso.com
michelle@contoso.com
laura@contoso.com
julia@contoso.com
第一个命令将 CSV 文件读取到名为 $mailboxes 的变量。 第二个命令从这些邮箱中的“已删除邮件”文件夹中还原指定的邮件。
示例 3
Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2
在 Exchange Online 中，使用 Get-RecoverableItems cmdlet 验证项目是否存在后，此示例还原指定邮箱中的指定已删除项目：
- 邮箱： malik@contoso.com、 lillian@contoso.com
- 项目类型：Email消息
- 邮件主题：COGS 17 财年回顾
- 位置：可恢复项目\删除
- 日期范围：2019/3/15 至 3/25/2019
- 同时处理的邮箱数：2
示例 4
Get-RecoverableItems administrator | Restore-RecoverableItems
此示例为管理员批量还原所有可恢复的项。
参数
-EntryID
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
EntryID 参数指定要还原的已删除项。 已删除项目的 EntryID 值在邮箱中是唯一的。
可以在 Get-RecoverableItems cmdlet 上使用其他搜索筛选器来查找特定项目的 EntryID， (主题、日期范围等 ) 。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FilterEndTime
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
FilterEndTime 指定日期范围的结束日期/时间。 此参数使用项的 LastModifiedTime 值。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FilterItemType
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
FilterItemType 参数按指定的 MessageClass (ItemClass 筛选结果，) 已删除项目的属性值。 例如：
- IPM。约会 (会议和约会)
- IPM。联系
- IPM。文件
- IPM。注意
- IPM。任务
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FilterStartTime
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
FilterStartTime 指定日期范围的开始日期/时间。 此参数使用项的 LastModifiedTime 值。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 参数指定包含要还原的已删除项目的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
在Exchange Online中，可以指定用逗号分隔的多个邮箱。 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
参数属性
| 类型: | GeneralMailboxOrMailUserIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
OnPremises
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
Cloud
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-LastParentFolderID
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
LastParentFolderID 参数指定删除前项的 FolderID 值。 例如，53B93149989CA54DBC9702AE619B9CCA000062CE9397。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MaxParallelSize
适用：Exchange Online
此参数仅在基于云的服务中可用。
MaxParallelSize 参数指定命令并行处理的最大邮箱数。 有效值是 1 到 10 的整数。 通常，较高的值会减少在多个邮箱上完成命令所需的时间。
当 Identity 参数仅指定一个邮箱时，此参数的值无效。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Cloud
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-NoOutput
适用：Exchange Online
此参数仅在基于云的服务中可用。
NoOutput 开关直接还原已删除的项，而无需在控制台中输出任何命令。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Cloud
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PolicyTag
适用：Exchange Online
此参数仅在基于云的服务中可用。
{{ Fill PolicyTag Description }}
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Default
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RestoreTargetFolder
适用：Exchange Online
此参数仅在基于云的服务中可用。
RestoreTargetFolder 参数指定要在其中还原数据的顶级文件夹。 如果不指定此参数，该命令会将文件夹还原到目标邮箱或存档中的文件夹结构的顶部。 内容会合并到现有文件夹下，如果目标文件夹结构中还未包含这些内容，则创建新文件夹。
此参数仅在主邮箱上可用，在存档邮箱上被忽略。 如果目标文件夹不存在，则会创建该文件夹。 有效路径为：
//folder1/folder1/folder2folder1folder1/folder2
忽略前面的或尾 / 随。 然后，它被视为 IPM 子树的相对路径： /Top Of Information Store。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Default
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ResultSize
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SourceFolder
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SourceFolder 参数指定在邮箱中搜索已删除邮件的位置。 有效值包含:
- DeletedItems：“已删除邮件”文件夹。
- RecoverableItems：“可恢复的项目\删除”文件夹。 此文件夹包含已从“已删除邮件”文件夹中删除的项目， (软删除的项目) 。
- PurgedItems：可恢复的项目\Purges 文件夹。 此文件夹包含已从“可恢复的项目”文件夹中清除的项目， () 硬删除的项目。
如果不使用此参数，命令将搜索这三个文件夹。
- DiscoveryHoldsItems (仅限云) ：“可恢复的项目\DiscoveryHolds”文件夹。 此文件夹包含已从“可恢复的项目”文件夹中清除的项目， () 硬删除的项目，并受保留保护。 若要在此文件夹中搜索已删除的项目，请将此参数与值 DiscoveryHoldsItems 一起使用。
参数属性
| 类型: | RecoverableItemsFolderType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
OnPrem
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SubjectContains
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SubjectContains 参数按 Subject 字段中的指定文本值筛选已删除的项目。 如果值中有空格，请使用双引号 (") 将此值括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。