Set-DistributionGroup

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2010-10-20

使用 Set-DistributionGroup cmdlet 修改现有通讯组的设置。

语法

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

详细说明

通讯组用于将多个收件人组合并为电子邮件的单个联系点。不能使用通讯组来分配对 Active Directory 目录服务中的网络资源的权限。可以使用 Set-DistributionGroup cmdlet 覆盖现有设置或添加新设置。

若要运行 Set-DistributionGroup cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 收件人管理员角色

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Identity 参数指定要修改的对象。Identity 参数可以接受通讯组的下列任何值：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 别名

  • Exchange DN

  • 主简单邮件传输协议 (SMTP) 地址

如果指定了 Instance 参数，则不能使用 Identity 参数。

AcceptMessagesOnlyFrom

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom 参数指定可以向此通讯组发送电子邮件的邮箱用户、邮件用户和邮件联系人。还可以将 Microsoft Exchange 指定为此参数的有效收件人。如果配置通讯组仅接受来自 Microsoft Exchange 收件人的邮件，它将仅接收系统生成的邮件。

AcceptMessagesOnlyFrom 参数可以接受以下任何一个值代表有效发件人：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 别名

  • Exchange DN

  • 主 SMTP 电子邮件地址

默认情况下，此参数值为空。这样，通讯组可以接受来自所有发件人的邮件。

AcceptMessagesOnlyFromDLMembers

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFromDLMembers 参数指定允许其成员向此通讯组发送电子邮件的通讯组。可以使用下列任何一个值来代表允许的通讯组：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 旧版 Exchange DN

  • 主 SMTP 电子邮件地址

默认情况下，此参数值为空。这样，通讯组可以接受来自所有发件人的邮件。

Alias

可选

System.String

Alias 参数可用于指定对象的别名。Alias 值不能包含空格。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

CreateDTMFMap

可选

System.Boolean

此参数指定为通讯组创建的双音多频 (DTMF) 映射。

CustomAttribute1

可选

System.String

CustomAttribute1 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute10

可选

System.String

CustomAttribute10 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute11

可选

System.String

CustomAttribute11 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute12

可选

System.String

CustomAttribute12 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute13

可选

System.String

CustomAttribute13 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute14

可选

System.String

CustomAttribute14 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute15

可选

System.String

CustomAttribute15 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute2

可选

System.String

CustomAttribute2 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute3

可选

System.String

CustomAttribute3 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute4

可选

System.String

CustomAttribute4 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute5

可选

System.String

CustomAttribute5 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute6

可选

System.String

CustomAttribute6 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute7

可选

System.String

CustomAttribute7 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute8

可选

System.String

CustomAttribute8 参数指定自定义属性。可以使用这些属性存储其他信息。

CustomAttribute9

可选

System.String

CustomAttribute9 参数指定自定义属性。可以使用这些属性存储其他信息。

DisplayName

可选

System.String

DisplayName 参数可以用于指定在 Exchange 管理控制台和 Exchange 全局地址列表 (GAL) 中的通讯组的名称。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 的域控制器的完全限定的域名 (FQDN)，请包含 DomainController 参数。

EmailAddresses

可选

Microsoft.Exchange.Data.ProxyAddressCollection

EmailAddresses 参数可用于指定通讯组的电子邮件别名。可以使用所有有效的 Microsoft Exchange Server 2007 电子邮件地址类型。可以采用逗号分隔列表形式为 EmailAddresses 参数指定多个值。

important要点：
Exchange 2007 不验证自定义地址的格式是否正确。您必须确保指定的自定义地址符合该地址类型的格式要求。因为 X.400 地址在 Exchange 2007 中被视为自定义地址，所以不会验证这些地址。因此，在指定 X.400 地址时必须提供正确的语法。

EmailAddressPolicyEnabled

可选

System.Boolean

EmailAddressPolicyEnabled 参数可用于控制将电子邮件地址策略应用于此通讯组。有效值为 $true 或 $false。默认值为 $true。默认情况下，将所有适用的电子邮件地址策略应用于此通讯组。

ExpansionServer

可选

System.String

ExpansionServer 参数指定用于展开通讯组的 Exchange 服务器。使用旧版 Exchange DN 值输入扩展服务器。默认做法是使用最近的 Exchange Server 2003 计算机，或最近的安装了集线器传输服务器角色的 Exchange 2007 服务器。

GrantSendOnBehalfTo

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

GrantSendOnBehalfTo 参数指定可以代表此通讯组发信的邮箱用户。GrantSendOnBehalfTo 参数可以接受下列任何一个值：

  • 可分辨名称 (DN)

  • GUID

  • 名称

  • 显示名称

  • 规范名称

  • 旧版 Exchange DN

  • 别名

  • 主 SMTP 电子邮件地址

默认情况下，GrantSendOnBehalfTo 的值为空。这意味着其他邮箱用户均无权代表此通讯组发送邮件。

HiddenFromAddressListsEnabled

可选

System.Boolean

HiddenFromAddressListsEnabled 参数可以使该通讯组不显示在任何 Exchange 地址列表中。有效值为 $true 或 $false。默认值为 $false。

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置，并使用整个林作为作用域。这样，该命令可以访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数时将受到下列限制：

  • 不能使用 DomainController 参数。该命令将自动使用相应的全局编录服务器。

  • 仅可以对 Identity 参数使用 DN。不接受其他形式的标识，如别名或 GUID。

Instance

可选

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

如果指定了 Identity 参数，则不可使用 Instance 参数。

ManagedBy

可选

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

ManagedBy 参数指定邮箱用户、已启用邮件的组或已启用邮件的联系人在 Active Directory 对象的“管理者”选项卡中显示的名称。可将下列任何一个值用于此参数：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 旧版 Exchange DN

  • 主 SMTP 电子邮件地址

MaxReceiveSize

可选

Microsoft.Exchange.Data.Unlimited

MaxReceiveSize 参数可以设置发送给此通讯组所允许的最大电子邮件大小。输入值时，请用下列单位之一限定该值：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

  • TB（兆兆字节）

未限定的值被视为以字节为单位。有效值从 0 到 2147482624 字节。

默认情况下，MaxReceiveSize 参数设置为 unlimited。

MaxSendSize

可选

Microsoft.Exchange.Data.Unlimited

MaxSendSize 参数可以设置从此通讯组发送所允许的最大电子邮件大小。输入值时，请用下列单位之一限定该值：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

  • TB（兆兆字节）

未限定的值被视为以字节为单位。有效值从 0 到 2147482624 字节。

默认情况下，MaxSendSize 参数设置为 unlimited。

Name

可选

System.String

Name 参数指定通讯组的名称。Name 参数指定 Active Directory 用户和计算机中以及 Exchange 管理控制台的“组名”字段中的通讯组名称。

PrimarySmtpAddress

可选

Microsoft.Exchange.Data.SmtpAddress

PrimarySmtpAddress 参数指定通讯组的主返回 SMTP 电子邮件地址。只有通讯组包含多个 SMTP 电子邮件地址时，此参数才有意义。

RejectMessagesFrom

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFrom 参数指定不允许向此通讯组发送电子邮件的邮箱用户和已启用邮件的联系人。可以使用下列任何一个值代表被禁止的发件人：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 旧版 Exchange DN

  • 主 SMTP 电子邮件地址

默认情况下，此参数值为空。这样，通讯组可以接收来自所有邮箱用户和所有已启用邮件联系人的邮件。

RejectMessagesFromDLMembers

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFromDLMembers 参数指定允许向此通讯组发送电子邮件的通讯组。可以使用下列任何一个值来代表被禁止的通讯组：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 旧版 Exchange DN

  • 主 SMTP 电子邮件地址

默认情况下，此参数值为空。这样，通讯组可以接受来自所有通讯组的邮件。

ReportToManagerEnabled

可选

System.Boolean

ReportToManagerEnabled   参数使送达报告发送给通讯组主管。有效值为 $true 或 $false。默认值为 $false.

ReportToOriginatorEnabled

可选

System.Boolean

ReportToOriginatorEnabled   参数使送达报告发送给向此通讯组发送的电子邮件的发件人。有效值为 $true 或 $false。默认值为 $true。

RequireSenderAuthenticationEnabled

可选

System.Boolean

RequireSenderAuthenticationEnabled 参数需要电子邮件从经过身份验证的发件人发送。如果该值为 $true，则只接受来自经过身份验证的发件人的邮件。有效值为 $true 或 $false。默认值为 $true。

SamAccountName

可选

System.String

SamAccountName 参数指定该对象中运行早期操作系统的客户端的名称。SamAccountName 参数显示在 Active Directory 中以及 Exchange 管理控制台的“组名（Windows 2000 以前的版本）”字段中。

SendOofMessageToOriginatorEnabled

可选

System.Boolean

SendOofMessageToOriginatorEnabled 参数使系统可以向发送到此通讯组的电子邮件的发件人传递外出邮件。有效值为 $true 或 $false。默认值为 $false。

SimpleDisplayName

可选

System.String

如果只允许使用有限的一组字符，则使用 SimpleDisplayName 参数显示对象的备用说明。这组有限的字符由以下字符组成：

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定是否需要为启用 UM 的通讯组创建用户定义的 DTMF 映射。

UseRusServer

可选

System.String
note注意：
此参数仅在 Exchange 2007 SP2 中可用。

UseRusServer 参数指示该命令使用运行地址列表服务的指定邮箱服务器获取和设置邮箱和 Active Directory 用户属性。

地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务在 Active Directory 中创建和维护 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

WindowsEmailAddress

可选

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 参数指定 Active Directory 对象的“电子邮件”字段值。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下示例代码显示如何使用 Set-DistributionGroup 命令，将名为“Accounting”的现有通讯组的显示名称更改为“Accounting Group”。

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"