New-PublicFolderMoveRequest

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

使用 New-PublicFolderMoveRequest Cmdlet 開始在公用資料夾信箱之間移動公用資料夾內容的程式。 移動公用資料夾時將只會移動公用資料夾的實體內容，而不會變更邏輯階層。 當移動要求完成時，您必須執行Remove-PublicFolderMoveRequest Cmdlet 來移除要求，或等到 CompletedRequestAgeLimit 參數中指定的時間已過。 您必須先移除要求，才能執行另一個移動要求。

請注意，移動要求為作用中時，目標公用資料夾信箱將會鎖定。 如需詳細資訊，請參閱描述一節。

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

Syntax

New-PublicFolderMoveRequest
   -Folders <PublicFolderIdParameter[]>
   -TargetMailbox <MailboxIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLargeItems]
   [-BadItemLimit <Unlimited>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-Suspend]
   [-SuspendComment <String>]
   [-SuspendWhenReadyToComplete]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Description

New-PublicFolderMoveRequest Cmdlet 會將公用資料夾從來源公用資料夾信箱移至目標公用資料夾信箱。 當移動要求處於作用中狀態時，目標公用資料夾信箱將會鎖定。 因此，在移動要求完成之前，將無法存取已經位於目標公用資料夾信箱中的公用資料夾。 因此，在開始移動要求之前，您應該確定沒有任何使用者存取該目標公用資料夾信箱中的公用資料夾資料。

若要將公用資料夾信箱移至另一個信箱資料庫，請使用 New-MoveRequest Cmdlet。 若要確保此資料夾已在目標公用資料夾信箱中，請針對目標公用資料夾信箱執行 Update-PublicFolderMailbox Cmdlet。 您一次只能執行一個移動要求。 您也可以使用Move-PublicFolderBranch.ps1腳本來移動公用資料夾。

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

範例

範例 1

New-PublicFolderMoveRequest -Folders \DeveloperReports\CustomerEngagements -TargetMailbox DeveloperReports01

此範例會開始將公用資料夾 \CustomerEngagements 的移動要求從公用資料夾信箱 DeveloperReports 移至 DeveloperReports01。

範例 2

New-PublicFolderMoveRequest -Folders \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability -TargetMailbox DeveloperReports01

本範例會開始將 \Dev 公用資料夾分支下公用資料夾的移動要求移至目標公用資料夾信箱 DeveloperReports01。

您也可以使用Move-PublicFolderBranch.ps1腳本來移動公用資料夾的分支。

範例 3

$folders = Get-PublicFolder \ -Recurse -Mailbox PUB1 -ResidentFolders | ?{$_.Name -ne "IPM_SUBTREE"} | %{$_.Identity}

New-PublicFolderMoveRequest -TargetMailbox PUB2 -Folders $folders

本範例會將所有公用資料夾從公用資料夾信箱 Pub1 移至公用資料夾信箱 Pub2。

參數

-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

-AllowLargeItems

AllowLargeItems 參數會指定您只能在遇到大型專案時移動它們。 您不需要使用此參數指定值。

大型專案是電子郵件訊息，最多 1，023 個附件。

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

-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

-Folders

Folders 參數會指定您要移動的公用資料夾。 如果公用資料夾具有子公用資料夾，除非您在命令中明確陳述這些子公用資料夾，否則將不會移動這些子公用資料夾。 您可以移動多個公用資料夾，方法是以逗號分隔它們，例如\Dev\CustomerEngagements，\Dev\RequestsforChange，\Dev\Usability。

Type:PublicFolderIdParameter[]
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

-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

-Name

Name 參數會指定公用資料夾移動要求的名稱。 如果您未指定名稱，預設名稱為 PublicFolderMove。

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

-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

-RequestExpiryInterval

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

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

-SuspendComment

SuspendComment 參數會指定要求擱置原因的描述。 如果指定 Suspend 參數，就只能使用此參數。

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

-SuspendWhenReadyToComplete

SuspendWhenReadyToComplete 參數會指定是否要在要求到達 CompletionInProgress 狀態之前暫停要求。 您不需要使用此參數指定值。

移動暫停後，其狀態為 AutoSuspended。 之後您可以使用 Resume-PublicFolderMoveRequest 命令，以手動方式完成移動。

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

-TargetMailbox

TargetMailbox 參數會指定要將公用資料夾移至的目標公用資料夾信箱。 您可以使用可唯一識別信箱的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)
Type:MailboxIdParameter
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

-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

-WorkloadType

WorkloadType 參數會保留供 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

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