Applies to: Exchange Server 2013, Exchange Online
Topic Last Modified: 2012-09-18
Use the Get-MigrationEndpoint cmdlet to retrieve migration endpoint settings for source or destination servers for cutover or staged Exchange migrations, IMAP migrations, and remote moves.
For information about the parameter sets in the Syntax section below, see Syntax.
Syntax
Get-MigrationEndpoint -Type <None | IMAP | Hotmail |
ExchangeOutlookAnywhere | BulkProvisioning | ExchangeRemoteMove |
ExchangeLocalMove> <COMMON PARAMETERS>
|
Get-MigrationEndpoint -ConnectionSettings
<ExchangeConnectionSettings> <COMMON PARAMETERS>
|
Get-MigrationEndpoint [-Identity
<MigrationEndpointIdParameter>] <COMMON
PARAMETERS>
|
COMMON PARAMETERS: [-Diagnostic <SwitchParameter>]
[-DiagnosticArgument <String>] [-DomainController
<Fqdn>] [-Organization
<OrganizationIdParameter>]
|
Examples
EXAMPLE 1
This example retrieves the settings for the migration endpoint, OnboardingME01.
 Copy Code |
|
|---|---|
Get-MigrationEndpoint -Identity OnboardingME01 |
|
Detailed Description
The Get-MigrationEndpoint cmdlet retrieves settings for different types of migration:
- Cross-forest move Move mailboxes
between two different on-premises Exchange forests. Cross-forest
moves require the use of a RemoteMove endpoint.
- Remote move In a hybrid deployment, a
remote move involves onboarding or offboarding
migrations. Remote moves require the use of a RemoteMove endpoint.
Onboarding moves mailboxes from an on-premises Exchange
organization to Exchange Online in Office 365, and uses a
RemoteMove 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 RemoteMove 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. Cutover Exchange migration requires the use
of an Exchange endpoint.
- Staged Exchange migration Migrate a
subset of mailboxes from an on-premises Exchange organization to
Exchange Online in Office 365. Staged Exchange migration requires
the use of an Exchange 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.
- Local Move mailboxes between different
servers or databases within a single on-premises Exchange forest.
Local moves don't require the use of an endpoint.
For more information about the different move and migration scenarios, see:
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.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
ConnectionSettings |
Required |
Microsoft.Exchange.Data.Storage.Management.ExchangeConnectionSettings |
The ConnectionSettings parameter specifies the configuration settings of source or target servers for which you want to find a matching endpoint. |
|
Type |
Required |
Microsoft.Exchange.Data.Storage.Management.MigrationType |
The Type parameter specifies what type of migration you want configuration settings for:
|
|
Diagnostic |
Optional |
System.Management.Automation.SwitchParameter |
This parameter is reserved for internal Microsoft use. |
|
DiagnosticArgument |
Optional |
System.String |
This parameter is reserved for internal Microsoft use. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory. In the cloud-based service, this parameter is reserved for internal Microsoft use. |
|
Identity |
Optional |
Microsoft.Exchange.Management.Migration.MigrationEndpointIdParameter |
The Identity parameter specifies the name of the migration endpoint you want to retrieve settings for. |
|
Organization |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
This parameter is reserved for internal Microsoft use. |
Input Types
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.
Return Types
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.