1. Migration batches | Get-MigrationBatch

The term – “Migration Batch”, define an entity that serves as a “logical container”, that contain the mailboxes (and their associated users), that we migrate from the source Exchange server to the destination Exchange server (Exchange Online in our scenario).

Migration batch status

Using the “Status” parameter, we can get information about the existing migration batch that has a specific “Status”.

The migration batch type of “Statuses” value could be as follow:

• Completed
• CompletedWithErrors
• Completing
• Corrupted
• Created
• Failed
• IncrementalSyncing
• Removing
• Starting
• Stopped
• Syncing
• Stopping
• Synced
• SyncedwithErrors
• Waiting

To view a migration batch with a specific status, we can use the following PowerShell syntax

3. Move requests

The term – “Move request”, define the Exchange mailbox that we migrate from the “source Exchange server” to the “destination Exchange server”.

The two PowerShell cmdlets that we use for getting information about the move requests of the “mailbox entity” are:

• Get-MoveRequest
• Get-MoveRequestStatistics

2. Using the Get-MoveRequest command

The PowerShell command Get-MoveRequest, get basic information about a property of a specific mailbox that we migrate.

Get information about ALL existing Move mailbox requests

When we use the PowerShell, command Get-MoveRequest without relating to a specific move request, meaning, without specifying the identity of a specific move request, the PowerShell command will display information about ALL existing “Move Requests”.

Export information about MoveRequest with a specific status

Each of the “move requests” could have a specific “status” such as – Completed ,Failed and so on.

The available status codes values are as follow:

• AutoSuspended
• Completed
• CompletedWithWarning
• CompletionInProgress
• Failed
• InProgress
• None
• Queued

In case you want to get information only about the specific status of “Move requests”, you can use the following PowerShell syntax:

3. Using the MoveRequestStatistics command

The purpose of the PowerShell command Get-MoveRequestStatistics, is to get detailed information about the “migrated mailbox content”.

For example,

ItemsTransferred – information about the number of mail items, that was already transferred.

PercentComplete – as the name implies, information about the “Complete percentage” of the mailbox migration process.

If we want to eliminate unmercenary data and get a “clear view” of the mailbox migration Statistics, we can ask from PowerShell to display only specific data fields.

Combine the Get-MoveRequest + Get-Moverequeststatistics commands

A nice option that we can use when using PowerShell is a “combination” of two or more PowerShell command. The formal term for this method is “pipeline”.

In the following scenario, we a combination of two PowerShell commands:

• Get-MoveRequest
• Get-MoveRequestStatistics

The first command Get-MoveRequest will “fetch” all the existing “Move Requests”.

The second command Get-MoveRequestStatistics, will use the “move requests list” form the first command, and add the “statistics information” for each mailbox move requests.

Get + Export information about ALL concurrent move requests Statistics + troubleshooting information

In this scenario, we add the additional parameters- “IncludeReport” and “Diagnostic” for getting more details about the Move Request Statistics.
Most of the time, we will use this additional parameter is a troubleshooting scenario.

In addition, I add an example of- exporting information to XML file because in case that we need to deliver the exported information to Microsoft support for further analysis, this is the “preferred” file format.

Other variation of the PowerShell command syntax that we can use for getting information about move requests with a specific status such as Failed move requests + statistics information about each move requests could be:

Restore Exchange Online mailbox | Article series index