How to Upgrade the Default E-Mail Address Policy from LDAP Filters to OPATH Filters

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

In Microsoft Exchange Server 2003 and earlier versions, Lightweight Directory Access Protocol (LDAP) filtering syntax is used when customizing the default e-mail address policy. 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 from LDAP to OPATH for the legacy default e-mail address policy.

There is only one default e-mail address policy (named Default Policy) in your organization. The default e-mail address policy can be identified by having the priority value of "lowest."

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.

For more information about how to determine if the default e-mail address policy requires 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 the default e-mail address policy from LDAP to OPATH

  1. Run the following command:

    Set-EmailAddressPolicy "Default Policy" -IncludedRecipients AllRecipients
    
  2. 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 reference topics:

For More Information

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

To learn more about e-mail address policies, see Understanding E-Mail Address Policies.

For more information about how to manage e-mail address policies, see Managing E-Mail Address Policies.