Restore-Mailbox
這個 Cmdlet 只能在 Exchange Server 2010 中使用。
使用 Restore-Mailbox Cmdlet 從還原的資料庫中擷取信箱內容。
注意：在 Exchange Server 2010 Service Pack 1 (SP1) 或更新版本中，使用 New-MailboxRestoreRequest Cmdlet 而非 Restore-Mailbox Cmdlet，從還原的資料庫中擷取信箱內容。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Restore-Mailbox
[-Identity] <MailboxIdParameter>
-RecoveryDatabase <DatabaseIdParameter>
-RecoveryMailbox <StoreMailboxIdParameter>
-TargetFolder <String>
[-AllowDuplicates]
[-AllContentKeywords <String[]>]
[-AttachmentFilenames <String[]>]
[-BadItemLimit <Int32>]
[-Confirm]
[-ContentKeywords <String[]>]
[-EndDate <DateTime>]
[-ExcludeFolders <MapiFolderPath[]>]
[-GlobalCatalog <Fqdn>]
[-IncludeFolders <MapiFolderPath[]>]
[-Locale <CultureInfo>]
[-MaxThreads <Int32>]
[-RecipientKeywords <String[]>]
[-SenderKeywords <String[]>]
[-StartDate <DateTime>]
[-SubjectKeywords <String[]>]
[-ValidateOnly]
[-WhatIf]
[<CommonParameters>]
Description
Restore-Mailbox Cmdlet 會將使用者資料從執行 Microsoft Exchange Server 2010 的任何伺服器，複製到相同組織內的 Exchange 2010 信箱伺服器上的信箱，該組織有足夠的空間和資源可支援該信箱。 Restore-Mailbox Cmdlet 只能使用伺服器上已中斷連線的信箱做為資料來源，而 Cmdlet 也只能使用連線的信箱做為資料的目標。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase
此範例會從資料庫 MyRecoveryDatabase 還原使用者 Scott 的信箱。
範例 2
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery
此範例會將 John 的信箱內容還原到 [修復] 資料夾底下的 Scott 信箱中。
範例 3
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar
此範例只會還原主旨為 Meeting、郵件內文包含 business 一詞，且郵件位置位於 Inbox 或 Calendar 資料夾中的郵件。 此範例假設信箱是英文。
範例 4
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase
此範例會大量還原 MyDatabase 信箱資料庫中也存在於 MyRecoveryDatabase 中的所有信箱。
參數
-AllContentKeywords
適用：Exchange Server 2010
AllContentKeywords 參數會指定下列所有項目的篩選條件：
- 主旨
- 郵件內文
- 附件內容
這允許對所有這些欄位進行 OR 搜尋。 如果您的搜尋準則是主旨、郵件內文或附件內容的一部分，則會得到結果。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AllowDuplicates
適用：Exchange Server 2010
AllowDuplicates 參數會複製郵件項目，而不會檢查它們是否為現有項目的重複項目，也不會移除重複項目。 您不需要使用此參數指定值。
建議您將此參數與 IncludeFolders 參數搭配使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AttachmentFilenames
適用：Exchange Server 2010
AttachmentFilenames 參數會指定附件檔案名稱的篩選。 您可以在字串中使用萬用字元。 例如，您可以使用 *.txt 來匯出副檔名為 .txt 的項目。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BadItemLimit
適用：Exchange Server 2010
BadItemLimit 參數會指定信箱中匯出作業失敗前要略過的損毀項目數目。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：Exchange Server 2010
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentKeywords
適用：Exchange Server 2010
ContentKeywords 參數會指定來源信箱中郵件內文和附件內容的關鍵字篩選條件。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EndDate
適用：Exchange Server 2010
EndDate 參數會指定篩選要從來源信箱匯出內容的結束日期。 只有信箱中日期早於結束日期的項目才會匯出。 輸入特定日期時，請使用在本機電腦上設定的 [地區選項] 設定中所定義的簡短日期格式。 例如，如果您的電腦設定為使用簡短的日期格式 MM/dd/yyyy，請輸入 03/01/2010 以指定 2010 年 3 月 1 日。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExcludeFolders
適用：Exchange Server 2010
ExcludeFolders 參數會指定要在匯出期間排除的資料夾清單。 輸入資料夾時會排除資料夾。 它們沒有當地語系化。 例如，排除 [行事曆] 只會排除英文版的 [行事曆]，因為其他語言的 [行事曆] 是不同的單字。
參數屬性
| 類型: | MapiFolderPath[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GlobalCatalog
適用：Exchange Server 2010
GlobalCatalog 參數會指定要用來搜尋目標信箱的通用類別目錄。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Server 2010
Identity 參數會指定您要還原的信箱。 您可以使用可唯一識別信箱的任何值。 例如：
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 網域\使用者名稱
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeFolders
適用：Exchange Server 2010
IncludeFolders 參數會指定要在匯出期間包含的資料夾清單。 輸入資料夾時即會包含在內。 它們沒有當地語系化。 例如，包含行事曆只包含英文的行事曆，因為其他語言的行事曆是不同的字。
參數屬性
| 類型: | MapiFolderPath[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Locale
適用：Exchange Server 2010
Locale 參數會指定要還原之郵件的地區設定。 使用此篩選設定後，只會擷取具有指定地區設定的郵件。
參數屬性
| 類型: | CultureInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaxThreads
適用：Exchange Server 2010
MaxThreads 參數會指定要使用的執行緒數目上限。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientKeywords
適用：Exchange Server 2010
RecipientKeywords 參數會指定來源信箱中項目收件者的關鍵字篩選條件。 此篩選會搜尋字串，即使它是文字的一部分。 這不是完整的單字搜尋。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecoveryDatabase
適用：Exchange Server 2010
RecoveryDatabase 參數會指定您要從中還原信箱的復原資料庫。 您可以使用唯一識別資料庫的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | DatabaseIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecoveryMailbox
適用：Exchange Server 2010
RecoveryMailbox 參數會指定要做為來源信箱的信箱。 如果來源信箱與目標信箱不同，則此參數為必要。
您可以透過信箱的 GUID 值來識別信箱。 您可以使用 Get-Mailbox 或 Get-MailboxStatistics Cmdlet 尋找 GUID 值。
參數屬性
| 類型: | StoreMailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SenderKeywords
適用：Exchange Server 2010
SenderKeywords 參數會針對來源信箱中的項目寄件者指定關鍵字篩選條件。 此篩選會搜尋字串，即使它是文字的一部分。 這不是完整的單字搜尋。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StartDate
適用：Exchange Server 2010
StartDate 參數會指定開始日期。 開始日期必須在結束日期之前。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SubjectKeywords
適用：Exchange Server 2010
SubjectKeywords 參數會針對來源信箱中的項目主旨指定關鍵字篩選條件。 此篩選會搜尋字串，即使它是文字的一部分。 這不是完整的單字搜尋。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetFolder
適用：Exchange Server 2010
TargetFolder 參數會指定在指定信箱上建立的信箱資料夾。 如果要還原的信箱與目標信箱不同，則此參數為必要。 (例如，使用 Identity 參數指定的值與以 RecoveryMailbox 參數指定的值不同。) 在這種情況下，Restore-Mailbox 命令會執行合併。 如果值相同，則不需要 TargetFolder 參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ValidateOnly
適用：Exchange Server 2010
ValidateOnly 參數會指定是否要評估命令的潛在成功或失敗，而不進行變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2010
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。