Commands › Exchange Online

Set-MigrationEndpoint

Exchange Online ExchangeOnlineManagement Set-*

Edit settings for cutover or staged Exchange migrations, IMAP migrations, Google Workspace (formerly G Suite) migrations, and remote moves.

Quick start script

# Set-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)
Set-MigrationEndpoint -Identity <MigrationEndpointIdParameter> -WhatIf
Set-MigrationEndpoint -Identity <MigrationEndpointIdParameter>

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

Syntax

Set-MigrationEndpoint [-Identity] <MigrationEndpointIdParameter>
 [-AcceptUntrustedCertificates <Boolean>]
 [-ApplicationId <String>]
 [-AppSecretKeyVaultUrl <String>]
 [-Authentication <AuthenticationMethod>]
 [-Confirm]
 [-Credentials <PSCredential>]
 [-DomainController <Fqdn>]
 [-ExchangeServer <String>]
 [-MailboxPermission <MigrationMailboxPermission>]
 [-MaxConcurrentIncrementalSyncs <Unlimited>]
 [-MaxConcurrentMigrations <Unlimited>]
 [-NspiServer <String>]
 [-Partition <MailboxIdParameter>]
 [-Port <Int32>]
 [-PublicFolderDatabaseServerLegacyDN <String>]
 [-RemoteServer <Fqdn>]
 [-RpcProxyServer <Fqdn>]
 [-Security <IMAPSecurityMechanism>]
 [-ServiceAccountKeyFileData <Byte[]>]
 [-SkipVerification]
 [-SourceMailboxLegacyDN <String>]
 [-TestMailbox <MailboxIdParameter>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (24)

Parameter	Type	Required	What it controls
-Identity	MigrationEndpointIdParameter	yes	The Identity parameter specifies the name of the migration endpoint you want to configure.
-AcceptUntrustedCertificates	Boolean		This parameter is available only in the cloud-based service.
-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.
-Credentials	PSCredential		The Credentials parameter specifies the username and password for connecting to the remote endpoint. Credentials should be used when modifying either a staged or cutover Exchange endpoint or a RemoteMove endpoint.
-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 for this endpoint at a specified time. This value must be less or equal to MaxConcurrentMigrations parameter.
-MaxConcurrentMigrations	Unlimited		The MaxConcurrentMigrations parameter specifies the maximum number of migrated mailboxes for this endpoint at a specified time. This parameter is applicable for all migration types.
-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.
-PublicFolderDatabaseServerLegacyDN	String		This parameter is available only in the cloud-based service.
-RemoteServer	Fqdn		The RemoteServer parameter specifies the remote server depending on the protocol type for moves:
-RpcProxyServer	Fqdn		This parameter is available only in the cloud-based service.
-Security	IMAPSecurityMechanism		This parameter is available only in the cloud-based service.
-ServiceAccountKeyFileData	Byte[]		This parameter is available only in the cloud-based service.
-SkipVerification	SwitchParameter		The SkipVerification switch skips verifying that the remote server is reachable when modifying a migration endpoint. You don't need to specify a value with this switch.
-SourceMailboxLegacyDN	String		This parameter is available only in the cloud-based service.
-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.