Commands › Exchange Online

Get-MoveRequest

Exchange Online ExchangeOnlineManagement Get-*

View the detailed status of an ongoing asynchronous mailbox move that was initiated by using the New-MoveRequest cmdlet.

Quick start script

# Get-MoveRequest — 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-MoveRequest | Format-List

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

Syntax — 2 parameter sets

Identity

Get-MoveRequest [[-Identity] <MoveRequestIdParameter>]
 [-Credential <PSCredential>]
 [-DomainController <Fqdn>]
 [-OrganizationalUnit <OrganizationalUnitIdParameter>]
 [-ResultSize <Unlimited>]
 [-SortBy <String>]
 [-IncludeSoftDeletedObjects]
 [-ProxyToMailbox <MailboxIdParameter>]
 [<CommonParameters>]

Filtering

Get-MoveRequest [-BatchName <String>]
 [-Credential <PSCredential>]
 [-DomainController <Fqdn>]
 [-Flags <RequestFlags>]
 [-HighPriority <Boolean>]
 [-IncludeSoftDeletedObjects]
 [-MoveStatus <RequestStatus>]
 [-Offline <Boolean>]
 [-OrganizationalUnit <OrganizationalUnitIdParameter>]
 [-Protect <Boolean>]
 [-ProxyToMailbox <MailboxIdParameter>]
 [-RemoteHostName <Fqdn>]
 [-ResultSize <Unlimited>]
 [-SortBy <String>]
 [-SourceDatabase <DatabaseIdParameter>]
 [-Status <RequestStatus>]
 [-Suspend <Boolean>]
 [-SuspendWhenReadyToComplete <Boolean>]
 [-TargetDatabase <DatabaseIdParameter>]
 [<CommonParameters>]

Parameters (20)

Parameter	Type	What it controls
-Identity	MoveRequestIdParameter	The Identity parameter specifies the identity of the move request, which is the identity of the mailbox or mail user. You can use any value that uniquely identifies the mailbox or mail user. For example:
-BatchName	String	The BatchName parameter specifies the name that was given to a batch move request.
-Credential	PSCredential	This parameter is available only in on-premises Exchange.
-DomainController	Fqdn	This parameter is available only in on-premises Exchange.
-Flags	RequestFlags	The Flags parameter specifies the move type to retrieve information for. Valid value are:
-HighPriority	Boolean	This parameter is available only in on-premises Exchange.
-IncludeSoftDeletedObjects	SwitchParameter	This parameter is available only in on-premises Exchange.
-MoveStatus	RequestStatus	The MoveStatus parameter returns move requests in the specified status. You can use the following values:
-Offline	Boolean	The Offline parameter specifies whether to return mailboxes that are being moved in offline mode. This parameter accepts $true or $false.
-OrganizationalUnit	OrganizationalUnitIdParameter	The OrganizationalUnit parameter filters the results based on the object's location in Active Directory. Only objects that exist in the specified location are returned. Valid input for this parameter is an...
-Protect	Boolean	This parameter is available only in on-premises Exchange.
-ProxyToMailbox	MailboxIdParameter	This parameter is available only in the cloud-based service.
-RemoteHostName	Fqdn	The RemoteHostName parameter specifies the FQDN of the cross-forest organization from which you're moving the mailbox.
-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.
-SortBy	String	The SortBy parameter specifies the property to sort the results by. You can sort by only one property at a time. The results are sorted in ascending order.
-SourceDatabase	DatabaseIdParameter	This parameter is available only in on-premises Exchange.
-Status	RequestStatus	This parameter is available only in the cloud-based service.
-Suspend	Boolean	The Suspend parameter specifies whether to return mailboxes with moves that have been suspended. This parameter accepts $true or $false.
-SuspendWhenReadyToComplete	Boolean	The SuspendWhenReadytoComplete parameter specifies whether to return mailboxes that have been moved with the New-MoveRequest command and its SuspendWhenReadyToComplete switch. This parameter accepts $true or $false.
-TargetDatabase	DatabaseIdParameter	This parameter is available only in on-premises Exchange.

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