Exchange Migration Batch Percentage Progress

Exchange Mailbox Migration

Microsoft recently released a preview version of Cross Tenant mailbox migration.

The process of performing a cross tenant migration is not for the faint of heart as it involves a lot of steps. Many of them can go wrong which complicates troubleshooting.

However, making sure that you honor all pre-requisites will provide you with a great alternative to third party tools. Following the new (preview) procedure gives you full control of every step of the migration.

This article solves a simple challenge that we faced at the end stage of our Exchange mailbox migration procedure:

How to Get a Good Overview of Mailbox Migration Progress

One way to get detailed information on mailbox synchronization progress is to combine the Get-MigrationUser command with the Get-MigrationUserStatistics command.

The Get-MigrationUser gets all users (mailboxes) that are included in a migration batch. This can then be piped to the Get-MigrationUserStatistics command which holds a lot of details about the progress of individual mailboxes.

To generate the percentage progress use the SyncedItemCount and TotalItemsInSourceMailboxCount attributes of the output from Get-MigrationUserStatistics.

This final script looks like this:

Get-MigrationUser -BatchId "E365M Batch" | Get-MigrationUserStatistics | ft Identity,@{Label="TotalItems";Expression={$_.TotalItemsInSourceMailboxCount}},@{Label="SyncedItems";Expression={$_.SyncedItemCount}},@{Label="Completion";Expression={ $_.SyncedItemCount / $_.TotalItemsInSourceMailboxCount}; FormatString="P"}

The output of the script looks similar to the following:

Identity                            TotalItems SyncedItems Completion
--------                            ---------- ----------- ----------          198488        5674      2.86%          56155       11296     20.12%        202801       69930     34.48%       195394      100226     51.29%        128332       50257     39.16%           60757       20571     33.86%         760196       33211      4.37%       236385       26077     11.03%        247650       63596     25.68%      2080         918     44.13%

Flash That Data!

All in all a simple one-liner that can help you set expectations about the completion of your migration batch.

By importing the data to Excel you’re a only a few chart inserts away from being that stand-out guy who knows how to communicate migration progress on the next project meeting: