Set-DistributionGroup (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2007-06-05

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

语法

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-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>] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <DistributionGroup>] [-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>] [-WindowsEmailAddress <SmtpAddress>]

详细说明

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

若要运行 Set-DistributionGroup cmdlet,必须为您使用的帐户委派下列角色:

  • Exchange 收件人管理员角色

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

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

  • 可分辨名称 (DN)

  • Canonical name

  • GUID

  • Name

  • Display name

  • Alias

  • Exchange DN

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

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

AcceptMessagesOnlyFrom

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom 参数指定可以向此通讯组发送电子邮件的邮箱用户和已启用邮件的联系人。AcceptMessagesOnlyFrom 参数可以接受以下任何一个值代表有效发件人:

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名

  • 别名

  • Exchange DN

  • 主 SMTP 电子邮件地址

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

AcceptMessagesOnlyFromDLMembers

可选

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名

  • Legacy Exchange DN

  • 主 SMTP 电子邮件地址

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

Alias

可选

System.String

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

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 参数指定多个值。

EmailAddressPolicyEnabled

可选

System.Boolean

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

ExpansionServer

可选

System.String

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

GrantSendOnBehalfTo

可选

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

GrantSendOnBehalfTo 参数指定可代表此通讯组发送邮件的邮箱用户。GrantSendOnBehalfTo 参数可采用下列任一值:

  • 可分辨名称 (DN)

  • GUID

  • 名称

  • 显示名

  • 规范名称

  • 旧版 Exchange DN

  • 别名

  • 主 SMTP 电子邮件地址

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

HiddenFromAddressListsEnabled

可选

System.Boolean

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

Instance

可选

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

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

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

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 参数显示对象的备用说明。这组有限的字符包括从 26 到 126 的 ASCII 字符(包含 26 和 126)。

UMDtmfMap

可选

Microsoft.Exchange.Data.MultiValuedProperty

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

WindowsEmailAddress

可选

Microsoft.Exchange.Data.SmtpAddress

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

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

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