Filterable Properties for the -RecipientFilter Parameter in Exchange 2007 RTM

Filterable Properties for the -Reci...

Exchange 2007

Filterable Properties for the -RecipientFilter Parameter in Exchange 2007 RTM

Applies to: Exchange Server 2007 Topic Last Modified: 2008-04-16

This topic lists the filterable properties for the -RecipientFilter parameter in the release to manufacturing (RTM) version of Exchange Server 2007. For more information about the filterable properties of the -RecipientFilter parameter in Exchange 2007 SP1, see Filterable Properties for the -RecipientFilter Parameter in Exchange 2007 SP1.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 -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:

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:

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.

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.

CustomAttribute1

extensionAttribute1