Create Dynamic Distribution Groups Using Precanned Filters

  • Article

Applies to: Office 365 for enterprises, Live@edu

Use precanned filters to create dynamic distribution groups when the attributes that you want to use are available with the IncludedRecipients parameter. For example, if you create a dynamic distribution group that filters on the Department and State/Province attributes, messages sent to this group are delivered only to user accounts that have those attributes.

If you want to create dynamic distribution group based on attributes that aren't available with the IncludedRecipients parameter, such as the Title attribute, or if you want to use wildcard matches, you have to use a customized filter. Here's how: Create Dynamic Distribution Groups Using Customized Filters.

You create and modify dynamic distribution groups using Windows PowerShell.

Before you begin

To learn how to install and configure Windows PowerShell and connect to the service, see Use Windows PowerShell in Exchange Online.

To use a precanned filter to create a new dynamic distribution group

Run the following command:

New-DynamicDistributionGroup -Name <group name> -IncludedRecipients <value> <precanned filter attributes>

Example Here's a command that uses a precanned filter to create a new dynamic distribution group named "Washington Sales and Marketing". A message sent to this dynamic distribution group will be delivered to all user accounts in the Marketing or Sales departments located in Washington state:

New-DynamicDistributionGroup -Name "Washington Sales and Marketing" -IncludedRecipients MailboxUsers -ConditionalDepartment Sales,Marketing -ConditionalStateOrProvince Washington

Did you know?

Here are the filterable attributes used with precanned filters.

Note   When you specify a filterable attribute, the values aren't case-sensitive. If you specify values that contain spaces, enclose each value in double quotation marks. When multiple values of the same attribute are separated by commas, the OR operator is used. Wildcards and partial matches aren't supported. When multiple attributes are specified, the AND operator is used.

Parameter name Required Description

IncludedRecipients

Required

This parameter filters recipients based on recipient type. The available values are:

  • AllRecipients
  • MailboxUsers
  • MailContacts
  • MailGroups
  • MailUsers
  • Resources
  • None

The AllRecipients value can only be used by itself.

ConditionalCompany

Optional

This parameter filters recipients based on the Company attribute.

ConditionalCustomAttributeN where N is an integer from 1 through 15.

Optional

This parameter filters recipients based on the Custom Attribute N property where N is an integer from 1 through 15. The Custom Attribute N properties aren't visible in the Exchange Control Panel.

ConditionalDepartment

Optional

This parameter filters recipients based on the Department attribute.

ConditionalStateOrProvince

Optional

This parameter filters recipients based on the State/Province attribute.