Enable-DistributionGroup

此 cmdlet 仅适用于本地 Exchange。

使用 Enable-DistributionGroup cmdlet 可以为尚未启用邮件的现有通用安全组和通用通讯组启用邮件功能。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。

语法

Default (默认值)

Enable-DistributionGroup
    [-Identity] <GroupIdParameter>
    [-Alias <String>]
    [-Confirm]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-WhatIf]
    [<CommonParameters>]

说明

Enable-DistributionGroup cmdlet 邮件通过添加 Exchange 所需的电子邮件属性来启用现有通用安全组和通用通讯组。 已启用邮件的安全组和通讯组可以看到其他 *-DistributionGroup cmdlet 和 *-DistributionGroupMember cmdlet。

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果分配给你的权限中未包含某些参数,则可能无权访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。

在 Exchange Server 中,CommonParameters InformationVariable 和 InformationAction 不起作用。

示例

示例 1

Enable-DistributionGroup -Identity "Distribution Group1"

本示例将启用通用通讯组 Distribution Group1 的邮件功能。

参数

-Alias

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

别名参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。 此值将收件人标识为已启用邮件的对象,且不得与同一个收件人的多个电子邮件地址混淆(也称为代理地址)。 收件人只能有一个 Alias 值。 最大长度为 64 个字符。

别名值可以包含字母、数字和以下字符:

  • !、#、%, *、+、-、/、=、?、^、_ 和 ~。
  • $、&、'、'、{、} 和 |需要转义 (-Alias what`'snew 例如) 或整个值(例如单 -Alias 'what'snew' 引号 (例如) )。 Microsoft Entra Connect同步的别名值中不支持 & 字符。
  • 句点 (.) 必须由其他有效字符包围, (例如 help.desk) 。
  • Unicode 字符 U+00A1 到 U+00FF。

创建收件人而不指定电子邮件地址时,将使用指定的别名值生成主电子邮件地址 (alias@domain) 。 支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。 例如,U+00F6 (ö) 在主电子邮件地址中更改。oe

如果在创建收件人时不使用“别名”参数,则“别名”属性值将使用其他必需参数的值:

  • 具有用户帐户 (例如用户邮箱和邮件用户) 的收件人: 使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。 例如, helpdesk@contoso.onmicrosoft.com 结果为 别名属性值 helpdesk。
  • 没有用户帐户的收件人 (例如,会议室邮箱、邮件联系人和通讯组) :使用 Name 参数的值。 空格将被删除,不受支持的字符将转换为问号 (?) 。

如果修改现有收件人的别名值,则仅在收件人受电子邮件地址策略约束 (收件人) 的 EmailAddressPolicyEnabled 属性为 True 的环境中,才会自动更新主电子邮件地址。

别名参数从不生成或更新邮件联系人或邮件用户的主电子邮件地址。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 有何影响取决于 cmdlet 在继续操作前是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false。
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisplayName

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DisplayName 参数指定组的显示名称。 显示名称在 Exchange 管理中心和地址列表中可见。 长度不得超过 256 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity 参数指定您要启用邮件功能的通用安全组或通用通讯组。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID

参数属性

类型:GroupIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-PrimarySmtpAddress

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

PrimarySmtpAddress 参数指定对收件人使用的主要返回电子邮件地址。

默认情况下,将根据默认电子邮件地址策略以及别名参数或名称属性的值生成主 SMTP 地址。 如果使用 PrimarySmtpAddress 参数指定主电子邮件地址,则 EmailAddressPolicyEnabled 属性将设置为值 False,这意味着电子邮件地址策略不会自动更新组的电子邮件地址。

参数属性

类型:SmtpAddress
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

WhatIf 开关显示命令执行的操作,而无需进行任何更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:WI

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。