CmdID / PowerShell / Cmdlets / New
New-MigrationBatch
Use the New-MigrationBatch cmdlet to submit a new migration request for a batch of users. Exchange PowerShell reference
From the Exchange PowerShell reference 75 parameters Its page in the reference
Parameters
Show its 75 parameters
-UserIdsThe UserIds parameter specifies the users that you want to copy from an existing migration batch (for example, if a previous migration was partially successful).-UsersThe Users parameter specifies the users that you want to copy from an existing migration batch (for example, if a previous migration was partially successful).-AnalyzeThe Analyze switch specifies whether to create a mailbox analysis batch.-ConnectionLogicalIdThe ConnectionLogicalId parameter specifies the connection logical ID for the Slack connector migration batch.-CSVDataThe CSVData parameter specifies the CSV file that contains information about the user mailboxes to be moved or migrated.-LocalThe Local switch specifies a local move (mailboxes are moved to a different mailbox database in the same Active Directory forest).-ManagedGmailTeamsThe ManagedGmailTeams switch specifies whether to create a Gmail calendar sync to Teams migration batch.-NameThe Name parameter specifies an unique name for the migration batch on each system (Exchange On-premises or Exchange Online).-SlackPublicDataConnectorThe SlackPublicDataConnector switch specifies this is a Slack public data connector migration batch.-SlackWorkspaceIdThe SlackWorkspaceId parameter specifies the Slack workspace ID for the Slack public data connector migration batch.-SourcePublicFolderDatabaseThe SourcePublicFolderDatabase parameter specifies the source public folder database that's used in a public folder migration.-AdoptPreexistingThe AdoptPreexisting switch specifies whether to adopt pre-existing migration users from other batches into this new batch.-AllowIncrementalSyncsThe AllowIncrementalSyncs parameter specifies whether to enable or disable incremental synchronization.-AllowUnknownColumnsInCsvThe AllowUnknownColumnsInCsv parameter specifies whether to allow extra columns in the CSV file that aren't used by migration.-ArchiveDomainThe ArchiveDomain parameter specifies the archive domain name for onboarding or offboarding migrations.-ArchiveOnlyThe ArchiveOnly switch specifies that only archive mailboxes are migrated for the users in the migration batch (primary mailboxes aren't migrated).-AutoCompleteThe AutoComplete switch forces the finalization of the individual mailboxes as soon as the mailbox has completed initial synchronization.-AutoProvisioningThe AutoProvisioning switch specifies whether to automatically provision mailboxes for Google Workspace migration or analysis batches.-AutoRetryCountThe AutoRetryCount parameter specifies the number of attempts to restart the migration batch to migrate mailboxes that encountered errors.-AutoStartThe AutoStart switch immediately starts the processing of the new migration batch.-AvoidMergeOverlapThe AvoidMergeOverlap switch specifies whether to avoid merge overlap on secondary message identifiers during Google Workspace migrations.-BadItemLimitThe BadItemLimit parameter specifies the maximum number of bad items that are allowed before the migration request fails.-CompleteAfterThe CompleteAfter parameter specifies a delay before the batch is completed.-Confirm, -cfThe Confirm switch specifies whether to show or hide the confirmation prompt.-ContentFilterThe ContentFilter parameter uses OPATH filter syntax to filter the messages by Received time.-ContentFilterLanguageThe ContentFilterLanguage parameter specifies the language being used in the ContentFilter parameter for string searches.-DataFusionThe DataFusion switch specifies whether to enable Data Fusion for Google Workspace migration batches.-Daily-DisableOnCopyThe DisableOnCopy switch disables the original migration job item for a user if you're copying users from an existing batch to a new batch by using the UserIds or Users parameters.-DisallowExistingUsersThe DisallowExistingUsers switch prevents the migration of mailboxes that are currently defined in a different migration batch.-DomainControllerThe DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory.-ExcludeDumpstersThe ExcludeDumpsters switch specifies whether to migrate public folder mailboxes without including the contents of the Recoverable Items folder (formerly known as the dumpster).-ExcludeFoldersFor an IMAP migration or Google Workspace migration, the ExcludeFolders parameter specifies mailbox folders that you don't want to migrate from the source email system to the cloud-based mailboxes.-ForwardingDispositionThe ForwardingDisposition parameter specifies how to handle Gmail messages configured for auto-forwarding during Google Workspace migrations.-GoogleResourceThe GoogleResource switch specifies that this is a Google Resource migration batch.-IncludeFoldersFor an IMAP migration or Google Workspace migration, the IncludeFolders parameter specifies mailbox folders that you want to migrate from the on-premises email system to the cloud-based mailboxes.-IncludeOtherContactsThe IncludeOtherContacts switch specifies whether to include other contacts during Google Workspace migration batches.-LargeItemLimitThe LargeItemLimit parameter specifies the maximum number of large items that are allowed before the migration request fails.-LocaleThe Locale parameter specifies the language for the migration batch.-MigrateTasksThe MigrateTasks switch specifies whether to migrate Tasks during Google Workspace migration batches.-MoveOptionsThe MoveOptions parameter specifies the stages of the migration that you want to skip for debugging purposes.-NotificationEmailsThe NotificationEmails parameter specifies one or more email addresses that migration status reports are sent to.-PartitionThis parameter is reserved for internal Microsoft use.-PrimaryOnlyThe PrimaryOnly switch specifies that only primary mailboxes are migrated for the users in the migration batch that also have archive mailboxes (archive mailboxes aren't migrated).-PublicFolderToUnifiedGroupThe PublicFolderToUnifiedGroup switch specifies a migration from public folders to Microsoft 365 Groups.-RemoveOnCopyThe RemoveOnCopy switch specifies whether to remove the source migration user from its original batch when it is adopted into this new batch.-RenamePrimaryCalendarThe RenamePrimaryCalendar switch specifies whether to rename the primary calendar during Google Workspace migrations.-ReportIntervalThe ReportInterval parameter specifies how frequently emailed reports should be sent to the email addresses listed within NotificationEmails.-RestoreThe Restore switch specifies whether to create an onboarding restore batch.-SimplifiedSwitchOverThe SimplifiedSwitchOver switch specifies whether to use simplified switchover for Google Workspace migration batches.-SkipCalendarThe SkipCalendar switch specifies that you want to skip calendar migration during Google Workspace onboarding.-SkipContactsThe SkipContacts switch specifies that you want to skip contact migration during Google Workspace onboarding.-SkipDelegatesThe SkipDelegates switch specifies whether to skip migration of delegate permissions during Google Workspace or Google Resource migration batches.-SkipDetailsThe SkipDetails switch specifies whether to skip detailed mailbox analysis in an analysis batch.-SkipMailThe SkipMail switch specifies that you want to skip mail migration during Google Workspace onboarding.-SkipMergingThe SkipMerging parameter specifies the stages of the migration that you want to skip for debugging purposes.-SkipMovingThis parameter is replaced by the MoveOptions parameter.-SkipProvisioningThe SkipProvisioning switch specifies whether to skip mailbox provisioning during Google Workspace or Google Resource migration batches.-SkipReportsThe SkipReports switch specifies that you want to skip automatic reporting for the migration.-SkipRulesThe SkipRules switch specifies that you want to skip rule migration during Google Workspace onboarding.-SkipStepsThe SkipSteps parameter specifies the steps in the staged Exchange migration that you want to skip.-SourceEndpointThe SourceEndpoint parameter specifies the migration endpoint to use for the source of the migration batch.-SourcePFPrimaryMailboxGuidThe SourcePFPrimaryMailboxGuid parameter specifies the GUID of the source primary mailbox for public folder migration to Exchange Online.-StagedRollOutGroupIdThe StagedRollOutGroupId parameter specifies the group ID for staged rollout of the Slack public data connector migration batch.-StartAfterThe StartAfter parameter specifies a delay before the data migration for the users within the batch is started.-TargetArchiveDatabasesThe TargetArchiveDatabases parameter specifies the database where the archive mailboxes specified in the migration batch are migrated to.-TargetDatabasesThe TargetDatabases parameter specifies the identity of the database that you're moving mailboxes to.-TargetDeliveryDomainThe TargetDeliveryDomain parameter specifies the FQDN of the external email address created in the source forest for the mail-enabled user when the migration batch is complete.-TargetEndpointThe TargetEndpoint parameter specifies the migration endpoint to use for the destination of the migration batch.-TimeZoneThe TimeZone parameter specifies the time zone of the administrator who submits the migration batch.-WhatIf, -wiThe WhatIf switch shows what the command does without making any changes.-WorkflowControlFlagsThe WorkflowControlFlags parameter specifies advanced controls for the steps that are performed in the migration.-WorkflowTemplateThe WorkflowTemplate parameter specifies the name of an expert migration template to use for the migration batch.-WorkloadTypeThis parameter is reserved for internal Microsoft use.-XMLDataThe XMLData parameter specifies the XML data file that contains configuration information for a large archive onboarding migration batch.