Share via

Upgrade Default Address Lists from LDAP Filters to OPATH Filters

  • Article

Applies to: Exchange Server 2010

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.

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.

Set-AddressList "All Users" -IncludedRecipients MailboxUsers

This example upgrades the All Groups default address list.

Set-AddressList "All Groups" -IncludedRecipients MailGroups

This example upgrades the All Contacts default address list.

Set-AddressList "All Contacts" -IncludedRecipients MailContacts

This example upgrades the Public Folders default address list.

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

This example upgrades the Default Global Address List.

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