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 不返回任何数据。