Export (0) Print
Expand All

New-MigrationEndpoint

Exchange Online
 

Applies to: Exchange Server 2013, Exchange Online

Topic Last Modified: 2014-10-01

This cmdlet is available in on-premises Exchange Server 2013 and in the cloud-based service. Some parameters and settings may be exclusive to one environment or the other.

Use the New-MigrationEndpoint cmdlet to configure the connection settings for cross-forests moves, remote move migrations, cutover or staged Exchange migrations, and IMAP migrations.

For information about the parameter sets in the Syntax section below, see Syntax.

New-MigrationEndpoint -ExchangeRemoteMove <SwitchParameter> -RemoteServer <Fqdn> [-Credentials <PSCredential>] <COMMON PARAMETERS>
New-MigrationEndpoint -Autodiscover <SwitchParameter> -Credentials <PSCredential> -EmailAddress <SmtpAddress> -ExchangeRemoteMove <SwitchParameter> <COMMON PARAMETERS>
New-MigrationEndpoint -Credentials <PSCredential> -PublicFolder <SwitchParameter> -PublicFolderDatabaseServerLegacyDN <String> -RpcProxyServer <Fqdn> -SourceMailboxLegacyDN <String> [-Authentication <Basic | Digest | Ntlm | Fba | WindowsIntegrated | LiveIdFba | LiveIdBasic | WSSecurity | Certificate | NegoEx | OAuth | Adfs | Kerberos | Negotiate | LiveIdNegotiate | Misconfigured>] [-TestMailbox <MailboxIdParameter>] <COMMON PARAMETERS>
New-MigrationEndpoint -Autodiscover <SwitchParameter> -Credentials <PSCredential> -EmailAddress <SmtpAddress> -ExchangeOutlookAnywhere <SwitchParameter> [-MailboxPermission <Admin | FullAccess>] [-SourceMailboxLegacyDN <String>] [-TestMailbox <MailboxIdParameter>] <COMMON PARAMETERS>
New-MigrationEndpoint -Credentials <PSCredential> -ExchangeOutlookAnywhere <SwitchParameter> [-Authentication <Basic | Digest | Ntlm | Fba | WindowsIntegrated | LiveIdFba | LiveIdBasic | WSSecurity | Certificate | NegoEx | OAuth | Adfs | Kerberos | Negotiate | LiveIdNegotiate | Misconfigured>] [-EmailAddress <SmtpAddress>] [-ExchangeServer <String>] [-MailboxPermission <Admin | FullAccess>] [-NspiServer <String>] [-RpcProxyServer <Fqdn>] [-SourceMailboxLegacyDN <String>] [-TestMailbox <MailboxIdParameter>] <COMMON PARAMETERS>
New-MigrationEndpoint -PSTImport <SwitchParameter> -RemoteServer <Fqdn> [-Credentials <PSCredential>] <COMMON PARAMETERS>
New-MigrationEndpoint -IMAP <SwitchParameter> -RemoteServer <Fqdn> [-Authentication <Basic | Digest | Ntlm | Fba | WindowsIntegrated | LiveIdFba | LiveIdBasic | WSSecurity | Certificate | NegoEx | OAuth | Adfs | Kerberos | Negotiate | LiveIdNegotiate | Misconfigured>] [-Port <Int32>] [-Security <None | Ssl | Tls>] <COMMON PARAMETERS>
COMMON PARAMETERS: -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MaxConcurrentIncrementalSyncs <Unlimited>] [-MaxConcurrentMigrations <Unlimited>] [-Organization <OrganizationIdParameter>] [-Partition <MailboxIdParameter>] [-SkipVerification <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

This example creates an endpoint for remote moves by using the Autodiscover parameter to detect the settings.

New-MigrationEndpoint -Name Endpoint1 -ExchangeRemoteMove -Autodiscover -EmailAddress tonysmith@contoso.com -Credentials (Get-Credential contoso\tonysmith)

This example creates an endpoint for remote moves by specifying the settings manually.

New-MigrationEndpoint -Name Endpoint2 -ExchangeRemoteMove -RemoteServer MRSServer.contoso.com -Credentials (Get-Credential Contoso.com\Administrator)

This example creates an Outlook Anywhere migration endpoint by using the Autodiscover parameter to detect the connection settings to the on-premises organization. Outlook Anywhere endpoints are used for cutover and staged Exchange migrations. The Get-Credential cmdlet is used to obtain the credentials for an on-premises account that has the necessary administrative privileges in the domain and that can access the mailboxes that will be migrated. When prompted for the user name, you can use either the email address or the domain\user name format for the administrator account. This account can be the same one that is specified by the EmailAddress parameter.

$Credentials = Get-Credential
New-MigrationEndpoint -ExchangeOutlookAnywhere -Name EXCH-AutoDiscover -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

This example creates an Outlook Anywhere migration endpoint by specifying the connection settings manually. Outlook Anywhere endpoints are used for cutover and staged Exchange migrations. The value for the ExchangeServer parameter specifies the on-premises Exchange server that hosts the mailboxes that will be migrated. The value for the RPCProxyServer parameter specifies a Client Access server in the on-premises organization. The EmailAddress parameter can specify any mailbox in the on-premises domain.

New-MigrationEndpoint -ExchangeOutlookAnywhere -Name EXCH_Manual -ExchangeServer EXCH-01-MBX.contoso.com -RPCProxyServer EXCH-02-CAS.contoso.com -Credentials (Get-Credential administrator@contoso.com) -EmailAddress annb@contoso.com

ImportantImportant:
It's recommended that you use a migration endpoint created with connection settings that are automatically discovered (see Example 3) because the Autodiscover service will be used to connect to each user mailbox in the migration batch. If you manually specify the connection settings for the endpoint and a user mailbox isn’t located on the server specified by the ExchangeServer parameter, the migration for that user will fail. This is important if you have multiple on-premises Exchange servers. Otherwise, you may need to create different migration endpoints that correspond to each on-premises server.

This example creates an IMAP migration endpoint. The value for the RemoteServer parameter specifies the FQDN of the IMAP server that hosts the mailboxes that will be migrated. The endpoint is configured to use port 993 for SSL encryption.

New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl

This example creates an IMAP migration endpoint that supports 50 concurrent migrations and 10 concurrent incremental synchronizations. The endpoint is configured to use port 143 for TLS encryption.

New-MigrationEndpoint -IMAP -Name IMAP_TLS_Endpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 10

The New-MigrationEndpoint cmdlet configures the connection settings for different types of migrations:

  • Cross-forest move: Move mailboxes between two different on-premises Exchange forests. Cross-forest moves require the use of a Remote Move endpoint.

  • Remote move migration: In a hybrid deployment, a remote move migration involves onboarding or offboarding migrations. Remote move migrations also require the use of an Exchange remote move endpoint. Onboarding moves mailboxes from an on-premises Exchange organization to Exchange Online in Office 365, and uses a remote move endpoint as the source endpoint of the migration batch. Offboarding moves mailboxes from Exchange Online in Office 365 to an on-premises Exchange organization and uses a remote move endpoint as the target endpoint of the migration batch.

  • Cutover Exchange migration: Migrate all mailboxes in an on-premises Exchange organization to Exchange Online in Office 365. A cutover Exchange migration requires the use of an Outlook Anywhere migration endpoint.

  • Staged Exchange migration: Migrate a subset of mailboxes from an on-premises Exchange organization to Exchange Online in Office 365. A staged Exchange migration requires the use of an Outlook Anywhere migration endpoint.

  • IMAP migration: Migrate mailbox data from an on-premises Exchange organization or other email system to Exchange Online in Office 365. For an IMAP migration, you must first create the cloud-based mailboxes before you migrate mailbox data. IMAP migrations require the use of an IMAP endpoint.

NoteNote:
Moving mailboxes between different servers or databases within a single on-premises Exchange forest (called a local move) doesn't require a migration endpoint.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Mailbox Move and Migration Permissions" section in the Recipients Permissions topic.

 

Parameter Required Type Description

Autodiscover

Required

System.Management.Automation.SwitchParameter

For an Exchange migration, the Autodiscover parameter specifies whether to get other connection settings for the on-premises server from the Autodiscover service.

EmailAddress

Required

Microsoft.Exchange.Data.SmtpAddress

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

Required

System.Management.Automation.SwitchParameter

This parameter is available only in the cloud-based service.

The ExchangeOutlookAnywhere parameter specifies the type of endpoint for staged and cutover migrations.

ExchangeRemoteMove

Required

System.Management.Automation.SwitchParameter

The ExchangeRemoteMove parameter specifies the type of endpoint for cross-forest moves and remote move migrations in a hybrid deployment.

IMAP

Required

System.Management.Automation.SwitchParameter

This parameter is available only in the cloud-based service.

The IMAP parameter specifies the type of endpoint for IMAP migrations.

Name

Required

System.String

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.

PSTImport

Required

System.Management.Automation.SwitchParameter

The PSTImport parameter specifies the type of endpoint for PST Import migrations.

PublicFolder

Required

System.Management.Automation.SwitchParameter

This parameter is reserved for internal Microsoft use.

PublicFolderDatabaseServerLegacyDN

Required

System.String

This parameter is reserved for internal Microsoft use.

RemoteServer

Required

Microsoft.Exchange.Data.Fqdn

The RemoteServer parameter specifies the FQDN of the remote server, which depends on the protocol type for moves:

  • For cross-forest moves and remote move migrations, this parameter refers to the Client Access server in the on-premises organization.

  • For IMAP migrations, this parameter refers to the IMAP server.

RpcProxyServer

Required

Microsoft.Exchange.Data.Fqdn

This parameter is available only in the cloud-based service.

The RpcProxyServer parameter specifies the FQDN of the Client Access server for the on-premises Exchange organization. This parameter is used when you create an Outlook Anywhere migration endpoint for cutover and staged Exchange migrations. Typically, this FQDN will be the same as your Outlook Web App URL; for example, mail.contoso.com. This is also the URL for the proxy server that Outlook uses to connect to an Exchange server.

This parameter is required only when you don't use the Autodiscover parameter.

SourceMailboxLegacyDN

Required

System.String

This parameter is available only in the cloud-based service.

The SourceMailboxLegacyDN parameter specifies the LegacyExchangeDN of an on-premises mailbox used to test the ability of the migration service to create a connection using this endpoint. The cmdlet tries to access this mailbox using the credentials for the administrator account specified in the command.

Authentication

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AuthenticationMethod

This parameter is available only in the cloud-based service.

The Authentication parameter specifies the authentication method used by the on-premises mail server. If you don't include this parameter, Basic authentication is used.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.

Credentials

Optional

System.Management.Automation.PSCredential

The Credentials parameter specifies the credentials to connect to the source or target endpoint for all Exchange migration types.

This parameter requires the creation and passing of a credential object. This credential object is created by using the Get-Credential cmdlet. For more information, see Get-Credential.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

This parameter is available only in the cloud-based service.

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

ExchangeServer

Optional

System.String

This parameter is available only in the cloud-based service.

The ExchangeServer parameter specifies the FQDN of the on-premises Exchange server that hosts the mailboxes that will be migrated. This parameter is used when you create an Outlook Anywhere migration endpoint for cutover and staged Exchange migrations.

This parameter is required only when you don't use the Autodiscover parameter.

MailboxPermission

Optional

Microsoft.Exchange.Data.Storage.Management.MigrationMailboxPermission

This parameter is available only in the cloud-based service.

The MailboxPermission parameter specifies what permissions to use to access the source mailbox during Outlook Anywhere onboarding (staged Exchange migration and cutover Exchange migration).

The migration administrator account specified for the endpoint must have one of the following permissions:

  • Admin: The account is a domain administrator who can access any mailbox they want to migrate.

  • FullAccess: The account is assigned either the Full Access permission to the mailboxes they want to migrate or the Receive As permission to the mailbox database that hosts the mailboxes that will be migrated.

If this parameter isn’t specified, the cmdlet tries to access source mailboxes using the domain administrator permission and if that fails, it then tries to access the source mailboxes using the Full Access or Receive As permissions.

This parameter can’t be used for creating non-Outlook Anywhere migration endpoints.

MaxConcurrentIncrementalSyncs

Optional

Microsoft.Exchange.Data.Unlimited

The MaxConcurrentIncrementalSyncs parameter specifies the maximum number of incremental syncs allowed per endpoint. The default value is 20.

MaxConcurrentMigrations

Optional

Microsoft.Exchange.Data.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

Optional

System.String

This parameter is available only in the cloud-based service.

The NspiServer parameter specifies the remote Name Service Provider Interface (NSPI) server location for cutover and staged migrations. You must provide the FQDN of the server.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

This parameter is reserved for internal Microsoft use.

Partition

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

This parameter is reserved for internal Microsoft use.

Port

Optional

System.Int32

This parameter is available only in the cloud-based service.

For an IMAP migration, the Port parameter specifies the TCP port number used by the migration process to connect to the remote server. This parameter is required when you want to migrate data from an on-premises IMAP server to cloud-based mailboxes.

Security

Optional

Microsoft.Exchange.Data.IMAPSecurityMechanism

This parameter is available only in the cloud-based service.

The Security parameter specifies the encryption method used by the IMAP server for an IMAP migration. Options are None, SSL (the default), or TLS. This parameter is required when you want to migrate data from an on-premises IMAP server to cloud-based mailboxes.

SkipVerification

Optional

System.Management.Automation.SwitchParameter

The SkipVerification switch specifies whether to skip verifying that the remote server is reachable when creating a migration endpoint. The default value is $false.

TestMailbox

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

This parameter is available only in the cloud-based service.

The TestMailbox parameter specifies an Exchange Online mailbox used as the target by the migration service to verify the connection using this endpoint. If this parameter isn’t specified, the migration service uses the migration arbitration mailbox in the Exchange Online organization to verify the connection.

This parameter is only used to create Outlook Anywhere migration endpoints.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft