Upgrade Default Address Lists from LDAP Filters to OPATH Filters

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2011-06-16

In Microsoft Exchange Server 2003 and earlier versions, LDAP filtering syntax is used when customizing default address lists (which are created during an Exchange installation). However, in Exchange Server 2010, the OPATH filtering syntax replaces the LDAP filtering syntax. This topic explains how to use the Exchange Management Shell to upgrade the filtering syntax for any legacy default address lists from LDAP to OPATH.

Note:
LDAP syntax filters are supported in Exchange 2010 and will exist only on objects that have been migrated from Exchange 2003 or earlier versions. You must upgrade these LDAP filters to the OPATH syntax only if you want to edit the filter from an Exchange 2010 server. For example, if you have Exchange 2003 servers in your organization, you can manage the LDAP syntax filter from an Exchange 2003 server. You can't manage or create LDAP syntax filters in Exchange 2010.

Note:

LDAP syntax filters are supported in Exchange 2010 and will exist only on objects that have been migrated from Exchange 2003 or earlier versions. You must upgrade these LDAP filters to the OPATH syntax only if you want to edit the filter from an Exchange 2010 server. For example, if you have Exchange 2003 servers in your organization, you can manage the LDAP syntax filter from an Exchange 2003 server. You can't manage or create LDAP syntax filters in Exchange 2010.

The following default address lists may need to be upgraded:

All Users
All Groups
All Contacts
Public Folders
Default Global Address List

Note:
The All Rooms address list is an Exchange 2010 default address list and doesn't require upgrading.

For more information about how to determine if your address lists require upgrading, see "Determining Which Objects Require Upgrading" in Upgrade Custom LDAP Filters to OPATH Filters.

Use the Shell to upgrade default recipient filters

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Address lists" and "Global address lists" entries in the Mailbox Permissions topic.

Note:
You can't use the EMC to upgrade default recipient filters.

This example upgrades the All Users default address list.

	Copy Code
Set-AddressList "All Users" -IncludedRecipients MailboxUsers

This example upgrades the All Groups default address list.

	Copy Code
Set-AddressList "All Groups" -IncludedRecipients MailGroups

This example upgrades the All Contacts default address list.

	Copy Code
Set-AddressList "All Contacts" -IncludedRecipients MailContacts

This example upgrades the Public Folders default address list.

	Copy Code
Set-AddressList "Public Folders" -RecipientFilter { RecipientType -eq 'PublicFolder' }

This example upgrades the Default Global Address List.

	Copy Code
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'))}

Copy Code

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'))}

A warning appears asking if you're sure you want to perform this action. Type Y to confirm.

For detailed syntax and parameter information, see Set-AddressList or Set-GlobalAddressList