Set-PublicFolderMigrationRequest

模組:

ExchangePowerShell

適用於:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

使用 Set-PublicFolderMigrationRequest Cmdlet 來修改New-PublicFolderMigrationRequest Cmdlet) 所建立 (序列公用資料夾移轉要求。 您可以使用此 Cmdlet 從失敗的移轉要求復原。

注意：Exchange 2013 累積更新 8 (CU8) 終止公用資料夾的序列移轉支援，而 Cmdlet 已無法再于 Exchange Online 中使用。 請改用對應 的 *-MigrationBatch 和 *-PublicFolderMailboxMigration* Cmdlet。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Set-PublicFolderMigrationRequest
   [-Identity] <PublicFolderMigrationRequestIdParameter>
   [-AcceptLargeDataLoss]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-PreventCompletion <Boolean>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-WhatIf]
   [<CommonParameters>]

Set-PublicFolderMigrationRequest
   [-Identity] <PublicFolderMigrationRequestIdParameter>
   -RehomeRequest
   [-Confirm]
   [-DomainController <Fqdn>]
   [-PreventCompletion <Boolean>]
   [-RequestExpiryInterval <Unlimited>]
   [-WhatIf]
   [<CommonParameters>]

Description

您可以使用管線將 Get-PublicFolderMigrationRequestStatistics、Get-PublicFolderMigrationRequest 或Get-PublicFolder輸出傳送至此 Cmdlet。

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Set-PublicFolderMigrationRequest -Identity PublicFolderMigration -BadItemLimit 5

此範例會變更 PublicFolderMigration 移轉要求的設定，接受多達五個損毀的公用資料夾項目。

參數

-AcceptLargeDataLoss

AcceptLargeDataLoss 參數會指定要求應該繼續，即使來源信箱中的大量郵件無法複製到目標信箱也一樣。 您不需要使用此參數指定值。

如果您將 LargeItemLimit 參數設定為 51 或更高的值，則必須使用此參數。 否則，命令會失敗。

Type:	SwitchParameter
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

-BadItemLimit

BadItemLimit 參數會指定要求失敗之前所允許的錯誤項目數上限。 「錯誤項目」是來源信箱中無法複製到目標信箱的損毀項目。 錯誤項目限制中也包括「遺漏的項目」。 「遺漏的項目」是來源信箱中當要求準備完成時，在目標信箱中找不到的項目。

這個參數的有效輸入是整數或是值 unlimited。 預設值為 0，這表示如果偵測到任何錯誤項目，要求將會失敗。 如果不介意留下幾個錯誤項目，您可以將此參數設為一個合理值 (建議 10 或更低)，讓要求可以繼續進行。 如果偵測到太多錯誤項目，請考慮使用 New-MailboxRepairRequest Cmdlet，嘗試修正來源信箱中的損毀項目，然後重試要求。

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

-BatchName

BatchName 參數會指定公用資料夾批次移轉的描述性名稱。 您可以在使用 Get-PublicFolderMigrationRequest 指令程式時，使用BatchName 參數做為搜尋字串。

Type:	String
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

-CompletedRequestAgeLimit

CompletedRequestAgeLimit 參數會指定完成要求後，要將要求保留多久才可自動移除。 預設 CompletedRequestAgeLimit 參數值是 30 天。

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

-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 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定您想要修改的移轉要求。 您可以使用下列值：

• 名稱
• RequestGUID

Type:	PublicFolderMigrationRequestIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalFlags

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

-PreventCompletion

PreventCompletion 參數會指定是否要執行移j轉要求，但不允許它完成。 有效值為：

• $true：移轉要求已執行，但不允許完成。 若要完成移轉要求，請先將此參數設定為 $false，再執行 Resume-PublicFolderMigrationRequest Cmdlet。
• $false：移轉要求會執行並允許完成。 這是預設值。

Type:	Boolean
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

-Priority

Priority 參數會指定在要求佇列中處理要求的順序。 要求會根據伺服器健康狀況、狀態、優先順序與最上次更新時間，按照順序處理。 有效的優先順序值如下：

• 最低
• 較低
• 低
• 一般：這是預設值。
• 高
• 較高
• 最高
• 緊急狀況

Type:	RequestPriority
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

-RehomeRequest

RehomeRequest 參數會告訴Microsoft Exchange 信箱複寫服務 (MRS) 要求必須移至與要移轉之公用資料夾相同的資料庫。 您不需要使用此參數指定值。

此參數主要用於偵錯用途。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RequestExpiryInterval

RequestExpiryInterval 參數會指定完成或失敗之要求的保留天數。 當您使用這個參數時，系統會在指定的間隔到期後自動移除完成或失敗的要求。 如果您不使用這個參數：

• 系統會根據 CompletedRequestAgeLimit 參數值，自動移除完成的要求。
• 如果要求失敗，您必須使用對應的 Remove-*Request Cmdlet 手動移除它。

若要指定值，請將其輸入為時間範圍：dd.hh：mm：ss，其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。

當您使用值 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 參數會指定是否針對偵錯目的略過某些特定階段的移轉作業。 除非有 Microsoft 客戶服務與技術支援人員或特定說明文件指示這樣做，否則請勿使用此參數。

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

-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 2013, Exchange Server 2016, Exchange Server 2019

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。