共用方式為

Restore-RecoverableItems

模組:
Exchange PowerShell

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

使用 Restore-RecoverableItems items Cmdlet 來還原信箱中已刪除的專案。 您可以使用 Get-RecoverableItems Cmdlet 來尋找要復原的已刪除專案。

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

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

語法

OnPremises 

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

Cloud 

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

Description

如果項目的資訊可用，則項目會還原至原始資料夾位置。 如果找不到資訊，項目會還原至項目類型的預設資料夾 (郵件的收件匣、會議和約會的行事曆等 ) 。

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 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 message
  • 訊息主題：FY18 會計
  • 位置：可復原的專案\刪除
  • 日期範圍：2018 年 2 月 1 日至 2018 年 2 月 5 日

範例 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 中指定的信箱中已刪除的電子郵件訊息 「專案 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 message
  • 消息主題：COGS FY17 回顧
  • 位置：可復原的專案\刪除
  • 日期範圍：2019 年 3 月 15 日至 2019 年 3 月 25 日
  • 同時處理的信箱數目：2

範例 4

Get-RecoverableItems administrator | Restore-RecoverableItems

此範例會大量還原系統管理員的所有可復原專案。

參數

-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

身分識別參數會指定包含您要還原之已刪除專案的信箱。 您可以使用可唯一識別信箱的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

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

參數屬性

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

-NoOutput

適用：Exchange Online

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

NoOutput 參數會直接還原已刪除的項目，而不需要主控台中的任何命令輸出。 您不需要使用此參數指定值。

參數屬性

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

參數集

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

-PolicyTag

適用：Exchange Online

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

{{ 填寫 PolicyTag 說明 }}

參數屬性

類型:

String[]

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

參數集

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

-RestoreTargetFolder

適用：Exchange Online

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

RestoreTargetFolder 參數會指定要還原資料的最上層資料夾。 如果您未指定此參數，命令會將資料夾還原至目標信箱或封存中資料夾結構的最上層。 內容會合併到現有資料夾之下，如果目標資料夾結構中沒有資料夾，則會建立新資料夾。

此參數僅適用於主要信箱，並在封存信箱上忽略。 如果目的地資料夾不存在，則會建立目的地資料夾。 有效路徑包括：

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

前面或尾端 / 會被忽略。 然後，它會被視為 IPM 子樹狀結構的相對路徑： /Top Of Information Store。

參數屬性

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

參數集

Default
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

-SourceFolder

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

SourceFolder 參數會指定在信箱中搜尋已刪除專案的位置。 有效值為：

  • DeletedItems：已刪除的郵件資料夾。
  • RecoverableItems：可復原的 Items\Deletions 資料夾。 此資料夾包含已從 [刪除的郵件] 資料夾中刪除的專案 (虛刪除的專案) 。
  • PurgedItems：可復原的 Items\Purges 資料夾。 此資料夾包含已從 [可復原的專案] 資料夾清除的專案 (硬式刪除的專案) 。

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

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

參數屬性

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

參數集

OnPrem
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。