共用方式為

New-PublicFolderMoveRequest

模組:
Exchange PowerShell

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能是一個環境或另一個環境獨佔。

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

請注意，當移動要求處於作用中狀態時，目標公用資料夾信箱會鎖定。 如需詳細資訊，請參閱 說明 區段。

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

語法

Default (預設值) 

New-PublicFolderMoveRequest
    -Folders <PublicFolderIdParameter[]>
    -TargetMailbox <MailboxIdParameter>
    [-AcceptLargeDataLoss]
    [-AllowLargeItems]
    [-BadItemLimit <Unlimited>]
    [-CompletedRequestAgeLimit <Unlimited>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-InternalFlags <InternalMrsFlag[]>]
    [-Name <String>]
    [[-Organization] <OrganizationIdParameter>]
    [-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 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 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

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AllowLargeItems

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

大型項目是最多 1,023 個附件的電子郵件。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BadItemLimit

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CompletedRequestAgeLimit

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

CompletedRequestAgeLimit 參數會指定要求在完成之後，在自動移除之前保留多長時間。 此參數的預設值為 30 天。

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用：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 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

-Folders

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:

PublicFolderIdParameter[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InternalFlags

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

InternalFlags 參數會指定要求中的選用步驟。 此參數主要用於偵錯目的。

參數屬性

類型:

InternalMrsFlag[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Organization

適用：Exchange Online

此參數只能在雲端式服務中使用。

{{ 填寫組織說明 }}

參數屬性

類型:OrganizationIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:7
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Priority

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • 最低
  • 較低
  • 低
  • 正常：此值是預設值。
  • 高
  • 較高
  • 最高
  • 緊急狀況

參數屬性

類型:RequestPriority
預設值: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

-Suspend

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Suspend 參數會指定是否擱置要求。 您不需要使用此參數指定值。

如果您使用此參數，要求會排入佇列，但要求不會達到 InProgress 狀態，直到您使用相關的 resume Cmdlet 繼續要求為止。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SuspendComment

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SuspendWhenReadyToComplete

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TargetMailbox

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

參數屬性

類型:MailboxIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用：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

-WorkloadType

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

WorkloadType 參數會保留供 Microsoft 內部使用。

參數屬性

類型:RequestWorkloadType
預設值: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

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