New-MailboxRestoreRequest
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
您可以使用 New-MailboxRestoreRequest 指令程式，還原虛刪除或已中斷連線的信箱。 這個指令程式會開始將虛刪除信箱、已停用信箱或復原資料庫中任何信箱的內容，移到已連線的主要或封存信箱。
在Exchange Server和Exchange Online中，用來尋找已中斷連線信箱和還原信箱的屬性不同。 如需Exchange Online的詳細資訊，請參閱還原非作用中的信箱。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-MRSServer <Fqdn>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceEndpoint <MigrationEndpointIdParameter>
-SourceExchangeGuid <Guid>
-SourceTenant <SmtpDomain>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-CrossTenantRestore]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-RemoteDatabaseGuid <Guid>
-RemoteHostName <Fqdn>
-RemoteRestoreType <RemoteRestoreType>
-RemoteCredential <PSCredential>
-SourceMailbox <MailboxLocationIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceIsArchive]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] Description
當信箱從一個資料庫移至另一個資料庫時，Exchange 不會在移動完成時立即從源資料庫完全刪除信箱。 而是會將來源信箱資料庫中的信箱切換到「虛刪除」狀態，這樣便可使用新的 MailboxRestoreRequest 指令程式集，在信箱還原作業期間存取信箱資料。 在已刪除信箱保留期間到期或使用 Remove-StoreMailbox 指令程式來清除信箱之前，虛刪除的信箱會保留在來源資料庫中。
若要檢視虛刪除信箱，請對資料庫執行 Get-MailboxStatistics 指令程式，並查看其 DisconnectReason 中的值為 SoftDeleted 的結果。 如需詳細資訊，請參閱本主題稍後的＜範例 1＞。
在 Disable-Mailbox 或 Remove-Mailbox 命令完成一小段時間之後，系統便會將信箱標記為「停用」。
在 Microsoft Exchange 資訊存放區服務判斷 Active Directory 已使用已停用的信箱資訊更新之前，信箱不會標示為 [已停用]。 您可以對該資料庫執行 Update-StoreMailboxState Cmdlet，來加速處理程序。
Exchange 會根據針對該信箱資料庫設定的已刪除信箱保留設定，保留信箱資料庫中已停用的信箱。 在經過指定的期間後，便會永久刪除信箱。
若要檢視已停用信箱，請對資料庫執行 Get-MailboxStatistics 指令程式，並查看其 DisconnectReason 中的值為 Disabled 的結果。 如需詳細資訊，請參閱本主題稍後的範例 2 和 3。
您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
注意：若要將主要信箱的內容還原至封存信箱，請使用 TargetRootFolder 參數來指定要將內容移轉至其中的封存信箱資料夾。 此內容會在還原之後顯示。 如果您未使用此參數，則不會顯示還原的內容，因為它會對應至封存信箱中使用者看不到的位置。
範例
範例 1
Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox Ayla在內部部署 Exchange 中，此範例會使用 Get-MailboxStatistics Cmdlet 來傳回 DisplayName、LegacyExchangeDN 和 MailboxGUID， (針對信箱資料庫中所有名稱為 MBD01 且中斷連線原因為 SoftDeleted 或 Disabled 的信箱，) 有效的來源信箱識別值。
使用此資訊，MailboxGUID 值為 1d20855f-fd54-4681-98e6-e249f7326ddd 的來源信箱會還原至具有別名值 Ayla 的目標信箱。
範例 2
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive在內部部署 Exchange 中，此範例會將信箱資料庫 MBD01 上具有 Smith Smith DisplayName 的來源信箱內容還原至 的 Tony@contoso.com 封存信箱。
參數
-AcceptLargeDataLoss
AcceptLargeDataLoss 參數會指定要求應該繼續，即使來源信箱中的大量郵件無法複製到目標信箱也一樣。 您不需要使用此參數指定值。
在 Exchange 2013 或更新版本或 Exchange Online 中，如果您將 LargeItemLimit 參數設為 51 或更高的值，則必須使用此參數。 否則，命令會失敗。
在 Exchange 2010 中，如果您將 BadItemLimit 參數設為 51 或更高的值，則必須使用此參數。 否則，命令會失敗。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AllowLegacyDNMismatch
AllowLegacyDNMismatch 參數會指定如果來源實體信箱和目標信箱的 LegacyExchangeDN 不相符，作業應該繼續。 您不需要使用此參數指定值。
依預設，這個指令程式會檢查以確定來源實體信箱上的 LegacyExchangeDN 是否會以 LegacyExchangeDN 的形式出現在目標使用者上，或者 X500 Proxy 位址是否會對應到 LegacyExchangeDN。 這項檢查可防止您不慎將來源信箱還原到不正確的目標信箱。
注意：此參數在雲端式服務中已遭取代。 若要針對具有不相符之 LegacyExchangeDN 的信箱完成信箱還原要求，您必須取得來源信箱的 LegacyExchangeDN 值，並將其新增至目標信箱作為 X500 Proxy 位址。 如需詳細指示，請 參閱還原非使用中信箱。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AssociatedMessagesCopyOption
AssociatedMessagesCopyOption 參數指定是否在處理要求時複製相關聯的訊息。 相關聯訊息是特殊訊息，包含規則、檢視與表單等相關資訊的隱藏資料。 有效值為：
- DoNotCopy：不會複製相關聯的訊息。
- MapByMessageClass：查閱來源訊息的 MessageClass 屬性來尋找相關聯的訊息。 如果來源和目的檔案夾中都有此類別的相關聯訊息，它會覆寫目標中的相關聯訊息。 如果目標中沒有相關聯的訊息，它會在目標中建立複本。
- 複製：將相關聯的訊息從來源複製到目標。 如果來源和目標位置都存在相同的訊息類型，這些相關聯的訊息就會重複。 這是預設值。
Copy：此選項會從來源將相關訊息複製到目標。如果來源和目標位置都有相同的訊息類型，這些相關聯訊息就會重複。此為預設選項。
| Type: | FAICopyOption |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BadItemLimit
BadItemLimit 參數會指定要求失敗之前所允許的錯誤項目數上限。 「錯誤項目」是來源信箱中無法複製到目標信箱的損毀項目。 錯誤項目限制中也包括「遺漏的項目」。 「遺漏的項目」是來源信箱中當要求準備完成時，在目標信箱中找不到的項目。
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0，這表示如果偵測到任何錯誤項目，要求將會失敗。 如果不介意留下幾個錯誤項目，您可以將此參數設為一個合理值 (建議 10 或更低)，讓要求可以繼續進行。 如果偵測到太多錯誤項目，請考慮使用 New-MailboxRepairRequest Cmdlet，嘗試修正來源信箱中的損毀項目，然後重試要求。
在 Exchange 2010 中，如果將此值設為 51 或更高的值，則也需要使用 AcceptLargeDataLoss 參數。 否則，命令會失敗。
注意：此參數在雲端式服務中已遭取代。 如果您日後不使用此參數，將會改用「已略過的項目」核准語義。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BatchName
BatchName 參數會指定描述性名稱，以用於還原一批信箱。 您可以在使用 Get-MailboxRestoreRequest 指令程式時，使用 BatchName 參數中的名稱做為搜尋字串。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompletedRequestAgeLimit
CompletedRequestAgeLimit 參數會指定多久將已完成還原要求的狀態設定為 Completed。 如果此參數設定為 0 值，就會立刻清除狀態，而不是變更為 Completed。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConflictResolutionOption
ConflictResolutionOption 參數會指定如果目標中有多個相符的訊息，該怎麼做。 有效值為：
- ForceCopy
- KeepAll
- KeepLatestItem
- KeepLatestItem
- KeepTargetItem
- UpdateFromSource
| Type: | ConflictResolutionOption |
| Position: | Named |
| Default value: | KeepSourceItem |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ContentFilter
此參數只能在雲端式服務中使用。
ContentFilter 參數會使用 OPATH 篩選語法，依指定的屬性和值來篩選結果。 只會還原符合 ContentFilter 參數的內容。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。
- 以雙引號 「」 括住整個 OPATH 篩選準則。 如果篩選條件包含系統值 (例如
$true、$false或$null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。 - Property 是可篩選的屬性。 如需可篩選的屬性，請 參閱 ContentFilter 參數的可篩選屬性。
- ComparisonOperator 是 OPATH 比較運算子 (例如
-eqequals 和-like字串比較) 。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。 - Value 是要搜尋的屬性值。 以單引號括住文字值和變數 (
'Value'或'$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用'$($User -Replace "'","''")'，而不是'$User'。 請勿以引號括住整數或系統值 (例如，請改用500、$true、$false或$null) 。
您可以使用邏輯運算子 -and 和 -or 將多個搜尋準則鏈結在一起。 例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。
如需 Exchange 中 OPATH 篩選的詳細資訊，請參閱 其他 OPATH 語法資訊。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ContentFilterLanguage
此參數只能在雲端式服務中使用。
ContentFilterLanguage 參數會指定 ContentFilter 參數中為進行參數搜尋所使用的語言。
此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化特性程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-CrossTenantRestore
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DomainController
此參數只能在內部部署 Exchange 中運作。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExcludeDumpster
ExcludeDumpster 參數會指定是否要排除 [可復原的專案] 資料夾。 您不需要使用此參數指定值。
如果您未使用此參數，則會使用下列子資料夾複製 [可復原的專案] 資料夾：
- 刪除
- 版本
- 清除
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExcludeFolders
ExcludeFolders 參數會指定要在還原要求期間排除的資料夾清單。
如果 exADNoMk 同盟服務 (AD FS) 部署為允許單一登入外部信箱，且 AD FS 已設定為針對登入 Token 要求使用 ExchangeGUID 以外的屬性，則您必須設定 ImmutableId 參數。 exExchangeNoVersion 與 AD FS 都必須為同一位使用者要求同一個 Token，以確保跨單位 exExchangeNoVersion 部署案例的正常運作。
<FolderName>/*：使用此語法表示 SourceRootFolder 參數中指定之資料夾下的個人資料夾，例如 「MyProjects」 或 「MyProjects/FY2010」。
#<FolderName>#/*：使用此語法表示已知的資料夾，而不論資料夾的名稱是其他語言。 例如，#Inbox# 代表 [收件匣] 資料夾，即使收件匣是以土耳其文當地語系化，也就是 Gelen Kutusu。 已知的資料夾包含下列類型：
- 收件匣
- SentItems
- DeletedItems
- 行事曆
- 聯絡人
- 草稿
- 日誌
- 工作
- 附註
- 垃圾郵件
- CommunicatorHistory
- 語音信箱
- 傳真
- Conflicts
- SyncIssues
- LocalFailures
- ServerFailures
如果使用者建立與已知資料夾同名的個人資料夾及其周圍的 # 符號，您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。 例如，如果使用者建立名為 #Notes# 的資料夾，而您想要指定該資料夾，而不是已知的 Notes 資料夾，請使用下列語法： \#Notes\# 。
如果使用者建立的個人資料夾與已知資料夾的名稱相同，並以 # 符號環繞，您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。例如，若使用者建立了名稱為 #Notes# 的資料夾，而您要指定該資料夾，但不是已知的 Notes 資料夾，請使用下列語法：\#Notes\#.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeFolders
IncludeFolders 參數會指定要在還原要求要求期間加入的資料夾清單。
如果 exADNoMk 同盟服務 (AD FS) 部署為允許單一登入外部信箱，且 AD FS 已設定為針對登入 Token 要求使用 ExchangeGUID 以外的屬性，則您必須設定 ImmutableId 參數。 exExchangeNoVersion 與 AD FS 都必須為同一位使用者要求同一個 Token，以確保跨單位 exExchangeNoVersion 部署案例的正常運作。
<FolderName>/*：使用此語法表示 SourceRootFolder 參數中指定之資料夾下的個人資料夾，例如 「MyProjects」 或 「MyProjects/FY2010」。
#<FolderName>#/*：使用此語法表示已知的資料夾，而不論資料夾的名稱是其他語言。 例如，#Inbox# 代表 [收件匣] 資料夾，即使收件匣是以土耳其文當地語系化，也就是 Gelen Kutusu。 已知的資料夾包含下列類型：
- 收件匣
- SentItems
- DeletedItems
- 行事曆
- 聯絡人
- 草稿
- 日誌
- 工作
- 附註
- 垃圾郵件
- CommunicationHistory
- 語音信箱
- 傳真
- Conflicts
- SyncIssues
- LocalFailures
- ServerFailures
如果使用者建立與已知資料夾同名的個人資料夾及其周圍的 # 符號，您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。 例如，如果使用者建立名為 #Notes# 的資料夾，而您想要指定該資料夾，而不是已知的 Notes 資料夾，請使用下列語法： \#Notes\# 。
如果使用者建立的個人資料夾與已知資料夾的名稱相同，並以 # 符號環繞，您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。例如，若使用者建立了名稱為 #Notes# 的資料夾，而您要指定該資料夾，但不是已知的 Notes 資料夾，請使用下列語法：\#Notes\#.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-InternalFlags
此參數僅適用於內部部署 Exchange。
InternalFlags 參數會指定要求中的選用步驟。 此參數主要用於偵錯目的。
| Type: | InternalMrsFlag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LargeItemLimit
LargeItemLimit 參數會指定要求失敗之前所允許的大型項目數上限。 「大型項目」是來源信箱中超出目標信箱中所允許之郵件大小上限的郵件。 如果目標信箱沒有特別設定的郵件大小上限值，則會使用全組織值。
如需郵件大小上限值的詳細資訊，請參閱下列主題：
- Exchange 2016：Exchange Server中的訊息大小限制
- Exchange Online：Exchange Online 的限制
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0，這表示如果偵測到任何大型項目，要求將會失敗。 如果不介意留下幾個大型項目，您可以將此參數設為一個合理值 (建議 10 或更低)，讓要求可以繼續進行。
如果將此值設為 51 或更高，則也需要使用 AcceptLargeDataLoss 參數。 否則，命令會失敗。
注意：此參數在雲端式服務中已遭取代。 如果您日後不使用此參數，將會改用「已略過的項目」核准語義。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MRSServer
此參數僅適用于 2010 Exchange Server。
MRSServer 參數會指定用戶端存取伺服器的 FQDN，Microsoft Exchange 信箱複寫服務 (MRS) 的執行個體在此用戶端存取伺服器上執行。 此參數僅用於偵錯目的。 只有在支援人員的指示下才可以使用此參數。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Name
Name 參數會指定特定要求的名稱，以用於追蹤和顯示。 因為每個信箱可以有多個還原要求，所以 Exchange 會在名稱前面加上信箱的別名。 例如，如果對別名為 Kweku 的使用者信箱建立匯出要求，並將此參數的值指定為 RestoreFailedMoves，則此匯出要求的識別碼為 Kweku\RestoreFailedMoves。
如果您在建立還原要求時未指定其名稱，Exchange 會自動產生預設名稱 MailboxRestore。 Exchange 最多會產生 10 個名稱，從 MailboxRestore 開始，然後再產生 MailboxRestoreX (其中 X = 1-9) 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
此參數僅適用於內部部署 Exchange。
Priority 參數會指定在要求佇列中處理要求的順序。 要求會根據伺服器健康狀況、狀態、優先順序與最上次更新時間，按照順序處理。 有效的優先順序值如下：
- 最低
- 較低
- 低
- 一般 (這是預設值。)
- 高
- 較高
- 最高
- 緊急狀況
| Type: | RequestPriority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoteCredential
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteDatabaseGuid
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteHostName
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteRestoreType
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | RemoteRestoreType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RequestExpiryInterval
此參數僅適用於內部部署 Exchange。
RequestExpiryInterval 參數會指定完成或失敗之要求的保留天數。 當您使用這個參數時，系統會在指定的間隔到期後自動移除完成或失敗的要求。 如果您不使用這個參數：
- 系統會根據 CompletedRequestAgeLimit 參數值，自動移除完成的要求。
- 如果要求失敗，您必須使用對應的 Remove-*Request Cmdlet 手動移除它。
若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。
當您使用值 Unlimited 時，系統不會自動移除完成的要求。
| 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 |
-SkipMerging
SkipMerging 參數會指定在還原信箱時，要略過多少資料夾相關的項目。 請使用下列其中一個值：
- FolderACLs
- FolderProperties
- FolderRules
- InitialConnectionValidation
只有在還原要求因為資料夾規則、資料夾存取控制清單 (ACL) 或初始連線驗證失敗時才可使用此參數。
| Type: | SkippableMergeComponent[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceDatabase
此參數僅適用於內部部署 Exchange。
SourceDatabase 參數會指定資料庫的識別碼，您可以從這個資料庫中還原虛刪除或已中斷連線的信箱。 您可以使用唯一識別資料庫的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceEndpoint
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | MigrationEndpointIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceExchangeGuid
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceIsArchive
SourceIsArchive 參數會指定來源信箱是封存信箱。 您不需要使用此參數指定值。
此參數只能與 SourceMailbox 參數搭配使用。
| Type: | SwitchParameter |
| 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 |
-SourceMailbox
SourceMailbox 參數會指定您要還原的虛刪除信箱。 識別虛刪除信箱的最佳方式是依據其 GUID 值。 您可以執行下列命令來尋找 GUID 值：Get-Mailbox -SoftDeletedMailbox.
| Type: | SourceMailbox |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceRootFolder
SourceRootFolder 參數會指定要從其中還原資料之信箱的根資料夾。 如果未指定此參數，命令會還原所有資料夾。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceStoreMailbox
此參數只能在內部部署 Exchange 中運作。
SourceStoreMailbox 參數會指定您要從中還原內容之來源信箱的 MailboxGUID。
您可以執行 Get-MailboxStatistics Cmdlet 來尋找 MailboxGUID。
| Type: | StoreMailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceTenant
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | SmtpDomain |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Suspend
Suspend 參數會指定是否擱置要求。 您不需要使用此參數指定值。
如果您使用此參數，要求會加入佇列，但要求不會變成 InProgress 狀態，直到您使用相關的 resume 指令程式來繼續要求為止。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuspendComment
SuspendComment 參數會指定要求擱置原因的描述。 如果指定 Suspend 參數，就只能使用此參數。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetIsArchive
TargetIsArchive 參數會指定將內容還原到指定的目標信箱封存中。 您不需要使用此參數指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetMailbox
TargetMailbox 參數會指定您要還原內容的目標信箱或郵件使用者的 GUID。 目標信箱或郵件使用者必須存在，您才能順利執行這個指令。
您可以執行Get-Mailbox或Get-MailUser Cmdlet 來尋找信箱或郵件使用者的 GUID 值。
在 Exchange 2016 或更新版本和 Exchange Online 中，此參數的類型為 MailboxLocationIdParameter。
在 Exchange 2013 或更早版本中，此參數的類型為 MailboxOrMailUserIdParameter。
| Type: | MailboxLocationIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetRootFolder
TargetRootFolder 參數會指定要還原資料的目標最上層資料夾。 如果您未指定此參數，命令會將資料夾還原至目標信箱或封存中資料夾結構的最上層。 內容會合併到現有資料夾之下，如果目標資料夾結構中沒有資料夾，則會建立新資料夾。
注意：若要將主要信箱的內容還原至封存信箱，請使用此參數來指定要移轉內容的封存信箱資料夾。 此內容會在還原之後顯示。 如果您未使用此參數，則不會顯示還原的內容，因為它會對應至封存信箱中使用者看不到的位置。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetType
TargetType 參數會指定做為還原作業目標的信箱類型。 有效值為：
- 封存
- MailboxLocation
- 主要 (這是預設值)
| Type: | TargetTypeComponent |
| 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 |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkloadType
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
| Type: | RequestWorkloadType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。