Set-MailboxImportRequest
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能是一個環境或另一個環境獨佔。
在建立要求之後，使用 Set-MailboxImportRequest Cmdlet 來變更匯入要求選項。 您可以使用 Set-MailboxImportRequest 指令程式復原失敗的匯入要求。
此 Cmdlet 僅適用於信箱匯入匯出角色，而且根據預設，角色不會指派給任何角色群組。 若您要使用此 cmdlet，必須將「信箱匯入匯出」角色新增至角色群組 (例如，Organization Management 角色群組)。 如需詳細資訊，請參閱 將角色新增至角色群組。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Identity
Set-MailboxImportRequest
[-Identity] <MailboxImportRequestIdParameter>
[-AcceptLargeDataLoss]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-WhatIf]
[<CommonParameters>]
Rehome
Set-MailboxImportRequest
[-Identity] <MailboxImportRequestIdParameter>
[-RehomeRequest]
[-Confirm]
[-DomainController <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-WhatIf]
[<CommonParameters>]
Default
Set-MailboxImportRequest
[-Identity] <MailboxImportRequestIdParameter>
[-AzureSharedAccessSignatureToken <String>]
[-AcceptLargeDataLoss]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SkippedItemApprovalTime <System.DateTime>]
[-WhatIf]
[<CommonParameters>]
Description
您可以從 Get-MailboxImportRequest 指令程式使用管線處理 Set-MailboxImportRequest 指令程式。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-MailboxImportRequest -Identity "Kweku\Import" -BadItemLimit 5
此範例會將匯入要求 Kweku\Import 變更為接受最多 5 個損毀的信箱項目。
範例 2
Get-MailboxImportRequest -Status Suspended | Set-MailboxImportRequest -BatchName April14
此範例會尋找所有狀態為「已暫停」的匯入要求，然後為要求加上批次名稱 April14。
參數
-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 |
參數集
Default
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AzureSharedAccessSignatureToken
適用：Exchange Online
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BadItemLimit
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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 參數會指定批次的名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | 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 參數會指定完成要求後，要將要求保留多久才可自動移除。 預設 CompletedRequestAgeLimit 參數值是 30 天。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | 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 |
| 別名: | 參閱 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Rehome
| 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 參數會指定匯入要求的識別碼。 依預設，匯入要求會命名 <alias>\MailboxImportX 為 (其中 X = 0-9) 。 如果您使用 New-MailboxImportRequest Cmdlet 指定匯入要求的名稱，請使用下列語法： Alias\Name。
參數屬性
| 類型: | MailboxImportRequestIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-InternalFlags
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 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。
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。
RehomeRequest 參數會告知 Microsoft Exchange 信箱複寫服務 (MRS) ，要求必須移至與要匯入信箱相同的資料庫。 您不需要使用此參數指定值。
此交換器主要用於偵錯目的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Rehome
| Position: | Named |
| 必要: | True |
| 來自管線的值: | 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 |
參數集
Default
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkipMerging
適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SkipMerging 參數會指定匯入中應略過的步驟。 此參數主要用於偵錯目的。
參數屬性
| 類型: | SkippableMergeComponent[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkippedItemApprovalTime
適用：Exchange Online
此參數僅適用於雲端式服務
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | System.DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| 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 |
| 別名: | 威斯康星州 |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。