Set-DynamicDistributionGroup
Applies to: Exchange Server 2013
Important: |
|---|
This topic no longer applies to the cloud-based service. It applies only to on-premises Exchange 2013. To see the current version of the topic that applies to the cloud-based service, change the (v=exchg.150) value in the URL to (v=exchg.160).
|
Use the Set-DynamicDistributionGroup cmdlet to modify the settings of an existing dynamic distribution group.
For information about the parameter sets in the Syntax section below, see Syntax.
Set-DynamicDistributionGroup -Identity <DynamicGroupIdParameter> [-AcceptMessagesOnlyFrom <MultiValuedProperty>] [-AcceptMessagesOnlyFromDLMembers <MultiValuedProperty>] [-AcceptMessagesOnlyFromSendersOrMembers <MultiValuedProperty>] [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-BypassModerationFromSendersOrMembers <MultiValuedProperty>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-ExtensionCustomAttribute1 <MultiValuedProperty>] [-ExtensionCustomAttribute2 <MultiValuedProperty>] [-ExtensionCustomAttribute3 <MultiValuedProperty>] [-ExtensionCustomAttribute4 <MultiValuedProperty>] [-ExtensionCustomAttribute5 <MultiValuedProperty>] [-ForceUpgrade <SwitchParameter>] [-GrantSendOnBehalfTo <MultiValuedProperty>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-IncludedRecipients <None | MailboxUsers | Resources | MailContacts | MailGroups | MailUsers | AllRecipients>] [-MailTip <String>] [-MailTipTranslations <MultiValuedProperty>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-RejectMessagesFrom <MultiValuedProperty>] [-RejectMessagesFromDLMembers <MultiValuedProperty>] [-RejectMessagesFromSendersOrMembers <MultiValuedProperty>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SendModerationNotifications <Never | Internal | Always>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
This example applies the following changes to the existing dynamic distribution group Developers:
-
Change the
ConditionalCompanyquery filter toContoso. -
Change the
IncludedRecipientsquery filter toMailboxUsers. -
Add the value
Internalto theConditionalCustomAttribute1attribute.
Set-DynamicDistributionGroup -Identity "Developers" -ConditionalCompany "Contoso" -IncludedRecipients MailboxUsers -ConditionalCustomAttribute1 "Internal"
A dynamic distribution group queries Active Directory mail-enabled objects and builds the group membership based on the results. The group membership is recalculated whenever an email message is sent to a group. You can use the Set-DynamicDistributionGroup cmdlet to overwrite existing settings or to add new settings.
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Dynamic distribution groups" entry in the Recipients Permissions topic.
| Parameter | Required | Type | Description | ||
|---|---|---|---|---|---|
| Identity | Required | Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter | The Identity parameter specifies the object that you want to modify. This parameter accepts the following values:
| ||
| AcceptMessagesOnlyFrom | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The AcceptMessagesOnlyFrom parameter specifies the mailbox users, mail users, and mail contacts that can send email messages to this dynamic distribution group. You can also specify Microsoft Exchange as a valid recipient for this parameter. If you configure a dynamic distribution group to accept messages only from the Microsoft Exchange recipient, the dynamic distribution group only receives system-generated messages. This parameter accepts the following values:
By default, this parameter is blank, which enables the dynamic distribution group to accept messages from all senders. | ||
| AcceptMessagesOnlyFromDLMembers | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The AcceptMessagesOnlyFromDLMembers parameter specifies the distribution groups whose members are allowed to send email messages to this dynamic distribution group. This parameter accepts the following values:
By default, this parameter is blank, which enables the dynamic distribution group to accept messages from all senders. | ||
| AcceptMessagesOnlyFromSendersOrMembers | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The AcceptMessagesOnlyFromSendersOrMembers parameter specifies the recipients who can send email messages to this dynamic distribution group. You can specify users, contacts, or distribution groups. If you specify a distribution group, messages are accepted from all recipients that are members of that distribution group. You can also specify Microsoft Exchange as a valid recipient for this parameter. If you configure a distribution group to accept messages only from the Microsoft Exchange recipient, the dynamic distribution group only receives system-generated messages. This parameter accepts the following values:
By default, the value of this parameter is blank, which enables the distribution group to accept messages from all senders. This parameter can't be used in conjunction with the AcceptMessagesOnlyFrom or AcceptMessagesOnlyFromDLMembers parameters. | ||
| Alias | Optional | System.String | The Alias parameter specifies the alias of the object. The value of the Alias parameter can't contain spaces. | ||
| ArbitrationMailbox | Optional | Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter | This parameter is available only in on-premises Exchange 2013. The ArbitrationMailbox parameter specifies the mailbox used to manage the moderation process. This parameter accepts the following values:
| ||
| BypassModerationFromSendersOrMembers | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The BypassModerationFromSendersOrMembers parameter specifies the list of senders for whom moderation is bypassed. You can specify users or distribution groups. If you specify a distribution group, the moderation is bypassed for all recipients that are members of that distribution group. Separate multiple values with a comma. This parameter accepts the following values:
| ||
| ConditionalCompany | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCompany parameter filters the mailbox users or mail-enabled contacts used to build the dynamic distribution group. When multiple values of the ConditionalCompany parameter are separated by commas, the OR Boolean operator is applied. You must use the IncludedRecipients parameter if you use a Conditional parameter. You can't use this parameter if you use the RecipientFilter parameter. | ||
| ConditionalCustomAttribute1 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute10 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute11 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute12 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute13 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute14 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute15 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute2 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute3 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute4 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute5 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute6 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute7 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute8 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalCustomAttribute9 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalCustomAttribute1 to ConditionalCustomAttribute15 parameters specify filters for recipients' custom attributes. For example, if you set the ConditionalCustomAttribute1 value to | ||
| ConditionalDepartment | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalDepartment parameter filters the mailbox users or mail-enabled contacts used to build the dynamic distribution group. When multiple values of the ConditionalDepartment parameter are separated by commas, the OR Boolean operator is applied. You must use the IncludedRecipients parameter if you use a Conditional parameter. You can't use this parameter if you use the RecipientFilter parameter. | ||
| ConditionalStateOrProvince | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ConditionalStateOrProvince parameter filters the mailbox users or mail-enabled contacts used to build the dynamic distribution group. When multiple values of the ConditionalStateOrProvince parameter are separated by commas, the OR Boolean operator is applied. You must use the IncludedRecipients parameter if you use a Conditional parameter. You can't use this parameter if you use the RecipientFilter parameter. | ||
| Confirm | Optional | System.Management.Automation.SwitchParameter | The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch. | ||
| CreateDTMFMap | Optional | System.Boolean | The CreateDTMFMap parameter specifies that a dual-tone multiple-frequency (DTMF) map be created for the dynamic distribution group. | ||
| CustomAttribute1 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute10 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute11 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute12 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute13 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute14 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute15 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute2 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute3 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute4 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute5 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute6 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute7 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute8 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| CustomAttribute9 | Optional | System.String | The CustomAttribute1 to CustomAttribute15 parameters specify custom attributes. You can use these attributes to store additional information. | ||
| DisplayName | Optional | System.String | The DisplayName parameter specifies the name of the distribution group in the Exchange Administration Center and in the Exchange global address list (GAL). | ||
| DomainController | Optional | Microsoft.Exchange.Data.Fqdn | This parameter is available only in on-premises Exchange 2013. The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory. | ||
| EmailAddresses | Optional | Microsoft.Exchange.Data.ProxyAddressCollection | The EmailAddresses parameter specifies the email addresses of the distribution group. All Microsoft Exchange email address types are valid. You can specify multiple values for the EmailAddresses parameter. Separate multiple values by using commas.
| ||
| EmailAddressPolicyEnabled | Optional | System.Boolean | This parameter is available only in on-premises Exchange 2013. The EmailAddressPolicyEnabled parameter specifies the application of email address policies to this dynamic distribution group. Valid values are | ||
| ExpansionServer | Optional | System.String | This parameter is available only in on-premises Exchange 2013. The ExpansionServer parameter specifies the Exchange server used to expand the distribution group. Enter the expansion server as a | ||
| ExtensionCustomAttribute1 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ExtensionCustomAttribute1-5 parameters specify custom attributes that store additional information. You can specify multiple values for these parameters as a comma delimited list. Each ExtensionCustomAttribute parameter can hold up to 1,300 values. For more information about custom attributes, see Custom attributes. For more information about using multivalued properties, see Modifying multivalued properties. | ||
| ExtensionCustomAttribute2 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ExtensionCustomAttribute1-5 parameters specify custom attributes that store additional information. You can specify multiple values for these parameters as a comma delimited list. Each ExtensionCustomAttribute parameter can hold up to 1,300 values. For more information about custom attributes, see Custom attributes. For more information about using multivalued properties, see Modifying multivalued properties. | ||
| ExtensionCustomAttribute3 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ExtensionCustomAttribute1-5 parameters specify custom attributes that store additional information. You can specify multiple values for these parameters as a comma delimited list. Each ExtensionCustomAttribute parameter can hold up to 1,300 values. For more information about custom attributes, see Custom attributes. For more information about using multivalued properties, see Modifying multivalued properties. | ||
| ExtensionCustomAttribute4 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ExtensionCustomAttribute1-5 parameters specify custom attributes that store additional information. You can specify multiple values for these parameters as a comma delimited list. Each ExtensionCustomAttribute parameter can hold up to 1,300 values. For more information about custom attributes, see Custom attributes. For more information about using multivalued properties, see Modifying multivalued properties. | ||
| ExtensionCustomAttribute5 | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ExtensionCustomAttribute1-5 parameters specify custom attributes that store additional information. You can specify multiple values for these parameters as a comma delimited list. Each ExtensionCustomAttribute parameter can hold up to 1,300 values. For more information about custom attributes, see Custom attributes. For more information about using multivalued properties, see Modifying multivalued properties. | ||
| ForceUpgrade | Optional | System.Management.Automation.SwitchParameter | The ForceUpgrade parameter specifies whether to suppress the following confirmation: "To save changes on object, the object must be upgraded to the current Exchange version. After upgrade, this object cannot be managed by a previous version of Exchange System Manager. Do you want to continue to upgrade and save the object?" This confirmation occurs when you upgrade a dynamic distribution group that was created in Microsoft Exchange Server 2003. You can't manage an Exchange 2003 dynamic distribution group by using the Exchange Administration Center until you update the object's version and change the recipient filter by using either the RecipientFilter or IncludedRecipients parameters. | ||
| GrantSendOnBehalfTo | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The GrantSendOnBehalfTo parameter specifies a mailbox user who can send on behalf of this dynamic distribution group. This parameter accepts the following values:
By default, the GrantSendOnBehalfTo parameter is blank, which means that no other mailbox user has permission to send on behalf of this distribution group. | ||
| HiddenFromAddressListsEnabled | Optional | System.Boolean | The HiddenFromAddressListsEnabled parameter specifies whether to hide the distribution group from any Exchange address lists. Valid values are | ||
| IgnoreDefaultScope | Optional | System.Management.Automation.SwitchParameter | This parameter is available only in on-premises Exchange 2013. The IgnoreDefaultScope parameter instructs the command to ignore the default recipient scope setting for the Exchange Management Shell session and use the entire forest as the scope. This allows the command to access Active Directory objects that aren't currently in the default scope. Using the IgnoreDefaultScope parameter introduces the following restrictions:
| ||
| IncludedRecipients | Optional | Microsoft.Exchange.Data.Directory.Recipient.WellKnownRecipientType | The IncludedRecipients parameter filters the recipient types used to build the dynamic distribution group. The available values for the IncludedRecipients parameter are:
The | ||
| MailTip | Optional | System.String | The MailTip parameter specifies the message displayed to senders when they start drafting an email message to this dynamic distribution group. The MailTip parameter message must be less than or equal to 250 characters. | ||
| MailTipTranslations | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The MailTipTranslations parameter specifies additional languages when you want to provide the MailTip parameter information for this recipient in multiple languages. For each language, you must provide the locale, followed by a colon and the specific MailTip parameter message in that language. Each MailTip parameter message must be less than or equal to 250 characters. Multiple languages can be separated by commas. | ||
| ManagedBy | Optional | Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter | The ManagedBy parameter specifies the name of the mailbox user, mail-enabled group, or mail-enabled contact that appears on the Managed by tab of the Active Directory object. This parameter accepts the following values:
| ||
| MaxReceiveSize | Optional | Microsoft.Exchange.Data.Unlimited | This parameter is available only in on-premises Exchange 2013. The MaxReceiveSize parameter specifies the maximum allowed email message size that can be sent to this distribution group. When you enter a value, qualify the value with one of the following units:
Unqualified values are treated as bytes. Valid values are from 0 through 2147482624 bytes. By default, the MaxReceiveSize parameter is set to | ||
| MaxSendSize | Optional | Microsoft.Exchange.Data.Unlimited | This parameter is available only in on-premises Exchange 2013. The MaxSendSize parameter specifies the maximum allowed email message size that can be sent from this distribution group. When you enter a value, qualify the value with one of the following units:
Unqualified values are treated as bytes. Valid values are from 0 through 2147482624 bytes. By default, the MaxSendSize parameter is set to | ||
| ModeratedBy | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The ModeratedBy parameter specifies the users who are responsible for moderating the messages sent to this dynamic distribution group. To designate more than one user, separate the users with commas. This parameter is required if you set the ModerationEnabled parameter to | ||
| ModerationEnabled | Optional | System.Boolean | The ModerationEnabled parameter specifies whether to enable moderation for the dynamic distribution group. To enable moderation, set this parameter to The default value is | ||
| Name | Optional | System.String | The Name parameter specifies the name of the dynamic distribution group. The Name parameter specifies the distribution group name in Active Directory Users and Computers. | ||
| Notes | Optional | System.String | The Notes parameter specifies comments about the distribution group. | ||
| PhoneticDisplayName | Optional | System.String | The PhoneticDisplayName parameter specifies a phonetic pronunciation of the DisplayName parameter. The maximum length of this parameter value is 255 characters. | ||
| PrimarySmtpAddress | Optional | Microsoft.Exchange.Data.SmtpAddress | The PrimarySmtpAddress parameter specifies the primary return SMTP email address for the distribution group. This parameter has meaning only if the distribution group has multiple SMTP email addresses. | ||
| RecipientContainer | Optional | Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter | The RecipientContainer parameter filters the recipients used to build the dynamic distribution group based on their location in Active Directory. The value of the RecipientContainer parameter can be the canonical name of an organizational unit (OU) or a domain. If a value for the RecipientContainer parameter isn't specified, the cmdlet will default to use the local container. Note that the RecipientContainer property can't be blank. The group is always limited to looking for recipients in a specific location (the value you specify for this parameter, or the location where the group was created). | ||
| RecipientFilter | Optional | System.String | The RecipientFilter parameter filters the mail-enabled recipients used to build the dynamic distribution group. The RecipientFilter parameter can't be used if any of the following parameters are specified:
The RecipientFilter parameter uses The RecipientFilter parameter can use any combination of the following object types as filters:
| ||
| RejectMessagesFrom | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The RejectMessagesFrom parameter specifies mailbox users and mail-enabled contacts that aren't allowed to send email messages to this distribution group. This parameter accepts the following values:
By default, this parameter is blank, which enables the distribution group to accept messages from all mailbox users and all mail-enabled contacts. | ||
| RejectMessagesFromDLMembers | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The RejectMessagesFromDLMembers parameter specifies the distribution groups who aren't allowed to send email messages to the distribution group. This parameter accepts the following values:
By default, this parameter is blank, which enables the distribution group to accept messages from all distribution groups. | ||
| RejectMessagesFromSendersOrMembers | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The RejectMessagesFromSendersOrMembers parameter specifies the recipients who aren't allowed to send email messages to this distribution group. You can specify users, contacts, or distribution groups. If you specify a distribution group, messages from any recipient that's a member of that distribution group is rejected. This parameter accepts the following values:
By default, the value of this parameter is blank, which enables the distribution group to accept messages from all senders. | ||
| ReportToManagerEnabled | Optional | System.Boolean | The ReportToManagerEnabled parameter specifies whether to enable delivery reports to be sent to the distribution group manager. Valid values are | ||
| ReportToOriginatorEnabled | Optional | System.Boolean | The ReportToOriginatorEnabled parameter specifies whether to enable delivery reports to be sent to the sender of email messages that are sent to this distribution group. Valid values are | ||
| RequireSenderAuthenticationEnabled | Optional | System.Boolean | The RequireSenderAuthenticationEnabled parameter specifies whether to require email message delivery from authenticated senders. Valid values are | ||
| SendModerationNotifications | Optional | Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags | The SendModerationNotifications parameter specifies whether status notifications are sent to users when a message they sent to the moderated distribution group is rejected by one of the moderators. You can specify one of the following values:
If you want notifications to be sent to all senders, set this parameter to If you want notifications to be sent to only the senders that are internal to your organization, set this parameter to To disable all status notifications, set this parameter to The default value is | ||
| SendOofMessageToOriginatorEnabled | Optional | System.Boolean | The SendOofMessageToOriginatorEnabled parameter specifies whether to enable out-of-office messages to be delivered to the sender of email messages that are sent to this distribution group. Valid values are | ||
| SimpleDisplayName | Optional | System.String | The SimpleDisplayName parameter is used to display an alternative description of the object when only a limited set of characters is permitted. Valid characters are:
| ||
| UMDtmfMap | Optional | Microsoft.Exchange.Data.MultiValuedProperty | The UMDtmfMap parameter specifies whether you want to create a user-defined DTMF map for the Unified Messaging (UM)-enabled dynamic distribution group. | ||
| WhatIf | Optional | System.Management.Automation.SwitchParameter | The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch. | ||
| WindowsEmailAddress | Optional | Microsoft.Exchange.Data.SmtpAddress | The WindowsEmailAddress parameter specifies the value of the E-mail field of the Active Directory object. |
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

Important: