Get-RecoverableItems

模組:
Exchange PowerShell

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。

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

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

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

語法

OnPremises 

Get-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-ResultSize <Unlimited>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Cloud 

Get-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter[]>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-MaxParallelSize <Int32>]
    [-PolicyTag <String[]>]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 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"

本範例會在兩者的 malik@contoso.com 信箱中，針對指定的日期/時間範圍， lillian@contoso.com 傳回所有可用的具有指定主旨的可復原已刪除郵件。

參數

-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
  • 使用者識別碼或使用者主要名稱 (UPN)

在 Exchange Online 中，您可以指定多個信箱，並以逗號分隔。 如果這些值包含空格或需要引號，請使用下列語法: "Value1","Value2",..."ValueN"。

警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。

參數屬性

類型: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

-PolicyTag

適用：Exchange Online

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

{{ 填滿政策標籤說明 }}

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

Cloud
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SkipCount

適用：Exchange Online

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

{{ 填滿 SkipCount 描述 }}

參數屬性

類型:Int32
預設值: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：[Recoverable Items\Deletions] 資料夾。 此資料夾包含已從 [刪除的郵件] 資料夾中刪除的項目， (虛刪除的郵件) 。
  • PurgedItems：[Recoverable Items\Purges] 資料夾。 此資料夾包含已從 [可復原的項目] 資料夾中清除的項目， () 的硬刪除項目。

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

  • DiscoveryHoldsItems (僅限雲端) ：Recoverable Items\DiscoveryHolds 資料夾。 此資料夾包含已從 [可復原的項目] 資料夾中清除的項目， () 的硬刪除項目，並且受到保留保護。 若要搜尋此資料夾中的刪除項目，請使用此參數搭配值 DiscoveryHoldsItems。

參數屬性

類型:RecoverableItemsFolderType
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
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。