Tip: Use Cmdlets to Modify Dynamic Distribution Groups

In the Exchange Management Shell, you can modify the filters and conditions associated with a dynamic distribution group using the Set-DynamicDistribution-Group cmdlet. This cmdlet has several other uses as well. You can use it to:

  • Specify a dedicated expansion server to enhance query processing. Set the –ExpansionServer parameter to the identity of the Global Catalog server to use.
  • Upgrade dynamic distribution groups created for Exchange 2003 and Exchange 2000 to allow incompatible dynamic distribution groups to be rewritten to work with Exchange Server 2007. Set –ForceUpgrade $true, and then modify any incompatible included recipients or recipient filters as necessary.

Tips RSS Feed

Subscribe to the TechNet Magazine Tips RSS feed.

The following demonstrates the the syntax and usage for the Set-DynamicDistributionGroup cmdlet.

Set-DynamicDistributionGroup -Identity 'GroupIdentity'
[-Alias 'NewAlias']
[-AcceptMessagesOnlyFrom 'Recipient']
[-AcceptMessagesOnlyFromDLMembers 'Recipient']
[-ConditionalCompany 'Values'] [-ConditionalDepartment 'Values']
[-ConditionalStateOrProvince 'Values'] [-DisplayName 'Name']
[-DisplayName 'Name'] [-DomainController 'DCName']
[-EmailAddresses 'ProxyAddress']
[-EmailAddressPolicyEnabled <$false|$true>]
[-ExpansionServer 'Server'] [-ForceUpgrade <$false|$true>]
[-GrantSendOnBehalfTo 'Mailbox']
[-HiddenFromAddressListsEnabled <$false|$true>]
[-IncludedRecipients 'Recipients'] [-ManagedBy 'RecipientId']
[-MaxReceiveSize 'Size'] [-MaxSendSize 'Size']
[-Name 'Name'] [-Notes 'Value'] [-PrimarySmtpAddress 'SmtpAddress']
[–RecipientContainer 'OUName'] [–RecipientFilter 'String']
[-RejectMessagesFrom 'Recipient']
[-RejectMessagesFromDLMembers 'Recipient']
[-ReportToManagerEnabled <$false|$true>]
[-ReportToOriginatorEnabled <$false|$true>]
[-RequireSenderAuthenticationEnabled <$false|$true>]
[-SendOofMessageToOriginatorEnabled <$false|$true>]
[-SimpleDisplayName 'Name'] [-WindowsEmailAddress 'SmtpAddress']

Usage Example 1

Set-DynamicDistributionGroup –Identity 'cpandl.com/Users/CrossSales'
-IncludedRecipients 'Recipients'
-ConditionalCompany 'City Power $ Light'
-ConditionalDepartment 'Sales','Accounting'
-ConditionalStateOrProvince 'Washington','Idaho','Oregon'
-RecipientContainer 'cpandl.com'

Usage Example 2

Set-DynamicDistributionGroup –Identity 'cpandl.com/Users/CrossSales'
–ForceUpgrade $true

Usage Example 3

Set-DynamicDistributionGroup –Identity 'cpandl.com/Users/CrossSales'
–ExpansionServer 'CorpSvr127'

From the Microsoft Press book Microsoft Exchange Server 2007 Administrator’s Pocket Consultant, Second Edition by William R. Stanek.

Looking for More Tips?

For more Exchange Server tips, visit the TechNet Magazine Exchange Server 2007 Tips page.

For more Tips on other products, visit the TechNet Magazine Tips index.