Restore-RecoverableItems
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用Restore-RecoverableItems项目 cmdlet 还原邮箱中已删除的项目。 使用 Get-RecoverableItems cmdlet 查找要恢复的已删除项。
此 cmdlet 仅在邮箱导入导出角色中可用，默认情况下，该角色不会分配给任何角色组。 要使用此 cmdlet，需将邮箱导入导出角色添加到角色组（例如，添加到“组织管理”角色组）。 有关详细信息，请参阅向角色组添加角色。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] 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
EntryID 参数指定要还原的已删除项。 已删除项目的 EntryID 值在邮箱中是唯一的。
可以在 Get-RecoverableItems cmdlet 上使用其他搜索筛选器来查找特定项目的 EntryID， (主题、日期范围等) 。
| Type: | String |
| 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 |
-FilterEndTime
FilterEndTime 指定日期范围的结束日期/时间。 此参数使用项的 LastModifiedTime 值。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
| Type: | DateTime |
| 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 |
-FilterItemType
FilterItemType 参数按指定的 MessageClass (ItemClass 筛选结果，) 已删除项目的属性值。 例如：
- Ipm。约会 (会议和约会)
- Ipm。联系
- Ipm。文件
- Ipm。注意
- Ipm。任务
| Type: | String |
| 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 |
-FilterStartTime
FilterStartTime 指定日期范围的开始日期/时间。 此参数使用项的 LastModifiedTime 值。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
| Type: | DateTime |
| 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 |
-Identity
Identity 参数指定包含要还原的已删除项目的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
在Exchange Online中，可以指定用逗号分隔的多个邮箱。 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
| Type: | GeneralMailboxOrMailUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-LastParentFolderID
LastParentFolderID 参数指定删除前项的 FolderID 值。 例如，53B93149989CA54DBC9702AE619B9CCA000062CE9397。
| Type: | String |
| 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 |
-MaxParallelSize
此参数仅在基于云的服务中可用。
MaxParallelSize 参数指定命令并行处理的最大邮箱数。 有效值是 1 到 10 的整数。 通常，较高的值会减少在多个邮箱上完成命令所需的时间。
当 Identity 参数仅指定一个邮箱时，此参数的值无效。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-NoOutput
此参数仅在基于云的服务中可用。
NoOutput 开关直接还原已删除的项，而无需在控制台中输出任何命令。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyTag
此参数仅在基于云的服务中可用。
{{ Fill PolicyTag Description }}
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RestoreTargetFolder
此参数仅在基于云的服务中可用。
RestoreTargetFolder 参数指定要在其中还原数据的顶级文件夹。 如果不指定此参数，该命令会将文件夹还原到目标邮箱或存档中的文件夹结构的顶部。 内容会合并到现有文件夹下，如果目标文件夹结构中还未包含这些内容，则创建新文件夹。
此参数对于存档是必需的，对于主邮箱是可选的。 如果目标文件夹不存在，则会创建该文件夹。 有效路径为：
//folder1/folder1/folder2folder1folder1/folder2
将忽略前面的或尾随 / 。 然后，它将被视为 IPM 子树的相对路径： /Top Of Information Store。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。
| 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 |
-SourceFolder
SourceFolder 参数指定在邮箱中搜索已删除邮件的位置。 有效值包含:
- DeletedItems：“已删除邮件”文件夹。
- RecoverableItems：“可恢复的项目\删除”文件夹。 此文件夹包含已从“已删除邮件”文件夹中删除的项目， (软删除的项目) 。
- PurgedItems：可恢复的项目\Purges 文件夹。 此文件夹包含已从“可恢复的项目”文件夹中清除的项目， () 硬删除的项目。
如果不使用此参数，命令将搜索这三个文件夹。
- DiscoveryHoldsItems：可恢复的项目\DiscoveryHolds 文件夹。 此文件夹包含已从“可恢复的项目”文件夹中清除的项目， () 硬删除的项目，并受保留保护。 若要在此文件夹中搜索已删除的项目，请将此参数与值 DiscoveryHoldsItems 一起使用。
| Type: | RecoverableItemsFolderType |
| Accepted values: | DeletedItems | RecoverableItems | PurgedItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SubjectContains
SubjectContains 参数按 Subject 字段中的指定文本值筛选已删除的项目。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| 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 |