共用方式為

Restore-RecoverableItems

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

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

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

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

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

Syntax

Restore-RecoverableItems
       -Identity <GeneralMailboxOrMailUserIdParameter>
       [-EntryID <String>]
       [-FilterEndTime <DateTime>]
       [-FilterItemType <String>]
       [-FilterStartTime <DateTime>]
       [-LastParentFolderID <String>]
       [-ResultSize <Unlimited>]
       [-SourceFolder <RecoverableItemsFolderType>]
       [-SubjectContains <String>]
       [<CommonParameters>]
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 或參數所需的權限，請參閱 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訊息
  • 訊息主旨：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中以逗號分隔 (值指定的信箱，還原已刪除的電子郵件訊息 「Project 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訊息
  • 訊息主旨：COGS FY17 檢閱
  • 位置：可復原的專案\刪除
  • 日期範圍：2019/3/15 至 2019/3/25
  • 同時處理的信箱數目：2

範例 4

Get-RecoverableItems administrator | Restore-RecoverableItems

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

參數

-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

-NoOutput

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

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

Type:SwitchParameter
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

-RestoreTargetFolder

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

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

封存需要此參數，主要信箱則為選擇性。 如果目的地資料夾不存在，則會加以建立。 有效路徑為：

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

會忽略上述或尾端 / 。 然後，系統會將它視為 IPM 子樹狀結構的相對路徑： /Top Of Information Store 。

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
Accepted values:DeletedItems | RecoverableItems | PurgedItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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