Get-RecoverableItems

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用Get-RecoverableItems專案 Cmdlet 來檢視信箱中已刪除的專案。 找到已刪除的郵件之後，您可以使用 Restore-RecoverableItems Cmdlet 來還原它們。

此 Cmdlet 只能在信箱匯入匯出角色中使用，而且根據預設，角色不會指派給任何角色群組。 若您要使用此 cmdlet，必須將「信箱匯入匯出」角色新增至角色群組 (例如，Organization Management 角色群組)。 如需詳細資訊，請 參閱將角色新增至角色群組。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 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"

本範例會針對指定的日期/時間範圍，傳回和 信箱 malik@contoso.comlillian@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)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (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

此參數只能在雲端式服務中使用。

{{ 填滿 PolicyTag 描述 }}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 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：[可復原的專案\清除] 資料夾。 此資料夾包含已從 [可復原的專案] 資料夾中清除的專案， () 的硬式刪除專案。

    如果您未使用此參數，命令會搜尋這三個資料夾。

  • 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 參數會依 [主旨] 欄位中指定的文字值來篩選項目。 如果值包含空格，請使用引號 (") 括住值。

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