Hybrid Configuration Wizard Fails To Update Default Address Policy

You never know what your going to get when working with an existing on premise Exchange environment. That’s one of the reasons I love my job as much as I do; every organization is different.

While recently preparing to migrate a client from Exchange 2010 to Office 365 via hybrid, I found they had a previous Exchange 2007 implementation. Better yet, I also found they migrated to Exchange 2007 from Exchange 2003. The client was unaware. Given they had taken over for another IT admin who left in a cloud of dust, anyone would be in the same boat. And the decommission of the legacy Exchange server(s) was neglected until now.

These legacy environments became apparent when the hybrid configuration wizard (HCW) failed while attempting to update the email address policies. The hybrid config log was littered with warnings similar to this…

Warning: The Legacy Email Address Policy 'POLICY_NAME' cannot be automatically updated and must be manually upgraded.


Sure enough, when the email address policies were accessed from the Exchange Management Console (EMC) we received an error.

Email Address Policy Legacy Error


Using the following command, each of the email address policies showed a “legacy” value for the RecipientFilterType parameter…

Get-EmailAddressPolicy | ft Name,RecipientFilterType

RecipientFilterType Legacy


I was able to update all but one of the legacy email address policies and address lists by running the following commands in the Exchange 2010 EMS…

Get-EmailAddressPolicy | Set-EmailAddressPolicy -IncludedRecipients AllRecipients
Set-GlobalAddressList "Default Global Address List" -RecipientFilter {(Alias -ne $null -and (ObjectClass -eq 'user' -or ObjectClass -eq 'contact' -or ObjectClass -eq 'msExchSystemMailbox' -or ObjectClass -eq 'msExchDynamicDistributionList' -or ObjectClass -eq 'group' -or ObjectClass -eq 'publicFolder'))}
Set-AddressList "All Users" –IncludedRecipients MailboxUsers
Set-AddressList "All Groups" –IncludedRecipients Mailgroups
Set-AddressList "All Contacts" –IncludedRecipients MailContacts
Set-AddressList "Public Folders" -RecipientFilter {RecipientType -eq "PublicFolder"}


There was one stubborn email address policy required a bit more persuasion. After applying resolution related to Issue #2 in this article by Joe Palarchio, the email address policy was able to be upgraded. And all of the email address policies showed the expected value (“Precanned”) for the RecipientFilterType parameter.

RecipientFilterType Precanned


Once all of the email address polices were updated (and accessible through the EMC without error), the HCW was re-run and able to complete successfully.



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 )

Google photo

You are commenting using your Google 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 )

Connecting to %s