Commands › Exchange Online

Get-MigrationUser

Exchange Online ExchangeOnlineManagement Get-*

View information about move and migration users.

Quick start script

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

# 2. Run and inspect
Get-MigrationUser -MailboxGuid <Guid> -EmailAddress <EmailAddress> | Format-List

# 3. Export for evidence / drift tracking
Get-MigrationUser | Export-Clixml .\MigrationUser-$(Get-Date -Format yyyyMMdd).xml

Syntax — 4 parameter sets

MailboxGuid

Get-MigrationUser -MailboxGuid <Guid>
 [-DomainController <Fqdn>]
 [-IncludeAssociatedUsers]
 [-ResultSize <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [<CommonParameters>]

StatusAndBatchId

Get-MigrationUser [-BatchId <MigrationBatchIdParameter>] [-Status <MigrationUserStatus>] [-StatusSummary <MigrationUserStatusSummary>]
 [-DomainController <Fqdn>]
 [-IncludeAssociatedUsers]
 [-ResultSize <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [<CommonParameters>]

Identity

Get-MigrationUser [[-Identity] <MigrationUserIdParameter>]
 [-DomainController <Fqdn>]
 [-IncludeAssociatedUsers]
 [-ResultSize <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [<CommonParameters>]

EmailAddress

Get-MigrationUser -EmailAddress <SmtpAddress>
 [-DomainController <Fqdn>]
 [-IncludeAssociatedUsers]
 [-ResultSize <Unlimited>]
 [-Partition <MailboxIdParameter>]
 [<CommonParameters>]

Parameters (10)

Parameter	Type	Required	What it controls
-Identity	MigrationUserIdParameter		The Identity parameter specifies the particular ongoing migration that you want to retrieve information about. The Identity parameter is usually represented as an email address.
-MailboxGuid	Guid	yes	The MailboxGuid parameter specifies the GUID of a mailbox for which you want to view the migration information.
-BatchId	MigrationBatchIdParameter		The BatchId parameter specifies the name of the migration batch for which you want to return users.
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-EmailAddress	EmailAddress	yes	The EmailAddress parameter specifies the particular user that you want to retrieve information about. The EmailAddress parameter is represented as an email address. This parameter is available only in the cloud-based service.
-IncludeAssociatedUsers	SwitchParameter		This parameter is available only in the cloud-based service.
-Partition	MailboxIdParameter		This parameter is available only in the cloud-based service.
-ResultSize	Unlimited		The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.
-Status	MigrationUserStatus		The Status parameter returns information about migration users that have the specified status state. Use one of the following values:
-StatusSummary	MigrationUserStatusSummary		The StatusSummary parameter returns abbreviated information about migration users that have the specified status value. Use one of the following values:

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