Set-MailboxRestoreRequest
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
建立要求之後，請使用 Set-MailboxRestoreRequest Cmdlet 變更還原要求選項。 您可以使用此 Cmdlet 從失敗的還原要求中復原。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Identity
Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-AcceptLargeDataLoss]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Priority <RequestPriority>]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>]
Rehome
Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-RehomeRequest]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-MailboxRestoreRequest -Identity "Ayla\MailboxRestore1" -BadItemLimit 10
此範例會變更 Ayla\MailboxRestore1 的第二個還原要求，以略過 10 個損毀的信箱項目。
範例 2
Set-MailboxRestoreRequest -Identity "Kweku\MailboxRestore" -BadItemLimit 100 -AcceptLargeDataLoss
此範例會將 Kweku 信箱的第一個還原要求變更為略過 100 個損毀項目。 因為 BadItemLimit 大於 50，所以必須指定 AcceptLargeDataLoss 參數。
參數
-AcceptLargeDataLoss
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
AcceptLargeDataLoss 參數會指定要求應該繼續，即使來源信箱中的大量郵件無法複製到目標信箱也一樣。 您不需要使用此參數指定值。
在 Exchange 2013 或更新版本中，如果您將 LargeItemLimit 參數設定為 51 或更高值，則需要使用此參數。 否則，命令會失敗。
在 Exchange 2010 中，如果您將 BadItemLimit 參數設為 51 或更高的值，則必須使用此參數。 否則，命令會失敗。
在 Exchange Online 中，此參數不相依於 BadItemLimit 或 LargeItemLimit 參數，因為這些參數無法使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BadItemLimit
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
BadItemLimit 參數會指定要求失敗之前所允許的錯誤項目數上限。 「錯誤項目」是來源信箱中無法複製到目標信箱的損毀項目。 錯誤項目限制中也包括「遺漏的項目」。 「遺漏的項目」是來源信箱中當要求準備完成時，在目標信箱中找不到的項目。
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0，這表示如果偵測到任何錯誤項目，要求將會失敗。 如果不介意留下幾個錯誤項目，您可以將此參數設為一個合理值 (建議 10 或更低)，讓要求可以繼續進行。 如果偵測到太多錯誤項目，請考慮使用 New-MailboxRepairRequest Cmdlet，嘗試修正來源信箱中的損毀項目，然後重試要求。
在 Exchange 2010 中，如果將此值設為 51 或更高的值，則也需要使用 AcceptLargeDataLoss 參數。 否則，命令會失敗。
附註：此參數已從雲端式服務中廢除。 系統管理員必須在還原完成之前檢閱 資料一致性分數 和任何略過的項目。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BatchName
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
BatchName 參數會指定批次的名稱。 使用此參數來變更、建立或移除批次名稱。
若要移除批次名稱，請將 BatchName 參數值設定為空白字串或 Null，例如 -BatchName “” 或 -BatchName $null。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CompletedRequestAgeLimit
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
CompletedRequestAgeLimit 參數會指定多久將已完成還原要求的狀態設定為 Completed。 如果此參數設定為值 0，則會立即清除狀態，而不會變更為已完成。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件
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 |
-DomainController
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
此參數只能在內部部署 Exchange 中運作。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件
Identity 參數會指定還原要求的識別碼。 Identity 參數包含要還原的信箱別名，以及建立還原要求時指定的名稱。 還原要求的身分識別使用下列語法： Alias\Name
如果未在還原要求建立時指定名稱，則 Exchange 會自動產生預設名稱 MailboxRestore。 Exchange 最多會產生 10 個名稱，首先是 MailboxRestore，然後是 MailboxRestoreX (，其中 X = 1-9) 。
參數屬性
| 類型: | MailboxRestoreRequestIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-InternalFlags
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
此參數只能在內部部署 Exchange 中運作。
InternalFlags 參數會指定要求中的選用步驟。 此參數主要用於偵錯目的。
參數屬性
| 類型: | InternalMrsFlag[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LargeItemLimit
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
LargeItemLimit 參數會指定要求失敗之前所允許的大型項目數上限。 「大型項目」是來源信箱中超出目標信箱中所允許之郵件大小上限的郵件。 如果目標信箱沒有特別設定的郵件大小上限值，則會使用全組織值。
如需郵件大小值上限的詳細資訊，請參閱 Exchange Server 中的郵件大小限制。
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0，這表示如果偵測到任何大型項目，要求將會失敗。 如果不介意留下幾個大型項目，您可以將此參數設為一個合理值 (建議 10 或更低)，讓要求可以繼續進行。
如果將此值設為 51 或更高，則也需要使用 AcceptLargeDataLoss 參數。 否則，命令會失敗。
附註：此參數已從雲端式服務中廢除。 系統管理員必須在還原完成之前檢閱 資料一致性分數 和任何略過的項目。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Priority
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
此參數只能在內部部署 Exchange 中運作。
Priority 參數會指定在要求佇列中處理要求的順序。 要求會根據伺服器健康狀況、狀態、優先順序與最上次更新時間，按照順序處理。 有效的優先順序值如下：
- 最低
- 較低
- 低
- 正常：此值為預設值。
- 高
- 較高
- 最高
- 緊急狀況
參數屬性
| 類型: | RequestPriority |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RehomeRequest
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
此參數只能在內部部署 Exchange 中運作。
RehomeRequest 參數會將信箱還原要求移至不同的信箱資料庫。 您不需要使用此參數指定值。
若必須移除原始移動要求中的來源信箱資料庫，請使用此參數來編輯信箱還原要求。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Rehome
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoteHostName
適用項目：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequestExpiryInterval
適用項目：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
RequestExpiryInterval 參數會指定完成或失敗之要求的保留天數。 當您使用這個參數時，系統會在指定的間隔到期後自動移除完成或失敗的要求。 如果您不使用這個參數：
- 系統會根據 CompletedRequestAgeLimit 參數值，自動移除完成的要求。
- 如果要求失敗，您必須使用對應的 Remove-*Request Cmdlet 手動移除要求。
若要指定值，請將其輸入為時間範圍：dd.hh：mm：ss 其中 dd = 天、hh = 小時、mm = 分鐘及 ss = 秒。
當您使用值 Unlimited 時，系統不會自動移除完成的要求。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkipInitialConnectionValidation
適用對象：Exchange Online
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkipMerging
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SkipMerging 參數會指定在還原信箱時，要略過多少資料夾相關的項目。 請使用下列其中一個值：
- FolderACLs
- FolderProperties
- FolderRules
- InitialConnectionValidation
只有在還原要求因為資料夾規則、資料夾存取控制清單 (ACL) 或初始連線驗證失敗時才可使用此參數。
參數屬性
| 類型: | SkippableMergeComponent[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkippedItemApprovalTime
適用對象：Exchange Online
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Rehome
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SourceWlmLevel
適用對象：Exchange Online
此參數只能在雲端式服務中使用。
{{ 填滿來源WlmLevel 描述 }}
參數屬性
| 類型: | WlmLevel |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetWlmLevel
適用對象：Exchange Online
此參數只能在雲端式服務中使用。
{{ 填滿 TargetWlmLevel 描述 }}
參數屬性
| 類型: | WlmLevel |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件
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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。