Get-RecoverableItems

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Server 2016, Exchange Server 2019, Exchange Online

此 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