Enable-DistributionGroup

此 cmdlet 仅适用于本地 Exchange。

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

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

语法

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

说明

Enable-DistributionGroup cmdlet mail-通过添加 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

Alias 参数指定 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

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

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

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

Alias 参数永远不会生成或更新邮件联系人或邮件用户的主电子邮件地址。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

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

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

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisplayName

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

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DomainController

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

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

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

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

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

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID
类型:GroupIdParameter
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PrimarySmtpAddress

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

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

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

类型:SmtpAddress
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

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

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

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

输出

Output types

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