Get-RecoverableItems
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用Get-RecoverableItems项目 cmdlet 查看邮箱中已删除的项目。 找到已删除的项目后，可使用 Restore-RecoverableItems cmdlet 还原它们。
此 cmdlet 仅在邮箱导入导出角色中可用，默认情况下，该角色不分配给任何角色组。 要使用此 cmdlet，需将邮箱导入导出角色添加到角色组（例如，添加到“组织管理”角色组）。 有关详细信息，请参阅向角色组添加角色。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Get-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] Get-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter[]>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-MaxParallelSize <Int32>]
[-PolicyTag <String[]>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] 说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"本示例返回邮箱 laura@contoso.com 中具有指定日期/时间范围内指定主题的所有可用可恢复已删除邮件。
示例 2
Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"本示例返回所有可用的可恢复已删除邮件，这些邮件在指定日期/时间范围内的邮箱lillian@contoso.com和 邮箱中具有malik@contoso.com指定主题。
参数
-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 |
-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 |
-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 |
| 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 |
-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 |