Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2008-01-30

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 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.

Note:
LDAP syntax filters are supported in Exchange 2007 and 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:

Note:
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.

Before You Begin

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 Server 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.

Procedure

To use the Exchange Management Shell to upgrade the filtering syntax of default address lists from LDAP to OPATH

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

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

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

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

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

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

  • To upgrade the Public Folders default address list, run the following command:

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

  • To upgrade the Default Global Address List, run the following command:

    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 are sure you want to perform this action. Type Y to confirm.

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

For More Information

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.