Applies to: Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2009-06-29

This topic lists the filterable properties for the -RecipientFilter parameter in Exchange 2007 Service Pack 1 (SP1) and Exchange 2007 Service Pack 2 (SP2). For information about the filterable properties for the -RecipientFilter parameter in the release to manufacturing (RTM) version of Exchange 2007, see Filterable Properties for the -RecipientFilter Parameter in Exchange 2007 RTM.

The -RecipientFilter parameter allows you to define the criteria to create custom dynamic distribution groups, e-mail address policies, address lists, or global address lists (GALs).

The following two tables in this topic outline the common filterable properties and the advanced filterable properties. Other properties, including any customer schema extensions, cannot be used in the -RecipientFilter parameter.

The -RecipientFilter parameter is used in the following cmdlets:

In many instances, a filterable property accepts the distinguished name (DN) or the globally unique identifier (GUID) of an object instead of the object's name. To locate the DN or the GUID of the object that you want to use in a recipient filter, use the corresponding Get- cmdlet.

For example, to locate the DN or GUID for a Microsoft Exchange ActiveSync mailbox policy named NewActiveSyncPolicy, run the following command:

	Copy Code
Get-ActiveSyncMailboxPolicy -Identity NewActiveSyncPolicy \| format-list DistinguishedName,GUID

You can then copy the DN or GUID and paste it into your recipient filter. For example, to use the DN to create a dynamic distribution group based on the Exchange ActiveSync mailbox policy, run the following command:

	Copy Code
New-DynamicDistributionGroup -Name NewDDG -RecipientFilter {(ActiveSyncMailboxPolicy -eq 'CN=Default,CN=Mobile Mailbox Policies,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=IELRVS-dom,DC=extest,DC=Contoso,DC=com')}

Copy Code

New-DynamicDistributionGroup -Name NewDDG -RecipientFilter {(ActiveSyncMailboxPolicy -eq 'CN=Default,CN=Mobile Mailbox Policies,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=IELRVS-dom,DC=extest,DC=Contoso,DC=com')}

Common Filterable Properties

The following table contains the common filterable properties for the -RecipientFilter parameter. This table lists the name of the property, the Lightweight Directory Access Protocol (LDAP) display name, a description of the property, and the possible values that the property can take. You can use the LDAP display name to convert your Microsoft Exchange Server 2003 or earlier LDAP filters into Exchange Server 2007 OPath filters. For more information about converting LDAP filters to Exchange 2007 OPath filters, see the Microsoft Exchange Team Blog article, Need help converting your LDAP filters to OPATH.

Note:
The content of each blog and its URL are subject to change without notice. The content within each blog is provided "AS IS" with no warranties, and confers no rights. Use of included script samples or code is subject to the terms specified in the Microsoft Terms of Use.

Note:
Not all filterable properties have an LDAP display name. The properties that do not have an LDAP display name are not Active Directory directory service properties. They are properties that are calculated by Exchange.

Note:
Many of the properties for the -RecipientFilter parameter accept wildcard characters. If you use a wildcard character, use the -like operator instead of the -eq operator. The -like operator is used to find pattern matches in rich types, such as strings, whereas the -eq operator is used to find an exact match.

Property name

LDAP display name

Description

Value

ActiveSyncMailboxPolicy

msExchMobileMailboxPolicyLink

This property contains the name of the Exchange ActiveSync mailbox policy for the mailbox.

Alias

mailNickname

This property contains the alias (the generic name used to identify a mail account) of the recipient.

String
Wildcard character accepted

AssistantName

msExchAssistantName

This property contains the assistant name of the recipient.

String
Wildcard character accepted

This property contains the two-letter country/region designation from International Organization for Standardization (ISO) 3166.

ISO 3166

Note:

For a complete list of the ISO 3166 standard values, see International Organization for Standardization.

Note:

The third-party Web site information in this topic is provided to help you find the technical information you need. The URLs are subject to change without notice.

City

This property contains the city name of the recipient.

String
Wildcard character accepted

This property contains the country/region name in which the recipient resides.

Country/Region
You can locate valid Co values on the Address and Phone tab in the recipient's properties.

Company

company

This property contains the company of the recipient.

String
Wildcard character accepted

CountryCode

This property contains the numeric country/region designation from ISO 3166.

ISO 3166

Note:

For a complete list of the ISO 3166 standard values, see International Organization for Standardization.

Note:

The third-party Web site information in this topic is provided to help you find the technical information you need. The URLs are subject to change without notice.

CountryOrRegion

Not applicable

This property contains the country or region in which the recipient resides.

Country/Region
You can locate valid CountryOrRegion values on the Address and Phone tab in the recipient's properties.

CustomAttribute1

extensionAttribute1