适用于: 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 参数可以接受通讯组的下列任何值:
如果指定了 Instance 参数,则不能使用 Identity 参数。 |
||
AcceptMessagesOnlyFrom |
可选 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
AcceptMessagesOnlyFrom 参数指定可以向此通讯组发送电子邮件的邮箱用户、邮件用户和邮件联系人。还可以将 Microsoft Exchange 指定为此参数的有效收件人。如果配置通讯组仅接受来自 Microsoft Exchange 收件人的邮件,它将仅接收系统生成的邮件。 AcceptMessagesOnlyFrom 参数可以接受以下任何一个值代表有效发件人:
默认情况下,此参数值为空。这样,通讯组可以接受来自所有发件人的邮件。 |
||
AcceptMessagesOnlyFromDLMembers |
可选 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
AcceptMessagesOnlyFromDLMembers 参数指定允许其成员向此通讯组发送电子邮件的通讯组。可以使用下列任何一个值来代表允许的通讯组:
默认情况下,此参数值为空。这样,通讯组可以接受来自所有发件人的邮件。 |
||
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 参数指定多个值。
|
||
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 参数可以接受下列任何一个值:
默认情况下,GrantSendOnBehalfTo 的值为空。这意味着其他邮箱用户均无权代表此通讯组发送邮件。 |
||
HiddenFromAddressListsEnabled |
可选 |
System.Boolean |
HiddenFromAddressListsEnabled 参数可以使该通讯组不显示在任何 Exchange 地址列表中。有效值为 $true 或 $false。默认值为 $false。 |
||
IgnoreDefaultScope |
可选 |
System.Management.Automation.SwitchParameter |
IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置,并使用整个林作为作用域。这样,该命令可以访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数时将受到下列限制:
|
||
Instance |
可选 |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。 如果指定了 Identity 参数,则不可使用 Instance 参数。 |
||
ManagedBy |
可选 |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
ManagedBy 参数指定邮箱用户、已启用邮件的组或已启用邮件的联系人在 Active Directory 对象的“管理者”选项卡中显示的名称。可将下列任何一个值用于此参数:
|
||
MaxReceiveSize |
可选 |
Microsoft.Exchange.Data.Unlimited |
MaxReceiveSize 参数可以设置发送给此通讯组所允许的最大电子邮件大小。输入值时,请用下列单位之一限定该值:
未限定的值被视为以字节为单位。有效值从 0 到 2147482624 字节。 默认情况下,MaxReceiveSize 参数设置为 |
||
MaxSendSize |
可选 |
Microsoft.Exchange.Data.Unlimited |
MaxSendSize 参数可以设置从此通讯组发送所允许的最大电子邮件大小。输入值时,请用下列单位之一限定该值:
未限定的值被视为以字节为单位。有效值从 0 到 2147482624 字节。 默认情况下,MaxSendSize 参数设置为 |
||
Name |
可选 |
System.String |
Name 参数指定通讯组的名称。Name 参数指定 Active Directory 用户和计算机中以及 Exchange 管理控制台的“组名”字段中的通讯组名称。 |
||
PrimarySmtpAddress |
可选 |
Microsoft.Exchange.Data.SmtpAddress |
PrimarySmtpAddress 参数指定通讯组的主返回 SMTP 电子邮件地址。只有通讯组包含多个 SMTP 电子邮件地址时,此参数才有意义。 |
||
RejectMessagesFrom |
可选 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
RejectMessagesFrom 参数指定不允许向此通讯组发送电子邮件的邮箱用户和已启用邮件的联系人。可以使用下列任何一个值代表被禁止的发件人:
默认情况下,此参数值为空。这样,通讯组可以接收来自所有邮箱用户和所有已启用邮件联系人的邮件。 |
||
RejectMessagesFromDLMembers |
可选 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
RejectMessagesFromDLMembers 参数指定允许向此通讯组发送电子邮件的通讯组。可以使用下列任何一个值来代表被禁止的通讯组:
默认情况下,此参数值为空。这样,通讯组可以接受来自所有通讯组的邮件。 |
||
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 参数使系统可以向发送到此通讯组的电子邮件的发件人传递外出邮件。有效值为 |
||
SimpleDisplayName |
可选 |
System.String |
如果只允许使用有限的一组字符,则使用 SimpleDisplayName 参数显示对象的备用说明。这组有限的字符由以下字符组成: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
UMDtmfMap |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
此参数指定是否需要为启用 UM 的通讯组创建用户定义的 DTMF 映射。 |
||
UseRusServer |
可选 |
System.String |
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"