Commands › Exchange Online

New-MigrationEndpoint

Exchange Online ExchangeOnlineManagement New-*

Configure the connection settings for cross-forests moves, remote move migrations, cutover or staged Exchange migrations, IMAP migrations, and Google Workspace (formerly G Suite) migrations.

Quick start script

# New-MigrationEndpoint — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-MigrationEndpoint
$before | Format-List

# 3. Make the change (dry run first)
New-MigrationEndpoint -Name <String> -Autodiscover <SwitchParameter> -Compliance <SwitchParameter> -WhatIf
New-MigrationEndpoint -Name <String> -Autodiscover <SwitchParameter> -Compliance <SwitchParameter>

# 4. Verify and diff
$after = Get-MigrationEndpoint
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 13 parameter sets

ExchangeRemoteMoveAutoDiscover

New-MigrationEndpoint -Name <String> -Credentials <PSCredential> -EmailAddress <SmtpAddress>
 [-Autodiscover]
 [-ExchangeRemoteMove]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MaxConcurrentIncrementalSyncs <Unlimited>]
 [-MaxConcurrentMigrations <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [-SkipVerification]
 [-WhatIf]
 [<CommonParameters>]

ExchangeOutlookAnywhereAutoDiscover

New-MigrationEndpoint -Name <String> -Credentials <PSCredential> -EmailAddress <SmtpAddress>
 [-Autodiscover]
 [-ExchangeOutlookAnywhere]
 [-AcceptUntrustedCertificates]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MaxConcurrentIncrementalSyncs <Unlimited>]
 [-MaxConcurrentMigrations <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [-SkipVerification]
 [-SourceMailboxLegacyDN <String>]
 [-TestMailbox <MailboxIdParameter>]
 [-WhatIf]
 [<CommonParameters>]

ExchangeOutlookAnywhere

New-MigrationEndpoint -Name <String> -Credentials <PSCredential>
 [-EmailAddress <SmtpAddress>]
 [-ExchangeOutlookAnywhere]
 [-ExchangeServer <String>]
 [-AcceptUntrustedCertificates]
 [-Authentication <AuthenticationMethod>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MailboxPermission <MigrationMailboxPermission>]
 [-MaxConcurrentIncrementalSyncs <Unlimited>]
 [-MaxConcurrentMigrations <Unlimited>]
 [-NspiServer <String>]
 [-Partition <MailboxIdParameter>]
 [-RpcProxyServer <Fqdn>]
 [-SkipVerification]
 [-SourceMailboxLegacyDN <String>]
 [-TestMailbox <MailboxIdParameter>]
 [-WhatIf]
 [<CommonParameters>]

ExchangeRemoteMove

New-MigrationEndpoint -Name <String> -RemoteServer <Fqdn>
 [-Credentials <PSCredential>]
 [-ExchangeRemoteMove]
 [-ApplicationId <String>]
 [-AppSecretKeyVaultUrl <String>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-MaxConcurrentIncrementalSyncs <Unlimited>]
 [-MaxConcurrentMigrations <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [-RemoteTenant <String>]
 [-SkipVerification]
 [-WhatIf]
 [<CommonParameters>]

9 more parameter sets — see the parameter table below.

Parameters (37)

Parameter	Type	Required	What it controls
-Name	String	yes	The Name parameter specifies the name you give to the new migration endpoint. You can use the Name parameter when you run the New-MigrationBatch cmdlet.
-Autodiscover	SwitchParameter	yes	The Autodiscover switch specifies whether to get other connection settings for the on-premises server from the Autodiscover service for Exchange migrations. You don't need to specify a value with this switch.
-Compliance	SwitchParameter	yes	The Compliance switch specifies that the endpoint type is compliance. You don't need to specify a value with this switch.
-Credentials	PSCredential	yes	The Credentials parameter specifies the credentials to connect to the source or target endpoint for all Exchange migration types.
-EmailAddress	SmtpAddress	yes	The EmailAddress parameter specifies the email address used by the Autodiscover service or in some cases used to validate the endpoint when you specify the connection settings manually.
-ExchangeOutlookAnywhere	SwitchParameter	yes	This parameter is available only in the cloud-based service.
-ExchangeRemoteMove	SwitchParameter	yes	The ExchangeRemoteMove switch specifies the type of endpoint for cross-forest moves and remote move migrations in a hybrid deployment. You don't need to specify a value with this switch.
-Gmail	SwitchParameter	yes	This parameter is available only in the cloud-based service.
-IMAP	SwitchParameter	yes	This parameter is available only in the cloud-based service.
-OAuthCode	SecureString	yes	This parameter is available only in the cloud-based service.
-PSTImport	SwitchParameter	yes	This parameter is available only in on-premises Exchange.
-PublicFolder	SwitchParameter	yes	This parameter is available only in the cloud-based service.
-PublicFolderDatabaseServerLegacyDN	String	yes	This parameter is available only in the cloud-based service.
-PublicFolderToUnifiedGroup	SwitchParameter	yes	The PublicFolderToUnifiedGroup switch specifies that the endpoint type is public folders to Microsoft 365 Groups. You don't need to specify a value with this switch.
-RemoteServer	Fqdn	yes	The RemoteServer parameter specifies the FQDN of the remote server, which depends on the protocol type for moves:
-RpcProxyServer	Fqdn	yes	This parameter is available only in the cloud-based service.
-ServiceAccountKeyFileData	Byte[]	yes	This parameter is available only in the cloud-based service.
-SourceMailboxLegacyDN	String	yes	This parameter is available only in the cloud-based service.
-AcceptUntrustedCertificates	SwitchParameter		The AcceptUntrustedCertificates switch specifies whether to accept untrusted certificates from the remote server. You don't need to specify a value with this switch.
-ApplicationId	String		This parameter is available only in the cloud-based service.
-AppSecretKeyVaultUrl	String		This parameter is available only in the cloud-based service.
-Authentication	AuthenticationMethod		This parameter is available only in the cloud-based service.
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-ExchangeServer	String		This parameter is available only in the cloud-based service.
-MailboxPermission	MigrationMailboxPermission		This parameter is available only in the cloud-based service.
-MaxConcurrentIncrementalSyncs	Unlimited		The MaxConcurrentIncrementalSyncs parameter specifies the maximum number of incremental syncs allowed per endpoint. The default value is 20.
-MaxConcurrentMigrations	Unlimited		The MaxConcurrentMigrations parameter specifies the maximum number of mailboxes that are migrated during initial sync. This parameter is applicable for all migration types. The default value is 100.
-NspiServer	String		This parameter is available only in the cloud-based service.
-Partition	MailboxIdParameter		This parameter is available only in the cloud-based service.
-Port	Int32		This parameter is available only in the cloud-based service.
-RedirectUri	String	yes	This parameter is available only in the cloud-based service.
-RemoteTenant	String		This parameter is available only in the cloud-based service.
-Security	IMAPSecurityMechanism		This parameter is available only in the cloud-based service.
-SkipVerification	SwitchParameter		The SkipVerification switch specifies whether to skip verifying that the remote server is reachable when creating a migration endpoint. You don't need to specify a value with this switch.
-TestMailbox	MailboxIdParameter		This parameter is available only in the cloud-based service.
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.