You shouldn‎’t migrate mailbox to Exchange 2010 or an earlier version while the user‎’s Instant Messaging contact list is stored in Exchange

If you happen to be off-boarding mailboxes from Office 365 Exchange Online (ExO), you could encounter the following error in the ExO EAC when migrating a mailbox back to an on premise Exchange 2010 or older environment…

Error: MigrationPermanentException: You shouldn‎'t migrate mailbox ‎'User3‎' to Exchange 2010 or an earlier version while the user‎'s Instant Messaging contact list is stored in Exchange. If you do, the user could permanently lose access to their Instant Messaging contact list, which will cause serious data loss. The Exchange copy might be the only copy of this user‎'s contact list. To continue, please contact your Instant Messaging administrator and make sure that the user‎'s contact list is moved back to the Instant Messaging server. After this has been done, you should be able to complete this migration. If you must migrate the mailbox despite the potential data loss, you can do so by running ‎'Set-Mailbox mailboxID -ImListMigrationCompleted $false‎'. --> You shouldn‎'t migrate mailbox ‎'User3‎' to Exchange 2010 or an earlier version while the user‎'s Instant Messaging contact list is stored in Exchange. If you do, the user could permanently lose access to their Instant Messaging contact list, which will cause serious data loss. The Exchange copy might be the only copy of this user‎'s contact list. To continue, please contact your Instant Messaging administrator and make sure that the user‎'s contact list is moved back to the Instant Messaging server. After this has been done, you should be able to complete this migration. If you must migrate the mailbox despite the potential data loss, you can do so by running ‎'Set-Mailbox mailboxID -ImListMigrationCompleted $false‎'.

To address this issue, connect to your Office 365 tenant via Azure AD Module for PowerShell and then run the following command to list the affected mailboxes with the ImListMigrationCompleted value set to ‘True‘…

PS C:\> Get-Mailbox | ft -auto name,*imlist*

Name              ImListMigrationCompleted
----              ------------------------
Admin                                False
User1                                False
User2                                False
User3                                 True

The parameter ImListMigrationCompleted for the mailboxes being migrated back on premise must be set to ‘False‘ to allow ExO to begin to migrate the affected mailbox.  The following command will set the value to ‘False’ for an individual ExO mailbox so you can resume the migration…

Set-Mailbox User3@myemaildomain.com -ImListMigrationCompleted $false

If you need to set the value for all ExO mailboxes, run this command…

Get-Mailbox | Set-Mailbox -ImListMigrationCompleted $false

Check to see if the command ran correctly and set the ImListMigrationCompleted value to ‘False‘…

PS C:\> Get-Mailbox | ft -auto name,*imlist*

Name              ImListMigrationCompleted
----              ------------------------
Admin                                False
User1                                False
User2                                False
User3                                False

With the ImListMigrationCompleted parameter value on the offending ExO mailboxes set with the correct value, resume the migration batch to complete the off-boarding of mailboxes back on premise.

Reference(s): “MigrationPermanentException” error when you move a mailbox from Exchange Online to an on-premises Exchange 2010 server in a hybrid deployment

Have fun!

Advertisements

2 thoughts on “You shouldn‎’t migrate mailbox to Exchange 2010 or an earlier version while the user‎’s Instant Messaging contact list is stored in Exchange

  1. I am having the same error but while trying to runt the set-mailbox command I am getting error “A parameter cannot be found that matches parameter name ‘ImListMigrationCompleted’.
    + CategoryInfo : InvalidArgument: (:) [Set-Mailbox], ParameterBindingException” please help

    • Are you running the commands from the Azure AD PowerShell module after connecting to your Office 365 tenant?

      FYI…The ‘ImListMigrationCompleted’ parameter does not exist in Exchange 2010 but does in ExO and 2013.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s