How to Upgrade Default Address Lists from LDAP Filters to OPATH Filters

Exchange 2007

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.


Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Topic Last Modified: 2011-10-03

In Microsoft Exchange Server 2003 and earlier versions, Lightweight Directory Access Protocol (LDAP) filtering syntax is used when customizing default address lists (which are created during an Exchange installation). However, in Microsoft Exchange Server 2007, 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.

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

The following default address lists may need to be upgraded:

  • All Users

  • All Groups

  • All Contacts

  • Public Folders

  • Default Global Address List

The All Rooms address list is an Exchange 2007 default address list and does not require upgrading.

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

To perform this procedure, the account you use must be delegated the following:

  • Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

Also, before you perform this procedure, be aware that the -ForceUpgrade parameter does not construct the replacement recipient filter for the object, nor does it upgrade the object. The -ForceUpgrade parameter suppresses the confirmation question so that you can upgrade by using an unattended script.

  • To upgrade the All Users default address list, run the following command:

    Set-AddressList "All Users" -IncludedRecipients MailboxUsers
  • To upgrade the All Groups default address list, run the following command:

    Set-AddressList "All Groups" -IncludedRecipients MailGroups
  • To upgrade the All Contacts default address list, run the following command:

    Set-AddressList "All Contacts" -IncludedRecipients MailContacts
  • To upgrade the Public Folders default address list, run the following command:

    Set-AddressList "Public Folders" -RecipientFilter { RecipientType -eq 'PublicFolder' }
  • To upgrade the Default Global Address List, run the following command:

    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'))}
  • You are prompted to confirm that you want to perform this action. Type Y to confirm.

For detailed syntax and parameter information, see the following topics:

To learn more about OPATH filtering, see Creating Filters in Recipient Commands.

To learn more about address lists, see Understanding Address Lists.

For more information about how to manage address lists, see Managing Address Lists.

For more information about how to manage global address lists, see Managing Global Address Lists.


Community Additions