Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Set Distribution Group operation

The Set Distribution Group process modifies the settings of an existing distribution group. The following table describes the input parameters for Set Distribution group process

 Adapter request elements for Set Distribution Group process

Element

Definition

Required

<Identity>

Specifies the object that you want to modify

The Identity parameter can take any of the following values for the distribution group:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name
  • Alias
  • Exchange DN
  • Primary Simple Mail Transfer Protocol (SMTP) address

    The Identity parameter cannot be used if the Instance parameter is specified.

Yes

<AcceptMessagesOnlyFrom>

Specifies the mailbox users, mail users and mail contacts who can send e-mail messages to this distribution group

You can 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, it will only receive system-generated messages.

The AcceptMessagesOnlyFrom parameter can take any of the following values for the valid senders:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name
  • Alias
  • Exchange DN

    Primary SMTP e-mail address (it is the default parameter and the value of this parameter is blank. This enables the distribution group to accept messages from all senders)

No

<AcceptMessagesOnlyFromDLMembers>

Specifies the distribution groups whose members are allowed to send e-mail messages to this distribution group

You can use any of the following values for the allowed distribution groups:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name
  • Legacy Exchange DN
  • Primary SMTP e-mail address (this is the default parameter and the value of this parameter is blank. This enables the distribution group to accept messages from all senders)

No

<Alias>

Specifies the alias of the object

The value of Alias cannot contain spaces.

No

<CreateDTMFMap>

Specifies a Dual Tone Multi-frequency (DTMF) map be created for the distribution group.

No

<CustomAttribute1>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute10>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute11>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute12>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute13>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute14>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute15>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute2>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute3>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute4>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute5>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute6>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute7>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute8>

Specifies custom attributes

You can use these attributes to store additional information.

No

<CustomAttribute9>

Specifies custom attributes

You can use these attributes to store additional information.

No

<DisplayName>

Specifies the distribution group's name in the Exchange Management Console and in the Exchange global address list (GAL).

No

<DomainController>

Specifies the Fully Qualified Domain Name (FQDN) of the domain controller that writes this configuration change to Active Directory

The DomainController parameter should be included in the command

No

<EmailAddresses>

Specifies the e-mail alias of the distribution group

All valid Microsoft Exchange Server 2007 e-mail address types may be used. You can specify multiple values for the EmailAddresses parameter as a comma-delimited list.

Important: Exchange 2007 does not validate custom addresses for proper formatting. You must ensure that the custom address you specify complies with the format requirements for that address type. As X.400 addresses are considered custom addresses in Exchange 2007, they are also not validated and must provide the correct syntax when specifying an X.400 address.

No

<EmailAddressPolicyEnabled>

Controls applying e-mail address policies to this distribution group Valid values are true or false.

The default value is true. By default, all applicable e-mail address policies are applied to this distribution group.

No

<ExpansionServer>

Specifies the Exchange server that is used to expand the distribution group Mention the expansion server as a legacy Exchange DN value.

The default behavior is to use the closest Exchange Server 2003 computer, or the closest Exchange 2007 server that has the Hub Transport server role installed.

No

<GrantSendOnBehalfTo>

Specifies a mailbox user who can send on behalf of this distribution group

The GrantSendOnBehalfTo parameter can take any of the following values:

  • Distinguished name (DN)
  • GUID
  • Name
  • Display name
  • Canonical name
  • Legacy Exchange DN
  • Alias
  • Primary SMTP e-mail address (This is the default parameter and the value of GrantSendOnBehalfTo is blank). Hence, no other mailbox user has permission to send on behalf of this distribution group.

No

<HiddenFromAddressListsEnabled>

Hides the distribution group from any Exchange address list Valid values are true or false.

The default value is false.

No

<IgnoreDefaultScope>

Instructs the command to ignore the default recipient scope setting for the Exchange Management Shell and use the entire forest as the scope

This allows the command to access Active Directory objects that are not currently in the default scope.

Using the IgnoreDefaultScope parameter introduces the following restrictions:

  • You cannot use the DomainController parameter. The command will use an appropriate global catalog server automatically.
  • You can only use the DN for Identity parameter. Other forms of identification, such as alias or GUID, are not accepted.

No

<Instance>

Enables you to pass an entire object to the command to be processed

It is mainly used in scripts where an entire object must be passed to the command. The Instance parameter cannot be used if the Identity parameter is specified.

No

<ManagedBy>

Specifies the name of the mailbox user, mail-enabled group, or mail-enabled contact that appears in the Managed by tab of the Active Directory object

You can use any of the following values for this parameter:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name
  • Legacy Exchange DN
  • Primary SMTP e-mail address

No

<MaxReceiveSize>

Sets the maximum allowed e-mail message size that can be sent to a distribution group

When you enter a value, qualify the value with one of the following units:

  • B (bytes)
  • KB (kilobytes)
  • MB (megabytes)
  • GB (gigabytes)
  • TB (terabytes)

    Unqualified values are treated as bytes. Valid values are 0 through 2147482624 bytes. By default, the MaxReceiveSize parameter is set to unlimited.

No

<MaxSendSize>

Specifies the maximum allowed e-mail message size that can be sent from this distribution group When you enter a value, qualify the value with one of the following units:

  • B (bytes)
  • KB (kilobytes)
  • MB (megabytes)
  • GB (gigabytes)
  • TB (terabytes)

    Unqualified values are treated as bytes. Valid values are 0 through 2147482624 bytes. By default, the MaxSendSize parameter is set to unlimited.

No

<Name>

Specifies the name of the distribution group

It specifies the distribution group name in Active Directory Users and Computers and also in the Group Name field in the Exchange Management Console.

No

<PrimarySmtpAddress>

Specifies the primary return SMTP e-mail address for the distribution group

This parameter only has meaning if the distribution group has multiple SMTP e-mail addresses.

No

<RejectMessagesFrom>

Specifies mailbox users and mail-enabled contacts who are not allowed to send e-mail messages to this distribution group

You can use any of the following values for the prohibited senders:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name
  • Legacy Exchange DN
  • Primary SMTP e-mail address

    By default, the value of this parameter is blank. This enables the distribution group to accept messages from all mailbox users and all mail-enabled contacts.

No

<RejectMessagesFromDLMembers>

Specifies the distribution groups who are not allowed to send e-mail messages to the distribution group

You can use any of the following values for the prohibited distribution groups:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name
  • Legacy Exchange DN
  • Primary SMTP e-mail address

    By default, the value of this parameter is blank. This enables the distribution group to accept messages from all distribution groups.

No

<ReportToManagerEnabled>

Allows delivery reports sent to the distribution group manager

Valid values are true or false. The default value is false.

No

<ReportToOriginatorEnabled>

Allows delivery reports sent to senders of e-mail messages which in turn are sent to the distribution group Valid values are true or false.

The default value is true.

No

<RequireSenderAuthenticationEnabled>

Requires e-mail message delivery from authenticated senders

If the value is true, messages are accepted only from authenticated senders. Valid values are true or false. The default value is true.

No

<SamAccountName>

Specifies the name of clients for the object that are running older operating system
\It is displayed in Active Directory and in the Exchange Management Console in the Group name*pre-Windows 2000* field.

No

<SendOofMessageToOriginatorEnabled>

Allows Out of Office messages to be delivered to the senders of e-mail messages that are sent to this distribution group

Valid values are true or false. The default value is false.

No

<SimpleDisplayName>

Used to display an alternative description of the object when only a limited set of characters is permitted

This limited set of characters consists of ASCII characters 26 through 126, inclusively.

No

<UMDtmfMap>

Specifies if the user wants to create a user-defined DTMF map for the UM-enabled distribution group

No

<WindowsEmailAddress>

Specifies the value of the E-mail field for the Active Directory object

No

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*