Restore-Mailbox
此 Cmdlet 僅適用于 2010 Exchange Server。
使用 Restore-Mailbox Cmdlet 從還原的資料庫擷取信箱內容。
注意:在 Exchange Server 2010 Service Pack 1 (SP1) 或更新版本中,請使用 New-MailboxRestoreRequest Cmdlet,而不是使用 Restore-Mailbox Cmdlet 從還原的資料庫擷取信箱內容。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
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 或參數所需的權限,請參閱 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 的郵件,其中包含商務一字的郵件本文,以及 [收件匣] 或 [行事曆] 資料夾中的訊息位置。 此範例假設信箱是英文。
範例 4
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase
此範例會大量還原 MyDatabase 信箱資料庫中也存在於 MyRecoveryDatabase 中的所有信箱。
參數
-AllContentKeywords
AllContentKeywords 參數會指定下列所有專案的篩選:
- 主旨
- 訊息本文
- 附件內容
這可讓您對所有這些欄位進行 OR 搜尋。 如果您的搜尋準則是主旨、訊息本文或附件內容的一部分,您會得到結果。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AllowDuplicates
AllowDuplicates 參數會複製訊息項目,而不檢查訊息項目是否為現有專案的重複專案,且不移除重複的專案。 您不需要使用此參數指定值。
建議您搭配 IncludeFolders 參數使用此參數。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AttachmentFilenames
AttachmentFilenames 參數會指定附件檔案名的篩選準則。 您可以在字串中使用萬用字元。 例如,您可以使用 *.txt 匯出具有.txt副檔名的專案。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-BadItemLimit
BadItemLimit 參數會指定在匯出作業失敗之前,信箱中要略過的損毀專案數目。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ContentKeywords
ContentKeywords 參數會指定來源信箱中郵件本文和附件內容的關鍵字篩選。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-EndDate
EndDate 參數會指定篩選將從來源信箱匯出之內容的結束日期。 只會匯出其日期在結束日期之前之信箱中的專案。 當您輸入特定日期時,請使用在本機電腦上設定的 [區域選項] 設定中所定義的簡短日期格式。 例如,如果您的電腦設定為使用簡短日期格式 mm/dd/yyyy,請輸入 03/01/2010 以指定 2010 年 3 月 1 日。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ExcludeFolders
ExcludeFolders 參數會指定要在匯出期間排除的資料夾清單。 資料夾會在輸入時排除。 它們不會當地語系化。 例如,排除行事曆只會排除英文的行事曆,因為其他語言的行事曆是不同的單字。
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-GlobalCatalog
GlobalCatalog 參數會指定用來搜尋目標信箱的通用類別目錄。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Identity
Identity 參數會指定您要還原的信箱。 您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IncludeFolders
IncludeFolders 參數會指定要在匯出期間包含的資料夾清單。 資料夾會在輸入時包含在內。 它們不會當地語系化。 例如,包含行事曆只包含英文的行事曆,因為其他語言的行事曆是不同的單字。
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Locale
Locale 參數會指定要還原之訊息的地區設定。 使用此篩選集時,只會擷取具有指定地區設定的訊息。
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MaxThreads
MaxThreads 參數會指定要使用的執行緒數目上限。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecipientKeywords
RecipientKeywords 參數會指定來源信箱中專案收件者的關鍵字篩選。 此篩選器會尋找搜尋字串,即使它是單字的一部分也一樣。 這不是整字搜尋。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryDatabase
RecoveryDatabase 參數會指定您要從中還原信箱的復原資料庫。 您可以使用唯一識別資料庫的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryMailbox
RecoveryMailbox 參數會指定要當做來源信箱使用的信箱。 如果來源信箱與目標信箱不同,則需要此參數。
您可以依信箱的 GUID 值來識別信箱。 您可以使用 Get-Mailbox 或 Get-MailboxStatistics Cmdlet 尋找 GUID 值。
Type: | StoreMailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SenderKeywords
SenderKeywords 參數會指定來源信箱中專案寄件者的關鍵字篩選。 此篩選器會尋找搜尋字串,即使它是單字的一部分也一樣。 這不是整字搜尋。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-StartDate
StartDate 參數會指定開始日期。 開始日期必須位於結束日期之前。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SubjectKeywords
SubjectKeywords 參數會指定來源信箱中專案主體的關鍵字篩選。 此篩選器會尋找搜尋字串,即使它是單字的一部分也一樣。 這不是整字搜尋。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-TargetFolder
TargetFolder 參數會指定在指定信箱上建立的信箱資料夾。 如果要還原的信箱與目標信箱不同,則需要此參數。 (例如,使用 Identity 參數指定的值與使用 RecoveryMailbox 參數指定的值不同。) 在此情況下,Restore-Mailbox命令會執行合併。 如果值相同,則不需要 TargetFolder 參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ValidateOnly
ValidateOnly 參數會指示命令評估執行作業所需的條件和需求,然後報告作業成功或失敗。 您不需要使用此參數指定值。
當您使用此參數時,不會進行任何變更。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。