New-MigrationBatch
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 New-MigrationBatch cmdlet 可为一批用户提交新的迁移请求。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-AllowIncrementalSyncs <System.Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-AutoComplete]
[-AutoRetryCount <System.Int32>]
[-AutoStart]
[-CompleteAfter <System.DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-Locale <CultureInfo>]
[-NotificationEmails <MultiValuedProperty>]
[-ReportInterval <System.TimeSpan>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <System.DateTime>]
[-TargetDatabases <MultiValuedProperty>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>] New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-Analyze]
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-CompleteAfter <System.DateTime>]
[-Confirm]
[-ExcludeFolders <MultiValuedProperty>]
[-IncludeFolders <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <System.TimeSpan>]
[-SkipReports]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-StartAfter <System.DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>] New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <System.DateTime>]
[-Confirm]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <System.TimeSpan>]
[-SkipReports]
[-StartAfter <System.DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>] New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-AdoptPreexisting]
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-CompleteAfter <DateTim>]
[-Confirm]
[-GoogleResource]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-RemoveOnCopy]
[-ReportInterval <Timespan>]
[-SkipDelegates]
[-SkipMerging <MultiValuedProperty>]
[-SkipProvisioning]
[-SkipReports]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-StartAfter <DateTime>]
[-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>
-CSVData <Byte[]>
[-ManagedGmailTeams]
[-AdoptPreexisting]
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-RemoveOnCopy]
[-ReportInterval <Timespan>]
[-SkipCalendar]
[-SkipContacts]
[-SkipReports]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-StartAfter <DateTime>]
[-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
-Name <String>
[-CSVData <Byte[]>]
[-DisallowExistingUsers]
[-WorkflowControlFlags <MigrationWorkflowControlFlags>]
[-AdoptPreexisting]
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ArchiveDomain <String>]
[-ArchiveOnly]
[-AutoComplete]
[-AutoProvisioning]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-AvoidMergeOverlap]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpsters]
[-ExcludeFolders <MultiValuedProperty>]
[-ForwardingDisposition <GmailForwardingDisposition>]
[-IncludeFolders <MultiValuedProperty>]
[-IncludeOtherContacts]
[-LargeItemLimit <Unlimited>]
[-Locale <CultureInfo>]
[-MigrateTasks]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-PrimaryOnly]
[-RemoveOnCopy]
[-RenamePrimaryCalendar]
[-ReportInterval <Timespan>]
[-Restore]
[-SimplifiedSwitchOver]
[-SkipCalendar]
[-SkipContacts]
[-SkipDelegates]
[-SkipMail]
[-SkipMerging <MultiValuedProperty>]
[-SkipMoving <MultiValuedProperty>]
[-SkipProvisioning]
[-SkipReports]
[-SkipRules]
[-SkipSteps <SkippableMigrationSteps[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-SourcePFPrimaryMailboxGuid <Guid>]
[-StartAfter <DateTime>]
[-TargetArchiveDatabases <MultiValuedProperty>]
[-TargetDatabases <MultiValuedProperty>]
[-TargetDeliveryDomain <String>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[-XMLData <Byte[]>]
[<CommonParameters>] New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-StartAfter <DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>] New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-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>
[-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
[-Users] MultiValuedProperty>
-Name <String>
[-AllowUnknownColumnsInCSV <Boolean>]
[-AutoComplete]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DisableOnCopy]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-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>] 说明
使用 New-MigrationBatch cmdlet 创建一个迁移批处理，以便在以下迁移方案之一中迁移邮箱和邮箱数据。
内部部署 Exchange 组织中的移动
- 本地移动： 本地移动是指将邮箱从一个邮箱数据库移动到另一个邮箱数据库的情况。 本地移动发生在单个林内部。 有关详细信息，请参阅示例 1。
- 跨林企业移动： 在跨林企业移动中，将邮箱移到一个不同的林。 跨林移动可从目标林（邮箱移动的目标林）启动，也可从源林（当前托管邮箱的林）启动。 有关详细信息，请参阅“示例 2”。
Exchange Online 中的加入和分离
载入远程移动迁移：在混合部署中，可以将邮箱从本地 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。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 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 cmdlet 启动迁移批次。 请注意，跨林移动是从目标林（即要将邮箱移动到的林）启动的。
示例 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 cmdlet 启动迁移批次。
示例 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 cmdlet 启动。 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 迁移直接转换Batch 创建迁移批处理。 该示例获取到本地 Exchange 服务器的连接设置，然后使用这些连接设置创建迁移终结点。 然后使用该终结点创建迁移批次。 本示例还包括可选的 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 cmdlet 启动迁移批次。
示例 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 cmdlet 启动该迁移批处理之前，它将一直处于挂起状态。
示例 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 参数。 批处理的数据迁移将开始，但直到 09/01/2018 7：00 PM (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 参数。 批处理的数据迁移将开始，但直到 09/01/2018 7：00 PM (PST) 才会完成。 此方法允许启动迁移，如果时区是太平洋Standard时间，则让迁移在营业时间后完成。
示例 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 工作区迁移批处理使用 CSV 迁移文件 gmail.csv 并包含付款标签的内容，并且仅迁移在“2019/4/30 00：00” (本地系统时间) 之后收到的邮件。 在使用 Start-MigrationBatch cmdlet 启动该迁移批处理之前，它将一直处于挂起状态。
参数
-AdoptPreexisting
此参数仅在基于云的服务中可用。
{{ Fill AdoptPreexisting Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-AllowIncrementalSyncs
此参数只在本地 Exchange 中可用。
AllowIncrementalSyncs 参数指定是启用还是禁用增量同步。 有效值包含:
- $true：已启用增量同步。 发送到源邮箱的任何新邮件每 24 小时一次复制到相应的目标邮箱。 此值为默认值。
- $false：增量同步已禁用。 初始同步完成后，迁移批处理将进入“已停止”状态。 若要完成本地移动、跨林移动或远程移动迁移的迁移批处理，需要使用 Set-MigrationBatch cmdlet 启用增量同步。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AllowUnknownColumnsInCsv
AllowUnknownColumnsInCsv 参数指定是否允许 CSV 文件中存在不用于迁移的额外列。 有效值包含:
- $true：迁移忽略 (无提示地跳过 CSV 文件中) 未知列 (包括) 列标题拼写错误的可选列。 所有未知列都被视为迁移不使用的额外列。
- $false：如果 CSV 文件中有任何未知列，则迁移失败。此设置可防止列标题中的拼写错误。 此值为默认值。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Analyze
此参数仅在基于云的服务中可用。
{{ Fill Analyze Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-ArchiveDomain
此参数仅在基于云的服务中可用。
{{ Fill ArchiveDomain Description }}
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-ArchiveOnly
ArchiveOnly 开关指定仅为迁移批处理中的用户迁移存档邮箱（不迁移主邮箱）。 不必为此开关指定值。
此开关仅可用于本地移动和远程移动迁移。
可以使用 TargetArchiveDatabases 参数指定存档邮箱的迁移目标数据库。 您也可以在 CSV 文件中指定目标存档数据库。 如果不指定目标存档数据库，该 cmdlet 将使用自动邮箱分布逻辑选择数据库。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AutoComplete
只要邮箱完成了初始同步，AutoComplete 开关将强制最终完成单个邮箱迁移。 不必为此开关指定值。
此开关仅可用于本地移动和远程移动迁移。
如果不使用此开关，将需要运行 Complete-MigrationBatch cmdlet 以完成迁移批处理。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AutoProvisioning
此参数仅在基于云的服务中可用。
{{ 填充自动预配说明 }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-AutoRetryCount
此参数只在本地 Exchange 中可用。
AutoRetryCount 参数指定尝试重新启动迁移批次以迁移遇到错误的邮箱的次数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AutoStart
AutoStart 开关会立即开始处理新的迁移批处理。 不必为此开关指定值。
如果不使用此开关，则需要使用 Start-MigrationBatch cmdlet 手动启动迁移批处理。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AvoidMergeOverlap
此参数仅在基于云的服务中可用。
{{ Fill AvoidMergeOverlap Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-BadItemLimit
BadItemLimit 参数指定迁移请求失败之前允许的最大错误项数。 无效项目是源邮箱中无法复制到目标邮箱的损坏项目。 无效项目限制还包括缺少的项目。 缺少的项目是源邮箱中在迁移请求准备好完成时无法在目标邮箱中找到的项目。
此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何错误项，迁移请求将失败。 如果可以保留一些错误项，则可以将此参数设置为合理的值， (我们建议使用 10 个或更低的) 以便迁移请求可以继续。 如果检测到太多错误项目，请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中损坏的项目，然后再次尝试迁移请求。
注意：在基于云的服务中不建议使用此参数。 将来，如果未指定 BadItemLimit 或 LargeItemLimit 参数，则迁移将使用跳过的项目审批语义而不是 BadItemLimit 语义。
| 类型: | Unlimited |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | 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。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ContentFilter
此参数仅在基于云的服务中可用，用于 IMAP 迁移和 Google 工作区迁移。
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 参数指定语言。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-ContentFilterLanguage
此参数仅在基于云的服务中可用，用于 IMAP 迁移和 Google 工作区迁移。
ContentFilterLanguage 参数指定在 ContentFilter 参数中用于进行字符串搜索的语言。
此参数的有效输入是 Microsoft .NET Framework CultureInfo 类支持的区域性代码值。 例如，da-DK 表示丹麦语，ja-JP 表示日语。 有关详细信息，请参阅 CultureInfo 类。
| 类型: | CultureInfo |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | 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) 。
| 类型: | Byte[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisableOnCopy
如果要使用 UserIds 或 Users 参数将用户从现有批处理复制到新批，DisableOnCopy 开关将禁用用户的原始迁移作业项。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisallowExistingUsers
此参数只在本地 Exchange 中可用。
DisallowExistingUsers 参数可防止迁移当前在其他迁移批处理中定义的邮箱。 不必为此开关指定值。
对于目标中先前存在的任何邮箱，都会显示验证警告。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| 类型: | Fqdn |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExcludeDumpsters
此参数仅在基于云的服务中可用。
ExcludeDumpsters 开关指定是否迁移公用文件夹邮箱，而不包括“可恢复的项目”文件夹的内容 (以前称为转储程序) 。 不必为此开关指定值。
仅在从 Exchange 2013 或更高版本到Exchange Online的公用文件夹迁移中使用此开关。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-ExcludeFolders
此参数仅在基于云的服务中可用。
对于 IMAP 迁移或 Google 工作区迁移，ExcludeFolders 参数指定不希望从源电子邮件系统迁移到基于云的邮箱的邮箱文件夹。 以字符串数组形式指定该值，并用逗号分隔多个文件夹名称。
对于 IMAP 迁移，请使用相对于源邮件服务器上的 IMAP 根目录的文件夹名称。 对于 Google 工作区迁移，请在源邮件服务器上使用标签名称。
如果 exADNoMk 联合身份验证服务 (AD FS) 已部署，允许单一登录外部部署邮箱，且 AD FS 配置为对登录令牌请求使用除 ExchangeGUID 之外的其他属性，则您必须设置 ImmutableId 参数。 exExchangeNoVersion 和 AD FS 两者必须为同一用户请求相同的令牌，才能确保跨界 exExchangeNoVersion 部署应用场景的正常运行。
<FolderName>/*：使用此语法表示 SourceRootFolder 参数中指定的文件夹下的个人文件夹，例如 或 MyProjectsMyProjects/FY2010。
#<FolderName>#/*：使用此语法表示已知文件夹，而不考虑该文件夹在其他语言中的名称。 例如，#Inbox# 表示收件箱文件夹，即使收件箱本地化为土耳其语（即 Gelen Kutusu）。 已知文件夹包括以下类型：
- 根
- Inbox
- SentItems
- 发件箱
- DeletedItems
- 日历
- 联系人
- 草稿
- 日志
- 任务
- 注意
- AllItems
- JunkEmail
- 存档
如果用户创建的个人文件夹的名称与已知文件夹及其 # 周围的符号相同，则可以使用反斜杠 () \ 作为转义字符来指定该文件夹。 例如，如果用户创建名为 #Notes# 的文件夹，并且你想要指定该文件夹而不是已知的 Notes 文件夹，请使用以下语法： \#Notes\#。
如果用户创建的个人文件夹的名称与已知文件夹的名称相同且周围有 # 符号，则可以将反斜杠 (\) 用作转义字符以指定该文件夹。例如，如果用户创建了一个名为 #Notes# 的文件夹且您想指定该文件夹，但不是已知的“Notes”文件夹，请使用以下语法：\#Notes\#.
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-ForwardingDisposition
此参数仅在基于云的服务中可用。
{{ Fill ForwardingDisposition Description }}
| 类型: | GmailForwardingDisposition |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-GoogleResource
{{ Fill GoogleResource Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-IncludeFolders
此参数仅在基于云的服务中可用。
对于 IMAP 迁移或 Google 工作区迁移，IncludeFolders 参数指定要从本地电子邮件系统迁移到基于云的邮箱的邮箱文件夹。 以字符串数组形式指定该值，并用逗号分隔多个文件夹名称。
对于 IMAP 迁移，请使用相对于源邮件服务器上的 IMAP 根目录的文件夹名称。 对于 Google 工作区迁移，请在源邮件服务器上使用标签名称。
如果 exADNoMk 联合身份验证服务 (AD FS) 已部署，允许单一登录外部部署邮箱，且 AD FS 配置为对登录令牌请求使用除 ExchangeGUID 之外的其他属性，则您必须设置 ImmutableId 参数。 exExchangeNoVersion 和 AD FS 两者必须为同一用户请求相同的令牌，才能确保跨界 exExchangeNoVersion 部署应用场景的正常运行。
<FolderName>/*：使用此语法表示 SourceRootFolder 参数中指定的文件夹下的个人文件夹，例如 或 MyProjectsMyProjects/FY2010。
#<FolderName>#/*：使用此语法表示已知文件夹，而不考虑该文件夹在其他语言中的名称。 例如，#Inbox# 表示收件箱文件夹，即使收件箱本地化为土耳其语（即 Gelen Kutusu）。 已知文件夹包括以下类型：
- 根
- Inbox
- SentItems
- 发件箱
- DeletedItems
- 日历
- 联系人
- 草稿
- 日志
- 任务
- 注意
- AllItems
- JunkEmail
- 存档
如果用户创建的个人文件夹的名称与已知文件夹及其 # 周围的符号相同，则可以使用反斜杠 () \ 作为转义字符来指定该文件夹。 例如，如果用户创建名为 #Notes# 的文件夹，并且你想要指定该文件夹而不是已知的 Notes 文件夹，请使用以下语法： \#Notes\#。
如果用户创建的个人文件夹的名称与已知文件夹的名称相同且周围有 # 符号，则可以将反斜杠 (\) 用作转义字符以指定该文件夹。例如，如果用户创建了一个名为 #Notes# 的文件夹且您想指定该文件夹，但不是已知的“Notes”文件夹，请使用以下语法：\#Notes\#.
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-IncludeOtherContacts
此参数仅在基于云的服务中可用。
{{ Fill IncludeOtherContacts Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-LargeItemLimit
LargeItemLimit 参数指定迁移请求失败之前允许的最大大型项数。 大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。 如果目标邮箱没有专门配置最大邮件大小值，则使用组织范围的值。
有关最大邮件大小值的详细信息，请参阅下列主题：
- Exchange 2016：Exchange Server中的邮件大小限制
- Exchange Online：Exchange Online 限制
此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何大型项，迁移请求将失败。 如果可以保留几个大型项，则可以将此参数设置为合理的值， (我们建议使用 10 个或更低的) 以便迁移请求继续。
注意：在基于云的服务中不建议使用此参数。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。
| 类型: | Unlimited |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Local
此参数只在本地 Exchange 中可用。
本地开关指定本地移动 (邮箱移动到同一 Active Directory 林中的不同邮箱数据库) 。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Locale
此参数只在本地 Exchange 中可用。
Locale 参数指定迁移批处理的语言。
此参数的有效输入是 Microsoft .NET Framework CultureInfo 类支持的区域性代码值。 例如，da-DK 表示丹麦语，ja-JP 表示日语。 有关详细信息，请参阅 CultureInfo 类。
| 类型: | CultureInfo |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ManagedGmailTeams
此参数仅在基于云的服务中可用。
{{ Fill ManagedGmailTeams Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-MigrateTasks
此参数仅在基于云的服务中可用。
{{ Fill MigrateTasks Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-MoveOptions
MoveOptions 参数指定为进行调试而要跳过的迁移阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
此参数不能与 SkipMoving 参数一起使用。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Name 参数指定每个系统上迁移批处理的唯一名称， (Exchange 本地或Exchange Online) 。 最大长度为 64 个字符。 如果值包含空格，则使用引号括住该值。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NotificationEmails
NotificationEmails 参数指定迁移状态报告要发送到的一个或多个电子邮件地址。 将该值指定为字符串数组，并用逗号分隔多个电子邮件地址。
如果不使用此参数，将不发送状态报告。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Partition
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| 类型: | MailboxIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-PrimaryOnly
PrimaryOnly 开关指定仅为迁移批处理中同样包含存档邮箱的用户迁移主邮箱（不迁移存档邮箱）。 不必为此开关指定值。
此开关仅可用于本地移动和远程移动迁移。
注意：如果用户没有存档邮箱，则不使用此开关。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PublicFolderToUnifiedGroup
此参数仅在基于云的服务中有效。
PublicFolderToUnifiedGroup 开关指定从公用文件夹迁移到Microsoft 365 组。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoveOnCopy
此参数仅在基于云的服务中可用。
{{ Fill RemoveOnCopy Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-RenamePrimaryCalendar
此参数仅在基于云的服务中可用。
{{ Fill RenamePrimaryCalendar Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-ReportInterval
ReportInterval 参数指定电子邮件报表发送到 NotificationEmails 中列出的电子邮件地址的频率。
默认情况下，每 24 小时发送一次批的电子邮件报告。 将此值设置为 0 表示永远不应为此批发送报表。
此参数只应在基于云的服务中使用。
| 类型: | TimeSpan |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Restore
此参数仅在基于云的服务中可用。
{{ 填充还原说明 }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SimplifiedSwitchOver
此参数仅在基于云的服务中可用。
{{ Fill SimplifiedSwitchOver Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipCalendar
此参数仅在基于云的服务中可用。
SkipCalendar 开关指定要在 Google 工作区载入期间跳过日历迁移。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipContacts
此参数仅在基于云的服务中可用。
SkipContacts 开关指定要在 Google 工作区载入期间跳过联系人迁移。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipDelegates
此参数仅在基于云的服务中可用。
{{ Fill SkipDelegates Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipMail
此参数仅在基于云的服务中可用。
SkipMail 开关指定要在 Google 工作区载入期间跳过邮件迁移。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipMerging
SkipMerging 参数指定为进行调试而要跳过的迁移阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipMoving
此参数已被 MoveOptions 参数替换。
SkipMoving 参数指定为进行调试而要跳过的迁移阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipProvisioning
此参数仅在基于云的服务中可用。
{{ Fill SkipProvisioning Description }}
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipReports
SkipReports 开关指定要针对迁移跳过自动报告。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipRules
此参数仅在基于云的服务中可用。
SkipRules 开关指定要在 Google 工作区载入期间跳过规则迁移。 不必为此开关指定值。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SkipSteps
此参数只在本地 Exchange 中可用。
SkipSteps 参数指定要跳过的暂存 Exchange 迁移中的步骤。 有效值包含:
- 无 (这是默认值)
- SettingTargetAddress：不要在源邮箱上设置目标电子邮件地址。 此设置可防止邮件从原始邮箱转发到新的迁移邮箱。
仅对分阶段 Exchange 迁移强制使用此参数。
| 类型: | SkippableMigrationSteps[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceEndpoint
SourceEndpoint 参数指定用于迁移批处理的源的迁移终结点。 使用 New-MigrationEndpoint cmdlet 创建迁移终结点。 可以使用能够唯一标识迁移终结点的任意值。 例如：
- 名称（Identity 属性值）
- GUID
此参数定义用来连接到源邮箱所在服务器的设置。
| 类型: | MigrationEndpointIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourcePFPrimaryMailboxGuid
此参数仅在基于云的服务中可用。
{{ Fill SourcePFPrimaryMailboxGuid Description }}
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
-SourcePublicFolderDatabase
此参数只在本地 Exchange 中可用。
SourcePublicFolderDatabase 参数指定在公用文件夹迁移中使用的源公用文件夹数据库。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
| 类型: | DatabaseIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | 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。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetArchiveDatabases
TargetArchiveDatabases 参数指定迁移批次中指定的存档邮箱将迁移到的数据库。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
输入多个值时，迁移服务会选择一个数据库作为将存档邮箱移动到的目标数据库。
此参数仅可用于本地移动和远程移动迁移。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetDatabases
TargetDatabases 参数指定要将邮箱移动到的数据库的标识。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
输入多个值时，迁移服务会选择一个数据库作为将邮箱移动到的目标数据库。
此参数仅可用于本地移动和远程移动迁移。
如果不使用此参数进行本地移动，则 cmdlet 将使用自动邮箱分发逻辑来选择数据库。
| 类型: | MultiValuedProperty |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetDeliveryDomain
TargetDeliveryDomain 参数指定迁移批处理完成时在源林中为已启用邮件的用户创建的外部电子邮件地址的 FQDN。
在远程移动载入和远程脱离迁移批次时需要使用此参数。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetEndpoint
TargetEndpoint 参数指定用于迁移批处理的目标的迁移终结点。 使用 New-MigrationEndpoint cmdlet 创建迁移终结点。 可以使用能够唯一标识迁移终结点的任意值。 例如：
- 名称（Identity 属性值）
- GUID
此参数定义用于连接到将邮箱移动到的目标服务器的设置。
| 类型: | MigrationEndpointIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | 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 服务器的时区设置。
在 Exchange Online 中，默认值为 UTC。
| 类型: | ExTimeZoneValue |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UserIds
UserIds 参数指定要从现有迁移批处理中复制的用户（例如，在以前的迁移部分成功的情况下）。 可以通过电子邮件地址或用户 Guid 属性值从 Get-MigrationUser cmdlet 中标识用户。 可以指定用逗号分隔的多个用户。
为此参数指定的用户必须在现有迁移批处理中定义。
若要禁用原始迁移批处理中的用户迁移，请将 DisableOnCopy 开关和此参数一起使用。
| 类型: | MultiValuedProperty |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Users
Users 参数指定要从现有迁移批处理复制的用户 (例如，如果以前的迁移部分成功) 。 通过使用 Get-MigrationUser cmdlet 标识用户。 例如：
$Failed = Get-MigrationUser -Status Failed
New-MigrationBatch -名称“重试失败的用户”-用户$Failed
为此参数指定的用户必须在现有迁移批处理中定义。
若要禁用原始迁移批处理中的用户迁移，请将 DisableOnCopy 开关和此参数一起使用。
| 类型: | MultiValuedProperty |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkflowControlFlags
WorkflowControlFlags 参数指定迁移中执行的步骤的高级控件。 有效值包含:
- 无 (这是默认值)
- InjectAndForget
- SkipSwitchover
除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
| 类型: | MigrationWorkflowControlFlags |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkflowTemplate
WorkflowTemplate 参数为迁移中执行的步骤指定高级控件。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数，否则请不要这么做。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkloadType
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
| 类型: | RequestWorkloadType |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Server 2016, Exchange Server 2019 |
-XMLData
此参数仅在基于云的服务中可用。
{{ Fill XMLData Description }}
| 类型: | Byte[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。