#PSTip How to create a dynamic distribution group

Note: This tip requires PowerShell 2.0 or above.

One of the group types that Exchange can create is a dynamic distribution group. Unlike regular distribution groups that contain a defined set of members, the membership list for dynamic distribution groups is calculated each time a message is sent to the group, based on the filters and conditions that you define.  When an email message is sent to a dynamic distribution group, it is delivered to all recipients in the organization that match the criteria defined for that group.

To create a dynamic distribution group use the New-DynamicDistributionGroup cmdlet. This example creates a dynamic distribution that contains only mailbox users from the Users OU.

PS> New-DynamicDistributionGroup -IncludedRecipients MailboxUsers -Name MailboxUsersDDG -OrganizationalUnit Users

This example creates a dynamic distribution group, ITUsers, with a custom recipient filter. It contains all mailbox users from the Users OU who are members of the Computers department.

PS> $itUsers = New-DynamicDistributionGroup -Name ITUsers -RecipientFilter {RecipientType -eq 'UserMailbox' -and Department -eq 'Computers'} -OrganizationalUnit Users
PS> $itUsers | fl *filter

RecipientFilter     : ((((RecipientType -eq 'UserMailbox') -and (Department -eq 'Computers'))) -and (-not(Name -like 'S
                      ystemMailbox{*')) -and (-not(Name -like 'CAS_{*')) -and (-not(RecipientTypeDetailsValue -eq 'Mail
                      boxPlan')) -and (-not(RecipientTypeDetailsValue -eq 'DiscoveryMailbox')) -and (-not(RecipientType
                      DetailsValue -eq 'ArbitrationMailbox')))
LdapRecipientFilter : (&(objectClass=user)(objectCategory=person)(mailNickname=*)(msExchHomeServerName=*)(department=Co
                      mputers)(!(name=SystemMailbox{*))(!(name=CAS_{*))(!(msExchRecipientTypeDetails=16777216))(!(msExc
                      hRecipientTypeDetails=536870912))(!(msExchRecipientTypeDetails=8388608)))

In the next tip we will see how to list the members of the dynamic distribution group. Stay tuned.

About the author: Shay Levy

Shay Levy is a Co-founder and editor of the PowerShell Magazine. He is a multiple-year recipient of the Microsoft MVP award, and a Microsoft Certified Trainer (MCT). Shay often covers PowerShell related topics on his blog and you can also follow him on Twitter at @ShayLevy

Related Posts

%d bloggers like this: