How to setup MigrationWiz to migrate existing IMAP emails into Microsoft 365 Exchange mailboxes
This is step 6 as part of our complete series on migrating emails to Micosoft 365 Exchange Online. In this step we will be using a 3rd party service from MigrationWiz to migrate existing emails into the new Microsoft 365 Exchange Online mailboxes.
Whoever your email is currenrly with. (IONOS 123-Reg, IMAP etc) these steps will guide you all the way..
1. Go to BitTitan website and create a free account.
2. Select BitTitan MigrationWiz
3. Enter your details.
4. Click Create Account.
You will receive an email with details of finishing setting up your account.
5. Login to MigrationWiz
6. Click Create Project.
7. Click Mailbox Project.
8. Enter a Project Name for your migration project.
9. Click New, next to Customer.
10. For Primary Email Domain enter your domain name. eg. yourdomain.co.uk
11. Enter a company name.
12. The other fields are optional so can be left blank.
13. Click Save.
14. Click Next Step.
The other fields are optional so no there's no need to fill them in.
15. Click New for Source Settings.
16. Enter an Endpoint Name. eg. IONOS IMAP
17. Select an Endpoint Type. IMAP is the most common.
18. Enter Server Name, Server Port. If you don't know this information then do a Google search on "Server settings for company X email", where company x is your current email provider such as IONOS or 123-Reg. Select SSL if required.
19. Click Add.
20. Click Next Step.
21. Click New for EndPoint.
22. Enter an Endpoint Name. eg. M365
23. Select an Endpoint Type - Microsoft 365
24. Enter the Administrator username and password for your Microsoft 365 account.
25. Click Add.
26. Click Save And Go To Summary.
27. Click Save Project.
We have now entered the details for the source and destination mailboxes. We now need to add the email addresses you want to actually migrate.
For most users who are just migrating one or two email addresses the easiest option is to use Quick Add and add the details manually.
28. Click Quick Add.
29. Enter the source email address. ie. your email address which you want to migrate.
30. The username is usually the same as the email address.
31. Enter the password.
32. The Destination email address is usually the same as the source, because you are wanting to migrate your emails to the same email address.
33. Click Save Item and Close or Save Item and Add Another depending on whether you are just migrating one or more email accounts.
We now need to edit the project and put in some of the settings from Microsoft Entra, which we did in Step 5.
34. Click the Edit button next to your Project name.
35. Click Advanced.
36. Under the Support tab, click the + sign.
37. Enter ModernAuthClientIdImport=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
38. Click + again and enter ModernAuthTenantIdImport=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
where xxxx-xxxx is the client ID and Tenant ID values you copied into Notepad in Step 3.
39. Click Save.
40. Select the email address(es).
41. Click Start and then Verify Credentials.
This last step checks that all the details you have entered are valid and MigrationWizz will be able to start migrating your emails from your current email provider into your new Microsoft 365 Exchange Online account.
If you get the an error message about The account does not have permission to impersonate the requested user. Error: ErrorImpersonateUserDenied then you need to run some PowerShell commands to grant the required perrnissions.
How to resolve error on verifying credentials
42. Right mouse click Windows Start button and select Windows Powershell (Admin).
43. Run the following commands (in blue), one a a time.
Set-ExecutionPolicy Unrestricted
Select A to do Yes to All
$LiveCred = Get-Credential
Enter your new Microsoft 365 login details.
Install-Module -Name ExchangeOnlineManagement
Import-Module -Name ExchangeOnlineManagement
Connect-ExchangeOnline -ConnectionUri https://ps.outlook.com/powershell/ -Credential $LiveCred
Enable-OrganizationCustomization
The Enable-OrganizationCustomization command can take a long time to run so just leave it.
New-ManagementRoleAssignment -Role "ApplicationImpersonation" -User admin@domain.com
Replace admin@domain.com with the email address of the new Microsoft 365 account.
If you get an error message on the last command, similar to opposite, then wait for around 30 to 45 minutes and then try again. It should then complete successfully.
Write-ErrorMessage : |System.InvalidOperationException|You don't have access to create, change, or remove the"xxxxxx.onmicrosoft.comApplicationImpersonation-username" management role assignment. You must be assigned a delegating role assignment to the management role or its parent in the hierarchy without a scope restriction.
After running the PowerShell commands try running Verify Credentials again. If it works then you can proceed onto first stage migration.
44. Select account(s).
45. Go to Start and select Pre-Stage Migration.
46. Click Here to Purchase Licenses - MigrationWiz-Mailbox.
47. You will be taken to a new page to enter credit card details. Once complete you will be taken back to the page you were on.
48. Select time frame for Migration Scheduling. 30 days is standard.
49. Click Start Migration.
The migration will begin and start migrating emails from your current email system in to the new Microsoft 365 Exchange mailboxes.
How long it will take will be dependent on the size of your mailbox. A large mailbox that runs into several GB of emails can take several hours to run.
You will be able to monitor the progress of the migration.
Once the first stage migration is complete we can check whether it has worked by opening up Outlook Web Application in your web browser and you will be able to see lots of emails. The earliest emails you will see are 30 days or older. Check your inbox and sent items. Any sub folders you had will also be there.
50. In the Microsoft 365 Admin Center click the grid of dots in top left corner.
51. Open Outlook.
You should see lots of emails! Check the inbox, sent items and any other mail foders you had. It should look exactly as the same as your current IMAP email system.
The next step is to change DNS records so all new incoming and ougoing emails go through the new Microsoft 365 Exchange Online system. Just like in step 2 you will need to follow the steps according to who your domain registrar is (IONOS, 123-Reg etc).