Restore-RecoverableItems
內部部署 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/folder2folder1folder1/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 |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應