New-MigrationBatch

模組:

ExchangePowerShell

適用於:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

使用 New-MigrationBatch Cmdlet 可提交一批使用者的新移轉要求。

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

Syntax

New-MigrationBatch
   -Name <String>
   [-CSVData <Byte[]>]
   [-DisallowExistingUsers]
   [-WorkflowControlFlags <MigrationWorkflowControlFlags>]
   [-AdoptPreexisting]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ArchiveDomain <String>]
   [-ArchiveOnly]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-AvoidMergeOverlap]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExcludeDumpsters]
   [-ExcludeFolders <MultiValuedProperty>]
   [-ForwardingDisposition <GmailForwardingDisposition>]
   [-IncludeFolders <MultiValuedProperty>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-PrimaryOnly]
   [-RemoveOnCopy]
   [-RenamePrimaryCalendar]
   [-ReportInterval <Timespan>]
   [-Restore]
   [-SkipCalendar]
   [-SkipContacts]
   [-SkipMail]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports]
   [-SkipRules]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-SourceEndpoint <MigrationEndpointIdParameter>]
   [-SourcePFPrimaryMailboxGuid <Guid>]
   [-StartAfter <DateTime>]
   [-TargetArchiveDatabases <MultiValuedProperty>]
   [-TargetDatabases <MultiValuedProperty>]
   [-TargetDeliveryDomain <String>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   -Name <String>
   -CSVData <Byte[]>
   [-DisallowExistingUsers]
   [-AdoptPreexisting]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ArchiveDomain <String>]
   [-ArchiveOnly]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-PrimaryOnly]
   [-RemoveOnCopy]
   [-ReportInterval <Timespan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TargetArchiveDatabases <MultiValuedProperty>]
   [-TargetDatabases <MultiValuedProperty>]
   [-TargetDeliveryDomain <String>]
   [-TargetEndpoint <MigrationEndpointIdParameter>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   [-Local]
   -Name <String>
   -CSVData <Byte[]>
   [-DisallowExistingUsers]
   [-WorkloadType <RequestWorkloadType>]
   [-WorkflowControlFlags <MigrationWorkflowControlFlags>]
   [-AdoptPreexisting]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ArchiveOnly]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-PrimaryOnly]
   [-RemoveOnCopy]
   [-ReportInterval <Timespan>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TargetArchiveDatabases <MultiValuedProperty>]
   [-TargetDatabases <MultiValuedProperty>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   -Name <String>
   -CSVData <Byte[]>
   -SourcePublicFolderDatabase <DatabaseIdParameter>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   -Name <String>
   [-UserIds] <MultiValuedProperty>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DisableOnCopy]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   -Name <String>
   [-Users] <MultiValuedProperty>
   [-AllowIncrementalSyncs <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DisableOnCopy]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   -Name <String>
   -CSVData <Byte[]>
   [-PublicFolderToUnifiedGroup]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-SourceEndpoint <MigrationEndpointIdParameter>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

New-MigrationBatch
   -Name <String>
   [-WorkflowTemplate <String>]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

Description

使用 New-MigrationBatch 指令程式建立遷移批次，以於下列遷移情況中遷移信箱與信箱資料：

在內部部署 Exchange 組織中移動

• 本機移動：本機移動是您將信箱從一個信箱資料庫移至另一個信箱資料庫的位置。 本機移動發生在單一樹系中。 如需詳細資訊，請參閱「範例 1」。
• 跨樹系企業移動：在跨樹系企業移動中，信箱會移至不同的樹系。 跨樹系移動可從目標樹系 (您想要移動信箱的目的地樹系) 發起，或從來源樹系 (目前主控信箱的樹系) 發起。 如需詳細資訊，請參閱「範例 2」。

Exchange Online 中的 onboarding 和 offboarding

• 上線遠端移動移轉：在混合式部署中，您可以將信箱從內部部署 Exchange 組織移至Exchange Online。 這也稱為上線遠端移動移轉，因為您將信箱上線至Exchange Online。 如需詳細資訊，請參閱範例 3。

• 下架遠端移動遷移： 您也可以執行「下架」遠端移動遷移，也就是將 Exchange Online 信箱遷移至您的內部部署 Exchange 組織。 如需詳細資訊，請參閱範例 4。

  上架和下架遠端移動遷移都是從您的 Exchange Online 組織內啟動。

• 完全轉移 Exchange 移轉：這是另一種上線移轉類型，可用來將內部部署 Exchange 組織中的所有信箱移轉至Exchange Online。 您可以使用完全移轉來移轉最多 1，000 Exchange Server 2003、Exchange Server 2007 或 Exchange Server 2010 信箱。 當您執行完全轉換 Exchange 移轉時，信箱會自動布建在Exchange Online中。 如需詳細資訊，請參閱「範例 5」。

• 分段 Exchange 移轉：您也可以將信箱子集從內部部署 Exchange 組織移轉至 Exchange Online。 這是另一種類型的登入移轉。 不支援使用分段移轉從 Exchange 2010 或更新版本的 Exchange 移轉信箱。 在執行分段移轉之前，您必須使用目錄同步處理或其他方法，在您的Exchange Online組織中布建郵件使用者。 如需詳細資訊，請參閱範例 6。

• IMAP 移轉：此上線移轉類型會將信箱資料從 IMAP 伺服器移轉 (包括 Exchange) 至 Exchange Online。 若要進行 IMAP 移轉，您必須先在Exchange Online中布建信箱，才能移轉信箱資料。 如需詳細資訊，請參閱範例 7。

• Google Workspace (先前稱為 G Suite) 移轉：此上線移轉類型會將信箱資料從 Google Workspace 組織移轉至 Exchange Online。 若要進行 Google 工作區移轉，您必須先在Exchange Online中布建 (或信箱) 的郵件使用者，才能移轉信箱資料。 如需詳細資訊，請參閱範例 10。

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

範例

範例 1

New-MigrationBatch -Local -Name LocalMove1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\LocalMove1.csv")) -TargetDatabases MBXDB2

Start-MigrationBatch -Identity LocalMove1

本範例將為本機移動建立遷移批次，在指定 CSV 檔案中的信箱將移動至不同的信箱資料庫。 此 CSV 檔案包含將被移動的信箱電子郵件地址的單一欄。 此欄標題必須將命名為EmailAddress。 此範例中的移轉批次必須使用 Start-MigrationBatch Cmdlet 或 Exchange 系統管理中心手動啟動。 或者，可以使用 AutoStart 參數以自動開始遷移批次。

範例 2

$Credentials = Get-Credential

$MigrationEndpointSource = New-MigrationEndpoint -ExchangeRemoteMove -Name Forest1Endpoint -Autodiscover -EmailAddress administrator@forest1.contoso.com -Credentials $Credentials

$CrossForestBatch = New-MigrationBatch -Name CrossForestBatch1 -SourceEndpoint $MigrationEndpointSource.Identity -TargetDeliveryDomain forest2.contoso.com -TargetDatabases MBXDB1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\CrossForestBatch1.csv"))

Start-MigrationBatch -Identity $CrossForestBatch.Identity

本範例將為跨樹系企業移動建立遷移批次，在 CSV 檔案中指定的郵件使用者信箱將會移至不同的樹系。 已建立新的遷移端點，可識別信箱目前位址的網域。 端點用於建立遷移批次。 然後，遷移批次將以Start-MigrationBatch 指令程式啟動。 請注意，跨樹系移動將自目標樹系發起，此為您想要移動信箱前往的樹系。

範例 3

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv"))

Start-MigrationBatch -Identity $OnboardingBatch.Identity.Name

此範例會建立移轉批次，以便將從內部部署 Exchange 組織移轉至Exchange Online的上線遠端移轉。 語法與跨樹系移動的語法類似，但它是由Exchange Online組織起始。 已建立新的遷移端點，該端點指向內部部署組織作為將被遷移的信箱來源位置。 此端點用於建立遷移批次。 然後，遷移批次將以Start-MigrationBatch 指令程式啟動。

範例 4

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OffboardingBatch = New-MigrationBatch -Name RemoteOffBoarding1 -TargetEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain onprem.contoso.com -TargetDatabases @(MBXDB01,MBXDB02,MBXDB03) -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOffBoarding1.csv"))

Start-MigrationBatch -Identity $OffboardingBatch.Identity

此範例會建立移轉批次，以便將遠端移轉從Exchange Online移轉至內部部署 Exchange 組織。 就像上線遠端移動一樣，它是從Exchange Online組織起始。 首先會建立移轉端點，其包含有關如何連線到內部部署組織的資訊。 端點是作為建立移轉批次時的 TargetEndpoint，該批次之後將以Start-MigrationBatch 指令程式啟動。 TargetDatabases 參數能指定多個內部部署資料庫，供遷移服務選為移動信箱的目標資料庫。

範例 5

$credentials = Get-Credential

$SourceEndpoint = New-MigrationEndpoint -ExchangeOutlookAnywhere -Autodiscover -Name SourceEndpoint -EmailAddress administrator@contoso.com -Credentials $credentials

New-MigrationBatch -Name CutoverBatch -SourceEndpoint $SourceEndpoint.Identity -TimeZone "Pacific Standard Time" -AutoStart

此範例會為自動啟動的完全轉換 Exchange 移轉 CutoverBatch 建立移轉批次。 此範例會取得內部部署 Exchange Server 的連線設定，然後使用這些連線設定來建立移轉端點。 該端點之後將用於建立遷移批次。 此範例還包括選用的 TimeZone 參數。

範例 6

$Credentials = Get-Credential

$MigrationEndpoint = New-MigrationEndpoint -ExchangeOutlookAnywhere -Name ContosoEndpoint -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

$StagedBatch1 = New-MigrationBatch -Name StagedBatch1 -SourceEndpoint $MigrationEndpoint.Identity -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\StagedBatch1.csv"))

Start-MigrationBatch -Identity $StagedBatch1.Identity

此範例會建立並啟動分段 Exchange 移轉的移轉批次。 此範例會使用 New-MigrationEndpoint Cmdlet 來建立內部部署 Exchange 伺服器的移轉端點，然後使用該端點來建立移轉批次。 遷移批次將以Start-MigrationBatch 指令程式啟動。

範例 7

New-MigrationEndpoint -IMAP -Name IMAPEndpoint1 -RemoteServer imap.contoso.com -Port 993

New-MigrationBatch -Name IMAPbatch1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -SourceEndpoint IMAPEndpoint1 -ExcludeFolders "Deleted Items","Junk Email"

本範例為 IMAP 伺服器的連接設定建立遷移端點。 之後將建立使用 CSV 移轉檔案 IMAPmigration_1.csv 的 IMAP 移轉批次，並排除 [刪除的郵件] 以及 [垃圾郵件] 資料夾的內容。 這個移轉批次會擱置到使用 Start-MigrationBatch 指令程式啟動為止。

範例 8

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv")) -CompleteAfter "09/01/2018 7:00 PM"

Start-MigrationBatch -Identity $OnboardingBatch.Identity

此範例與範例 3 相同，但也會使用 CompleteAfter 參數。 批次的資料移轉將會開始，但要到 2018 年 9 月 1 日下午 7：00 (UTC) 才會完成。 如果您的時區是國際標準時間，這個方法可讓您開始移轉，然後讓它在上班時間後完成。

範例 9

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv")) -CompleteAfter "09/01/2018 7:00 PM" -TimeZone "Pacific Standard Time"

Start-MigrationBatch -Identity $OnboardingBatch.Identity

此範例與範例 8 相同，但也會使用 TimeZone 參數。 批次的資料移轉將會開始，但要等到 2018/09/01 下午 7：00 (PST) 才會完成。 如果您的時區是太平洋標準時間，這個方法可讓您開始移轉，然後讓它在上班時間後完成。

範例 10

$MigrationEndpointGmail = New-MigrationEndpoint -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\gmailonboarding.json")) -EmailAddress admin@contoso.com -Name GmailEndpoint

$OnboardingBatch = New-MigrationBatch -SourceEndpoint $MigrationEndpointGmail.Identity -Name GmailBatch1 -CSVData $([System.IO.File]::ReadAll
Bytes("C:\Users\Administrator\Desktop\gmail.csv")) -TargetDeliveryDomain "o365.contoso.com" -ContentFilter "Received -ge '2019/4/30'" -Inc
ludeFolders "Payment"

Start-MigrationBatch -Identity $OnboardingBatch.Identity

Google Workspace 移轉批次的建立方式是使用 CSV 移轉檔案gmail.csv，並包含付款標籤的內容，並且只會移轉在本機系統時間) '2019/4/30 00：00 (' 之後收到的郵件。 這個移轉批次會擱置到使用 Start-MigrationBatch 指令程式啟動為止。

參數

-AdoptPreexisting

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

{{ Fill AdoptPreexisting Description }}

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-AllowIncrementalSyncs

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

AllowIncrementalSyncs 參數可指定要啟用還是停用增量同步處理。 有效值為：

• $true：已啟用累加式同步處理。 傳送至來源信箱的任何新郵件，每隔 24 小時會複製一次至對應的目標信箱。 這是預設值。
• $false：已停用累加式同步處理。 初始同步處理完成之後，移轉批次會進入已停止狀態。 若要完成本機移動、跨樹系移動或遠端移動移轉的移轉批次，您需要使用 Set-MigrationBatch Cmdlet 來啟用增量同步處理。

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

-ArchiveDomain

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

{{ 填入 ArchiveDomain 描述 }}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ArchiveOnly

ArchiveOnly 參數指定只會為移轉批次中的使用者移轉封存信箱 (不移轉主要信箱)。 您不需要指定此參數的值。

您只能將此參數用於本機移動與遠端移動移轉。

您可以使用 TargetArchiveDatabases 參數會指定封存信箱的移轉目的資料庫。 您也可以在 CSV 檔案中指定目標封存資料庫。 如果不指定目標封存資料庫，指令程式會使用自動信箱發佈邏輯來選取資料庫。

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, Exchange Online

-AutoComplete

AutoComplete 參數會在個別信箱完成初始同步處理後，立刻強制該信箱完成。 您不需要指定此參數的值。

您只能將此參數用於本機移動與遠端移動移轉。

如果您不使用這個參數，則必須執行 Complete-MigrationBatch以完成移轉批次。

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, 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

-AutoStart

AutoStart 參數會立即開始新移轉批次的處理。 您不需要使用此參數指定值。

如果您不使用這個參數，則必須透過 Start-MigrationBatch Cmdlet 來手動啟動移轉批次。

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, Exchange Online

-AvoidMergeOverlap

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

{{ Fill AvoidMergeOverlap Description }}

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-BadItemLimit

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

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

注意：此參數在雲端式服務中已遭取代。 未來，如果未指定 BadItemLimit 或 LargeItemLimit 參數，移轉將會使用略過的專案核准語意，而不是 BadItemLimit 語意。

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

-ContentFilter

此參數僅適用于用於 IMAP 移轉和 Google Workspace 移轉的雲端式服務。

ContentFilter 參數會使用 OPATH 篩選語法，依接收時間篩選訊息。 只有符合 ContentFilter 參數的內容才會移至 Exchange Online。 例如：

• "Received -gt '8/23/2020'"
• "Received -le '2019/01/01'"
• "Received -gt '8/23/2015' -and Received -lt '8/23/2020'"

您可以使用 ContentFilterLanguage 參數來指定語言。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ContentFilterLanguage

此參數僅適用于用於 IMAP 移轉和 Google Workspace 移轉的雲端式服務。

ContentFilterLanguage 參數會指定 ContentFilter 參數中為進行參數搜尋所使用的語言。

此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化特性程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-CSVData

CSVData 參數會指定包含要移動或遷移之使用者信箱相關資訊的 CSV 檔案。 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:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DisableOnCopy

如果您要使用 UserIds 或 Users 參數，將使用者從現有的批次複製到新的批次，DisableOnCopy 參數會停用使用者的原始移轉作業專案。 您不需要使用此參數指定值。

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, Exchange Online

-DisallowExistingUsers

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

DisallowExistingUsers 參數可防止目前定義於不同移轉批次中的信箱進行移轉。 您不需要指定此參數的值。

在目標目的地中顯示驗證警告的任何已存在信箱。

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

-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

-ExcludeDumpsters

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

ExcludeDumpsters 參數會指定是否移轉公用資料夾信箱，而不包含 [可復原的專案] 資料夾的內容， (先前稱為傾印) 。 您不需要使用此參數指定值。

您只能在從 Exchange 2013 或更新版本移轉至 Exchange Online 的公用資料夾中使用此參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExcludeFolders

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

針對 IMAP 移轉或 Google 工作區移轉，ExcludeFolders 參數會指定您不想從來源電子郵件系統移轉至雲端式信箱的信箱資料夾。 以字串陣列的形式指定值，並以逗點分隔多個資料夾名稱。

針對 IMAP 移轉，請使用與來源郵件伺服器上的 IMAP 根目錄相對的資料夾名稱。 針對 Google 工作區移轉，請在來源郵件伺服器上使用標籤名稱。

如果 exADNoMk 同盟服務 (AD FS) 部署為允許單一登入外部信箱，且 AD FS 已設定為針對登入 Token 要求使用 ExchangeGUID 以外的屬性，則您必須設定 ImmutableId 參數。 exExchangeNoVersion 與 AD FS 都必須為同一位使用者要求同一個 Token，以確保跨單位 exExchangeNoVersion 部署案例的正常運作。

<FolderName>/*：使用此語法表示 SourceRootFolder 參數中所指定資料夾下的個人資料夾，例如 或 MyProjectsMyProjects/FY2010 。

#<FolderName>#/*：使用此語法表示已知的資料夾，而不論資料夾的名稱是其他語言。 例如，#Inbox# 代表 [收件匣] 資料夾，即使收件匣是以土耳其文當地語系化，也就是 Gelen Kutusu。 已知的資料夾包含下列類型：

• 根
• 收件匣
• SentItems
• 寄件匣
• DeletedItems
• 行事曆
• 聯絡人
• 草稿
• 日誌
• 工作
• 附註
• AllItems
• 垃圾郵件
• 封存

如果使用者建立的個人資料夾名稱與已知資料夾 # 及其周圍的符號相同，您可以使用反斜線 () \ 作為逸出字元來指定該資料夾。 例如，如果使用者建立名為 的檔 #Notes# 夾，而您想要指定該資料夾，而不是已知的 Notes 資料夾，請使用下列語法： \#Notes\# 。

如果使用者建立的個人資料夾與已知資料夾的名稱相同，並以 # 符號環繞，您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。例如，若使用者建立了名稱為 #Notes# 的資料夾，而您要指定該資料夾，但不是已知的 Notes 資料夾，請使用下列語法：\#Notes\#.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ForwardingDisposition

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

{{ Fill ForwardingDisposition Description }}

Type:	GmailForwardingDisposition
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IncludeFolders

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

針對 IMAP 移轉或 Google 工作區移轉，IncludeFolders 參數會指定您想要從內部部署電子郵件系統移轉至雲端式信箱的信箱資料夾。 以字串陣列的形式指定值，並以逗點分隔多個資料夾名稱。

針對 IMAP 移轉，請使用與來源郵件伺服器上的 IMAP 根目錄相對的資料夾名稱。 針對 Google 工作區移轉，請在來源郵件伺服器上使用標籤名稱。

如果 exADNoMk 同盟服務 (AD FS) 部署為允許單一登入外部信箱，且 AD FS 已設定為針對登入 Token 要求使用 ExchangeGUID 以外的屬性，則您必須設定 ImmutableId 參數。 exExchangeNoVersion 與 AD FS 都必須為同一位使用者要求同一個 Token，以確保跨單位 exExchangeNoVersion 部署案例的正常運作。

<FolderName>/*：使用此語法表示 SourceRootFolder 參數中所指定資料夾下的個人資料夾，例如 或 MyProjectsMyProjects/FY2010 。

#<FolderName>#/*：使用此語法表示已知的資料夾，而不論資料夾的名稱是其他語言。 例如，#Inbox# 代表 [收件匣] 資料夾，即使收件匣是以土耳其文當地語系化，也就是 Gelen Kutusu。 已知的資料夾包含下列類型：

• 根
• 收件匣
• SentItems
• 寄件匣
• DeletedItems
• 行事曆
• 聯絡人
• 草稿
• 日誌
• 工作
• 附註
• AllItems
• 垃圾郵件
• 封存

如果使用者建立的個人資料夾名稱與已知資料夾 # 及其周圍的符號相同，您可以使用反斜線 () \ 作為逸出字元來指定該資料夾。 例如，如果使用者建立名為 的檔 #Notes# 夾，而您想要指定該資料夾，而不是已知的 Notes 資料夾，請使用下列語法： \#Notes\# 。

如果使用者建立的個人資料夾與已知資料夾的名稱相同，並以 # 符號環繞，您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。例如，若使用者建立了名稱為 #Notes# 的資料夾，而您要指定該資料夾，但不是已知的 Notes 資料夾，請使用下列語法：\#Notes\#.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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

-Local

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

Local 參數會指定將信箱移至相同 Active Directory 樹系) 中不同信箱資料庫 (本機移動。 您不需要使用此參數指定值。

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

-Locale

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

Locale 參數會指定移轉批次的語言。

此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化特性程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。

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

-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

-Name

Name 參數會指定 Exchange 內部部署或Exchange Online) (每個系統上移轉批次的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號括住值。

Type:	String
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, Exchange Online

-NotificationEmails

NotificationEmails 參數會指定要接收移轉狀態報告的一或多個電子郵件地址。 指定字串陣列的值，然後以逗點分隔多個電子郵件地址。

如果您未使用此參數，就不會傳送狀態報告。

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

-PrimaryOnly

PrimaryOnly 參數指定只會為移轉批次中同時擁有封存信箱的使用者移轉主要信箱 (不會移轉封存信箱)。 您不需要指定此參數的值。

您只能將此參數用於本機移動與遠端移動移轉。

注意：如果使用者沒有封存信箱，請不要使用此參數。

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, Exchange Online

-PublicFolderToUnifiedGroup

此參數只能在雲端式服務中運作。

PublicFolderToUnifiedGroup 參數會指定從公用資料夾移轉至 Microsoft 365 群組。 您不需要使用此參數指定值。

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

-RemoveOnCopy

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

{{ Fill RemoveOnCopy Description }}

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RenamePrimaryCalendar

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

{{ Fill RenamePrimaryCalendar Description }}

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

-Restore

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

{{ 填滿還原描述 }}

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SkipCalendar

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

SkipCalendar 參數會指定您想要在 Google Workspace 上線期間略過行事曆移轉。 您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SkipContacts

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

SkipContacts 參數會指定您想要在 Google 工作區上線期間略過連絡移轉。 您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SkipMail

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

SkipMail 參數會指定您想要在 Google Workspace 上線期間略過郵件移轉。 您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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:	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

-SkipRules

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

SkipRules 參數會指定您想要在 Google Workspace 上線期間略過規則移轉。 您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SkipSteps

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

SkipSteps 參數會指定您想要略過的暫存 Exchange 移轉步驟。 有效值為：

• 無 (這是預設值)
• SettingTargetAddress：不要在來源信箱上設定目標電子郵件地址。 此設定可防止將郵件從原始信箱轉送到新移轉的信箱。

此參數只會針對分段 Exchange 移轉強制執行。

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

-SourceEndpoint

SourceEndpoint 參數會指定要用於移轉批次來源的移轉端點。 您可以使用 New-MigrationEndpoint Cmdlet 來建立移轉端點。 您可以使用可唯一識別移轉端點的任何值。 例如：

• 名稱 (Identity 屬性值)
• GUID

這個參數會定義用來連線到來源信箱所在伺服器的設定。

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

-SourcePFPrimaryMailboxGuid

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

{{ 填入 SourcePFPrimaryMailboxGuid 描述 }}

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourcePublicFolderDatabase

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

SourcePublicFolderDatabase 參數會指定公用資料夾移轉中使用的來源公用資料夾資料庫。 您可以使用唯一識別資料庫的任何值。 例如：

• 名稱
• 辨別名稱 (DN)
• GUID

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

-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

-TargetArchiveDatabases

TargetArchiveDatabases 參數將指定遷移批次中指定的封存信箱將前往的遷移資料夾。 您可以使用唯一識別資料庫的任何值。 例如：

• 名稱
• 辨別名稱 (DN)
• GUID

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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

-TargetDatabases

TargetDatabases 參數會指定信箱移動目的地的資料庫識別碼。 您可以使用唯一識別資料庫的任何值。 例如：

• 名稱
• 辨別名稱 (DN)
• GUID

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

當您輸入多個值時，移轉服務會選取一個資料庫作為要將信箱移至的目標資料庫。

您只能將此參數用於本機移動與遠端移動移轉。

如果您未使用此參數進行本機移動，Cmdlet 會使用自動信箱散發邏輯來選取資料庫。

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

-TargetDeliveryDomain

TargetDeliveryDomain 參數會指定在完成移轉批次時，在來源樹系中為啟用郵件功能的使用者所建立的外部電子郵件地址 FQDN。

遠端移動 onboarding 與遠端 offboarding 移轉批次必須使用此參數。

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, Exchange Online

-TargetEndpoint

TargetEndpoint 參數會指定要用於移轉批次目的地的移轉端點。 您可以使用 New-MigrationEndpoint Cmdlet 來建立移轉端點。 您可以使用可唯一識別移轉端點的任何值。 例如：

• 名稱 (Identity 屬性值)
• GUID

這個參數會定義用來連線到信箱要移動到之目的地伺服器的設定。

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

-TimeZone

TimeZone 參數會指定提交移轉批次之系統管理員的時區。

此參數的有效值是支援的時區索引鍵名稱 (例如， "Pacific Standard Time") 。

若要查看可用的值，請執行下列命令： $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display 。

如果值包含空格，請使用引號 (") 括住值。

在內部部署 Exchange 中，預設值是 Exchange Server 的時區設定。

在Exchange Online中，預設值為 UTC 。

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

-UserIds

UserIds 參數會指定您想要從現有移轉批次複製的使用者 (例如，如果先前的移轉只成功了一部分)。 您可以透過電子郵件地址或其 Guid 屬性值，從 Get-MigrationUser Cmdlet 識別使用者。 您可以指定多個以逗號分隔的使用者。

您指定給這個參數的使用者必須已在現有移轉批次中定義。

若要停用屬於原始移轉批次之使用者的移轉作業，請使用這個參數 (parameter) 與 DisableOnCopy 參數 (switch)。

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

-Users

Users 參數會指定您想要從現有移轉批次複製的使用者 (例如，如果先前的移轉已部分成功) 。 您可以藉由使用 Get-MigrationUser Cmdlet 來識別使用者。 例如：

$Failed = Get-MigrationUser -Status Failed

New-MigrationBatch -Name 「Retry Failed Users」 -Users $Failed

您指定給這個參數的使用者必須已在現有移轉批次中定義。

若要停用屬於原始移轉批次之使用者的移轉作業，請使用這個參數 (parameter) 與 DisableOnCopy 參數 (switch)。

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

-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

-WorkflowControlFlags

WorkflowControlFlags 參數會指定移轉中所執行步驟的進階控制項。 有效值為：

• 無 (這是預設值)
• InjectAndForget
• SkipSwitchover

除非有 Microsoft 客戶服務與技術支援人員或特定說明文件指示您這樣做，否則請勿使用此參數。

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

-WorkflowTemplate

WorkflowTemplate 參數會指定移轉中所執行步驟的進階控制項。 除非有 Microsoft 客戶服務與技術支援人員或特定說明文件指示您這樣做，否則請勿使用此參數。

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

-WorkloadType

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

將保留此參數供 Microsoft 內部使用。

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

輸入

Input types

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

輸出

Output types

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