Set-MigrationBatch
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Set-MigrationBatch Cmdlet ，更新一批使用者的移轉要求。 如需相關資訊，請參閱New-MigrationBatch。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
Set-MigrationBatch
[-Identity] <MigrationBatchIdParameter>
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ApproveSkippedItems]
[-AutoRetryCount <Int32>]
[-BadItemLimit <Unlimited>]
[-CSVData <Byte[]>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <TimeSpan>]
[-SkipMerging <MultiValuedProperty>]
[-SkipMoving <MultiValuedProperty>]
[-SkipReports <Boolean>]
[-SourcePublicFolderDatabase <DatabaseIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-Update]
[-WhatIf]
[<CommonParameters>] Description
Set-MigrationBatch Cmdlet 會以下列其中一種案例設定您現有的移轉批次，移轉信箱與信箱資料。
- 本機移動
- 跨樹系移動
- 遠端移動
- Exchange 完全移轉
- Exchange 分段移轉
- 網際網路訊息存取通訊協定 (IMAP) 移轉
- Google Workspace (先前稱為 G Suite) 移轉
某些設定可以同時套用至批次以及批次內的個別使用者。 請務必注意，當設定套用至使用者時，它會覆寫批次上的任何對應設定。
您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems此範例會為先前偵測到批次中的所有使用者核准所有略過的專案，藉以更新 MigrationBatch01。
參數
-AllowIncrementalSyncs
此參數僅適用於內部部署 Exchange。
AllowIncrementalSyncs 參數可指定要啟用還是停用增量同步處理。 有效值為：
- $true：已啟用累加式同步處理。 傳送至來源信箱的任何新郵件，每隔 24 小時會複製一次至對應的目標信箱。
- $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 |
-AllowUnknownColumnsInCsv
AllowUnknownColumnsInCsv 參數可指定是否允許 CSV 檔案中有移轉不會使用的額外資料行。 有效值為：
- $true：移轉會忽略 (以無訊息方式略過 CSV 檔案中) 未知的資料行 (包括) 拼錯資料行標頭的選擇性資料行。 所有未知的資料行都會被視為移轉未使用的額外資料行。
- $false：如果 CSV 檔案中有任何未知的資料行，移轉就會失敗。 此設定可防止資料行標頭髮生拼字錯誤。 這是預設值。
| 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, Exchange Online |
-ApproveSkippedItems
此參數只能在雲端式服務中使用。
ApproveSkippedItems 參數會將目前時間之前探索到的所有略過專案標示為已核准。 您不需要使用此參數指定值。
如果在此移轉期間偵測到的資料遺失相當嚴重，在未核准略過的專案的情況下，移轉將無法完成。 專案可能因為來源信箱損毀而略過，而且無法複製到目標信箱、大於為租使用者設定的最大允許郵件大小，或在移轉準備完成時，從目標信箱中偵測到遺失。
如需訊息大小上限值的詳細資訊，請參閱下列主題Exchange Online限制] 。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AutoRetryCount
此參數僅適用於內部部署 Exchange。
AutoRetryCount 參數會指定嘗試重新啟動遷移批次以遷移遇到錯誤的信箱次數。
| Type: | Int32 |
| 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, Exchange Online |
-CompleteAfter
此參數只能在雲端式服務中運作。
CompleteAfter 參數會指定批次完成之前的延遲。 批次的資料移轉將會開始，但完成作業要等到您使用此參數指定的日期/時間才會開始。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
在 Exchange Online PowerShell 中，如果您指定沒有時區的日期/時間值，該值會以國際標準時間 (UTC) 。 若要指定值，請使用下列其中一個選項：
- 以 UTC 指定日期/時間值：例如。
"7/30/2020 9:00PM Z" - 在您的當地時區中指定日期/時間值。 例如，
"7/30/2020 9:00PM -700"。 如果您不使用 TimeZone 參數，此值將會轉換成 UTC。
| Type: | DateTime |
| 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, Exchange Online |
-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, Exchange Online |
-CSVData
此參數僅適用於內部部署 Exchange。
CSVData 參數會指定包含要移動或遷移之使用者信箱相關資訊的 CSV 檔案。 CSV 檔案標題列中所需的屬性將根據遷移類型有所不同。
此參數的有效值需要您使用下列語法，將檔案讀取至位元組編碼的物件： ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')) 。 您可以使用此命令作為參數值，也可以將輸出寫入變數 () $data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>') ，並使用 變數作為參數值 () $data 。
注意：此參數不會根據 RBAC 範圍驗證信箱的可用性。 CSV 檔案中指定的所有信箱都會移轉，即使這些信箱不在 RBAC 範圍之外 (例如，OU) 會提供系統管理員移轉信箱的許可權。
| Type: | Byte[] |
| 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
此參數僅適用於內部部署 Exchange。
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 參數會指定您要修改的移轉批次。 您可以使用可唯一識別移轉批次的任何值。 例如：
- 名稱 (Identity 屬性值)
- GUID (BatchGuid 屬性值)
| Type: | MigrationBatchIdParameter |
| 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, Exchange Online |
-LargeItemLimit
LargeItemLimit 參數會指定移轉要求失敗之前允許的大型專案數目上限。 「大型項目」是來源信箱中超出目標信箱中所允許之郵件大小上限的郵件。 如果目標信箱沒有特別設定的郵件大小上限值，則會使用全組織值。
如需郵件大小上限值的詳細資訊，請參閱下列主題：
- Exchange 2016：Exchange Server中的訊息大小限制
- Exchange Online：Exchange Online 的限制
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0，這表示如果偵測到任何大型專案，移轉要求將會失敗。 如果您確定留下幾個大型專案，您可以將此參數設定為合理的值 (建議使用 10 或更低的) 讓移轉要求可以繼續進行。
注意：此參數在雲端式服務中已遭取代。 如果您日後不使用此參數，將會改用「已略過的項目」核准語義。
| 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, Exchange Online |
-MoveOptions
MoveOptions 參數會指定為了偵錯而要略過的移轉階段。 除非有 Microsoft 客戶服務與技術支援人員或特定說明文件指示您這樣做，否則請勿使用此參數。
請勿將此參數與 SkipMoving 參數一起使用。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NotificationEmails
NotificationEmails 參數會指定要接收移轉狀態報告的一或多個電子郵件地址。
如果您未使用此參數，就不會傳送狀態報告。
若要輸入多個值並覆寫任何現有的專案，請使用下列語法： Value1,Value2,...ValueN 。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。
| Type: | MultiValuedProperty |
| 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, Exchange Online |
-Partition
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReportInterval
ReportInterval 參數會指定傳送電子郵件報告到 NotificationEmails 中所列電子郵件地址的頻率。
根據預設，批次每 24 小時會傳送電子郵件報告。 將此值設定為 0 表示絕對不應該為此批次傳送報表。
此參數只能在雲端式服務中使用。
| Type: | TimeSpan |
| 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, Exchange Online |
-SkipMerging
SkipMerging 參數會指定為了偵錯而要略過的移轉階段。 除非有 Microsoft 客戶服務與技術支援人員或特定說明文件指示您這樣做，否則請勿使用此參數。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipMoving
此參數已由 MoveOptions 參數取代。
SkipMoving 參數會指定為了偵錯而要略過的移轉階段。 除非有 Microsoft 客戶服務與技術支援人員或特定說明文件指示您這樣做，否則請勿使用此參數。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipReports
SkipReports 參數會指定您要略過移轉的自動報告作業。 您不需要使用此參數指定值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourcePublicFolderDatabase
此參數僅適用於內部部署 Exchange。
SourcePublicFolderDatabase 參數會指定公用資料夾移轉中使用的來源公用資料夾資料庫。 您可以使用唯一識別資料庫的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
| Type: | DatabaseIdParameter |
| 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 |
-StartAfter
StartAfter 參數會在開始批次內使用者的資料移轉之前指定延遲。 移轉將會準備就緒，但批次內使用者的實際資料移轉，要等到您使用此參數指定的日期/時間才會開始。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
在 Exchange Online PowerShell 中，如果您指定沒有時區的日期/時間值，該值會以國際標準時間 (UTC) 。 若要指定值，請使用下列其中一個選項：
- 以 UTC 指定日期/時間值：例如。
"7/30/2020 9:00PM Z" - 在您的當地時區中指定日期/時間值。 例如，
"7/30/2020 9:00PM -700"。 如果您不使用 TimeZone 參數，此值將會轉換成 UTC。
| Type: | DateTime |
| 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, Exchange Online |
-SyncNow
SyncNow 參數會針對已達到 [同步處理] 狀態的使用者啟動立即同步處理，但不會繼續任何失敗的使用者。 您不需要使用此參數指定值。
您可以使用此參數，在移動完成之前使用 參數來加速上線移動。 針對 IMAP 移轉，您可以在 MX 記錄切換之後使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Update
Update 參數會在移轉批次上設定 Update 旗標。 您不需要使用此參數指定值。
[更新] 旗標會觸發移轉服務，將所有設定從端點、批次和使用者重新套用至移轉程式。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Online |
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。