When you launch the Admin Portal for the first time, the Mailboxes view displays as the default view. This view consists of a list of mailboxes from various Exchange sites and servers. You may recall that while installing, you had specified the domain name and when the tool launched, it picked up all the mailboxes from all the Exchange server sites (2010, 2013, 2016, and 2019) in the specified forest.
This view is considered the most important view as this is where the administrators spend most of their time. From here, they can select mailboxes that can be added to the migration queue. This view also provides the administrator all the information that they need in order to select data for migration.
Before we begin to migrate mailboxes using Migrator Pro for Exchange, let's get familiar with the interface components and how they are used to view migration data. Please note that even though the Mailboxes view is being used to understand how to work within a view, the primary format of the data view remains the same for all the other buttons/tabs with few exceptions, as you will see as we proceed.
User data is stored in various attributes in AD. Some of the attributes are displayed by default, such as Site name, Source Server, Mailbox Database, and Email address as shown below. Additional attributes can be added to the list as desired.
To change the displayed attributes (columns), right-click in the list of user mailboxes:
... and then select Choose columns, to open this dialog box:
This dialog box shows a complete list of attributes. You can select attributes that are not currently displayed, or deselect attributes to hide them.
You can also change the order in which the attributes are displayed in the view simply by clicking a column, dragging, and then dropping it where you wish to place it. For example, you can make the First Name column the first column by clicking it, dragging, and then dropping it in the space before the Site Name column or over the column.
You can choose a group by selecting the Group Membership option under Advanced Filter. The list of available groups displays. You may quickly find a group by typing in the first few characters to filter the list. Selecting a group will limit the display to users possessing that membership.
By default, the mailboxes are not sorted on any specific column. However, you can sort them by any column that you want.
To sort data by their First Name, simply click the First Name column header. When the data is sorted, an inverted triangle appears above the column name. Please notice that the data is now sorted in ascending order in the Data Panel:
To reverse the sort order, just click the same column header again:
To sort by the values in some other column, click on the other column header.
To do a hierarchical sort, sort the data on one column, then hold down the Shift key and click the next column by which you want data sorted. To remove sorting from one of the columns, hold down the Shift key and click the triangle.
The filter icon next to each column header lets you quickly filter any column in view. To select the filter criteria:
The Quick Filters and Quick Search fields display in the Data Panel section when you select the Mailboxes button. This panel remains the same for all the views, except in some views additional components are available.
Quick Filters options:
Quick Search options:
Migrator Pro for Exchange lets you import from a text file to facilitate searches for specific users within the environment. This CSV import feature is also available in the Group Membership feature under Advanced Filter from the Migrator Pro for Exchange Admin Portal Mailboxes view.
To import users from a text file:
You can export data to a CSV file from either the Mailboxes view or from the Mailbox Jobs view. To export data to a CSV file:
Here’s an example of exported data from the Mailboxes view:
You can change certain properties of mailboxes by using the right-click menu. To change the properties of mailboxes:
Do Not Start Before
Do Not Complete Before
Bad Item Limit
Large Item Limit
Only an existing Blackout Profile property can be added to a mailbox or mailbox job. The Blackout Profile must be created first (see Blackout Times View for information about this feature). The Default Blackout Profile is already applicable to all mailboxes and mailbox jobs.
Once you have configured settings, and reviewed the data you need to migrate, you are ready to start the migration process. The first step is to add the mailboxes from the Mailboxes view to the Mailbox Jobs.
If your source mailboxes have delegate associations that you want to preserve after the migration (by migrating the mailboxes together), see the topic Migrating Delegation Rights for information about how to accomplish that. You may then either migrate the associated mailboxes by the View Delegation features (as described in that other topic), or return here to view delegation associations from this Mailboxes view and add them to Mailbox Jobs as described below.
Whether or not you will migrate mailboxes in delegation groups, before adding mailboxes to Mailbox Jobs you should run this command to verify the validity of the target:
Get-MailboxDatabase | ft Name,IsExcludedFromProvisioning,IsSuspendedFromProvisioning
If either returns True, Migrator Pro for Exchange will be unable to use it as a target. In that case, run this command to enable the target:
Set-MailboxDatabase MDB01 -IsExcludedFromProvisioning $FALSE
When you have verified the target, this procedure will add mailboxes to the Mailbox Jobs:
If these mailboxes are scheduled to migrate at a future time, such as the start of a weekend, mailboxes will be migrated based on priority group when the future time begins. The smallest mailboxes within a priority group are migrated first.
If these mailboxes are scheduled to migrate immediately, the migration will begin as soon as the mailboxes are the highest priority in the migration queue, unless another mailbox is already being migrated (in which case this new migration will begin when the in-progress migration completes).
The Add mailboxes to migration queue dialog box displays:
The options in the Add mailboxes to migration queue dialog box:
A Blackout Profile must be created before it can be applied (see the Blackout Times View section below for information about this feature). The Default Blackout Profile is already applicable to all mailboxes and mailbox jobs.
When the settings in this Add mailboxes... dialog box appear as you want them, click Add to Migration Queue.
Within a few seconds, the selected mailboxes disappear from the Mailboxes view as they are moved into the Mailbox Jobs view. If a large number of databases then display in the selection window, you can reduce the size by clicking on the appropriate filter icon.
Migrator Pro for Exchange utilizes the New-MoveRequest PowerShell command to migrate mailboxes. The Microsoft Exchange Mailbox GUID value is used as the identity parameter.
A CSV file of mailbox migration jobs can be imported from the command line. See Appendix E for more information.
Permissions that are inherited (set at the Exchange Org\Server level) are not read from the source or migrated to the target mailbox.
To view the mailbox jobs, click the Mailbox Jobs button in the Main Toolbar.
Active migrations can be suspended when 95% complete by selecting Suspend when ready to complete option on the right-click menu. This option is not available for active migrations to Exchange 2013, Exchange 2016, Exchange 2019, or Microsoft Online (Office 365).
The menu options related to the mailboxes in the migration queue:
See Appendix J for information about how mailbox permissions are migrated.
To check the validity of a mailbox database as a target, you can run this PowerShell cmdlet:
If any return with a value of True, Migrator Pro for Exchange won’t use it as a target.
You can modify this with the PowerShell cmdlet:
… replacing MDBO1 with the name of your database.
The default view is set to Active; however, when you select the History tab on the Mailbox Jobs view, the data table displays different information as well as migrations that have already completed and are not Submitted, Scheduled, In Progress or Suspended.
As the migration proceeds, the status changes in the Status column from Scheduled to Submitted to Queued to Started to In Progress to Completed. If the migration job encounters an error, the status changes to Error or Suspended.
You can refer to the logs to understand the error and resolve it. A brief error message is displayed in the Error column.
Migration Status designations are:
Blackout profiles can be created to include blackout periods during which no mailboxes assigned to the selected blackout profile will be migrated, even though scheduled. Typically, blackout periods are set to correspond to the users’ working hours.
Setting up these blackout profiles gives the administrator the flexibility to keep scheduling migrations without disrupting users’ workflow and affecting the production server performance.
For more information about how blackout times are applied to forests, see the field notes for the Apply mailbox blackouts setting, in the forest-configuration General tabs (for source, target and tenant forests).
To set blackout times with blackout profiles:
You can also navigate to different dates, months, or years using the time navigation tool located in the right corner of the UI. The behavior of the tool changes to reflect your current format.
The calendar icon in the middle of the navigator lets you view a calendar where you can select a different date or even a month.
To start adding a blackout period, double-click a time or a day in the calendar depending on whether you are viewing a daily, weekly, or monthly calendar. If you are in the Timeline format, double-click in the cell just below the date.
The Appointment dialog box appears. Setting a blackout period is like setting up a meeting appointment in Outlook. It is a detailed Appointment setting tool making it a full-fledged free/busy scheduler. You can also categorize, color code, and assign priorities as well.
In the Appointment dialog box, specify what you would like to call these blackout periods, and provide a description in the Description field.
Specify a Start time and End time, or you can select the All day event checkbox if blackout is to be exercised the entire day.
If you wish to repeat this setting for other days, click the Edit recurrence tab to open the Appointment Recurrence dialog box:
And specify the recurrence pattern:
Click OK to save your recurrence pattern, and the Appointment dialog box reappears. Click Save & Close to save all the settings:
The blackout periods are set in the calendar as shown below.
The default blackout profile is initially applied to all user mailboxes. To set user mailboxes to a different blackout profile, select one or more mailboxes in the Mailboxes or Mailbox Jobs view and edit the Properties in the right-click menu.
Manually suspended migrations ignore blackout periods if they are manually resumed, and will begin migrating immediately.
Migrator Pro for Exchange provides the functionality to override blackouts which are in place, or migrations that have been scheduled for a future time. Once you have scheduled a blackout, or have scheduled users for a migration, the following type of information displays in the Mailbox Jobs view of the Admin Portal:
To override blackouts or future scheduled migrations: Select the user, then right-click and select Migrate now:
Use the Summary view when you want to find out the status of all migrations from all the sites:
You can sort and group these items based on the available attributes to create a view that will give you a clear picture of migration status on all the migration sites.