New-DistributionGroup

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 New-DistributionGroup cmdlet 创建通讯组和启用邮件的安全组。

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

语法

New-DistributionGroup
   [-Name] <String>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-BccBlocked <Boolean>]
   [-BypassNestedModerationEnabled <Boolean>]
   [-Confirm]
   [-CopyOwnerToMember]
   [-Description <MultiValueProperty>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-HiddenGroupMembershipEnabled]
   [-IgnoreNamingPolicy]
   [-ManagedBy <MultiValuedProperty>]
   [-MemberDepartRestriction <MemberUpdateType>]
   [-MemberJoinRestriction <MemberUpdateType>]
   [-Members <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-Notes <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-RoomList]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-Type <GroupType>]
   [-WhatIf]
   [<CommonParameters>]

说明

可以使用 New-DistributionGroup cmdlet 创建下列类型的组:

  • 启用邮件的通用安全组 (USG)
  • 通用通讯组

通讯组用于将多个收件人组合并为电子邮件的单个联系点。 通讯组不是安全主体,因此不能向其分配权限。 但是,您可以为已启用邮件的安全组分配权限。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

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

示例

示例 1

New-DistributionGroup -Name "Managers" -Type "Security"

本示例创建一个名为 Manager 的已启用邮件的安全组,但未指定任何成员。

使用 Add-DistributionGroupMember cmdlet 在创建组后添加成员。

示例 2

New-DistributionGroup -Name "ITDepartment" -Members chris@contoso.com,michelle@contoso.com,laura@contoso.com,julia@contoso.com

此示例创建名为 ITDepartment 的通讯组并指定成员。

参数

-Alias

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

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

-ArbitrationMailbox

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

此参数只在本地 Exchange 中可用。

ArbitrationMailbox 参数指定用于管理此收件人的审阅流程的仲裁邮箱。 可以使用任何能够唯一标识仲裁邮箱的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)
类型:MailboxIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BccBlocked

适用:Exchange Online、Exchange Online Protection

此参数仅在基于云的服务中可用。

BccBlocked 参数指定在密件抄送行中使用组的成员是否不接收消息。 有效值包含:

  • $true:如果在密件抄送行中使用了组,则组成员不会收到邮件,并且发件人会收到未送达报告 (也称为 NDR 或退回邮件) 。 不会阻止邮件的其他收件人。 如果外部发送方使用密件抄送行中的组,则不会阻止该组的成员。 对于嵌套组,仅对顶级组的成员阻止消息。
  • $false:在密件抄送邮件行中使用组没有限制。 此值为默认值。
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BypassNestedModerationEnabled

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

ByPassNestedModerationEnabled 参数指定当审查组包含其他审查组作为成员时如何处理消息审批。 有效值包含:

  • $true:审阅者批准发送到组的邮件后,该邮件将自动批准属于该组的所有其他审查组。
  • $false:审阅者批准发送到组的邮件后,需要对作为组成员的每个审查组单独审批。 此值为默认值。

此参数只能由顶级组织和租户管理员使用。

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

-Confirm

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

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

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

-CopyOwnerToMember

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

CopyOwnerToMember 开关指定 ManagedBy 参数指定的组所有者是否也是组的成员。 不必为此开关指定值。

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

-Description

适用:Exchange Online、Exchange Online Protection

此参数仅在基于云的服务中可用。

{{ 填充说明描述 }}

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

-DisplayName

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

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

如果您不使用 DisplayName 参数,Name 参数的值可用于显示名称。

如果在组织中强制实施组命名策略,则用户需要遵循 Set-OrganizationConfig cmdlet 上的 DistributionGroupNameBlockedWordList 参数指定的命名约束。 若要绕过此要求,请使用 IgnoreNamingPolicy 开关。

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

-DomainController

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

此参数只在本地 Exchange 中可用。

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

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

-HiddenGroupMembershipEnabled

适用:Exchange Online、Exchange Online Protection

此参数仅在基于云的服务中可用。

HiddenGroupMembershipEnabled 开关指定是否对不是组成员的用户隐藏通讯组的成员。 不必为此开关指定值。

可以使用此设置来帮助遵守要求向成员或局外人隐藏组成员身份 (例如,代表在课堂) 注册学生的通讯组。

注意:如果创建具有隐藏成员身份的组,则以后无法编辑组以向组显示成员身份。

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

-IgnoreNamingPolicy

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

IgnoreNamingPolicy 开关指定是否防止此组受到组织的组命名策略的影响。 不必为此开关指定值。

组命名策略由 Set-OrganizationConfig cmdlet 上的 DistributionGroupNamingPolicy 和 DistributionGroupNameBlockedWordList 参数定义。

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

-ManagedBy

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

ManagedBy 参数指定组的所有者。 组必须至少有一个所有者。 如果在创建组时不使用此参数指定所有者,则创建组的用户帐户是所有者。 组所有者能够:

  • ManagedBy 参数指定组的所有者。组至少必须有一个所有者。如果您在创建组时没有使用此参数指定所有者,则创建此组的用户帐户即为所有者。组所有者可以:
  • 修改组的属性
  • 添加或删除组成员
  • 删除组
  • 审批成员的离开或加入请求(若有)

为此参数指定的所有者必须是邮箱、邮件用户或启用邮件的安全组, (可以分配) 权限的已启用邮件的安全主体。

作为组所有者启用邮件的安全组的注意事项:

  • 如果在本地 Exchange 中将启用邮件的安全组指定为组所有者,则启用邮件的安全组不会同步到云对象。
  • 如果所有者是已启用邮件的安全组,则 Outlook 中的组管理不起作用。 若要在 Outlook 中管理组,所有者必须是邮箱或邮件用户。 如果将启用邮件的安全组指定为组的所有者,则组在我拥有的组所有者的 通讯组中 不可见, (启用邮件的安全组的成员) 。

可以使用任何能够唯一标识此所有者的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

若要输入多个所有者,请使用以下语法: Owner1,Owner2,...OwnerN。 如果值中有空格或需要使用双引号,请使用以下语法:"Owner1","Owner2",..."OwnerN"

使用此参数指定的所有者不会自动添加为组成员。 使用 CopyOwnerToMember 开关或手动将所有者添加为成员。

注意:当所有者是已启用邮件的安全组时,Outlook 中的组管理不起作用。 若要在 Outlook 中管理组,所有者必须是邮箱或邮件用户。

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

-MemberDepartRestriction

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

MemberDepartRestriction 参数指定对离开组的请求施加的限制。 有效值包含:

  • 打开:成员可以在未经组所有者之一批准的情况下离开组。 这是通用通讯组的默认值。 不能在通用安全组上使用此值。
  • Open:成员可以离开组,无需得到组所有者之一的批准。 这是通用通讯组的默认值。 无法对通用安全组使用该值。
类型:MemberUpdateType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MemberJoinRestriction

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

MemberJoinRestriction 参数指定对加入组的请求施加的限制。 有效值包含:

  • 打开:用户无需获得组所有者的批准即可将自己添加到组。 不能在通用安全组上使用此值。
  • 已关闭:用户无法将自己添加到组,并且自动拒绝加入组的请求。 这是通用通讯组的默认值。 这是通用安全组和通用通讯组的默认值。
  • Closed:用户无法将自己添加到组中,并自动拒绝加入组的请求。 在请求得到组所有者之一的批准后,用户将添加到组。 这是通用安全组和通用通讯组的默认值。
类型:MemberUpdateType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Members

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

Members 参数指定属于组成员) 的收件人 (启用邮件的对象。 可以使用任何能够唯一标识该收件人的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"

创建组后,可以使用 Get-DistributionGroupMember cmdlet 查看组成员,并使用 Add-DistributionGroupMember、Remove-DistributionGroupMember 和 Update-DistributionGroupMember cmdlet 来管理组成员身份。

虽然这不是一项强制性要求,但最好只将安全主体(例如,使用用户帐户的邮箱和邮件用户,或其他启用邮件的安全组)添加到启用邮件的安全组中。 如果您向启用邮件的安全组分配权限,那么不是安全主体(例如,邮件联系人或通讯组)的所有成员都不会分配到权限。

此参数的最大条目数为 10000。

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

-ModeratedBy

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

ModeratedBy 参数指定此组的一个或多个审查员。 审阅者在邮件传递之前批准发送到组的消息。 审查方必须是您组织中的邮箱、邮件用户或邮件联系人。 可以使用任何能够唯一标识审查方的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"

对于已启用邮件的安全组,在将 ModerationEnabled 参数设置为值$true时,需要使用此参数指定至少一个审查器。

对于通讯组,如果将 ModerationEnabled 参数设置为值$true,但不使用此参数指定任何审查者,则 ManagedBy 参数指定的组所有者负责批准发送到组的消息。

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

-ModerationEnabled

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

ModerationEnabled 参数指定是否为此收件人启用审查。 有效值包括:

  • $true:已为此收件人启用审核。 发送到此收件人的邮件必须经过审查员的批准,然后才能传递邮件。
  • $false:此收件人禁用审查。 发送给此收件人的邮件未经审阅人批准即可传递。 此值为默认值。

使用 ModeratedBy 参数指定审查器。

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

-Name

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

Name 参数指定唯一的组名。 最大长度为 64 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

如果不使用 DisplayName 参数,此值还用于 DisplayName 属性。

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

-Notes

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

Notes 参数指定对象的其他信息。 如果值中有空格,请使用双引号 (") 将此值括起来。

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

-OrganizationalUnit

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

OrganizationUnit 参数指定在 Active Directory 中创建组的位置。

此参数的有效输入是由 Get-OrganizationalUnit cmdlet 返回的组织单位 (OU) 或域。 可以使用任何能够唯一标识此 OU 或域的值。 例如:

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

-PrimarySmtpAddress

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

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

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

-RequireSenderAuthenticationEnabled

适用:Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

RequireSenderAuthenticationEnabled 参数指定是否仅接受来自经过身份验证 (内部) 发件人的消息。 有效值包含:

  • $true:仅接受来自经过身份验证 (内部) 发件人的邮件。 来自未经身份验证 (外部) 发件人的邮件将被拒绝。
  • $true:只接受经过身份验证的(内部)发件人的邮件。未经身份验证的(外部)发件人的邮件会遭到拒绝。

默认值为 $true。

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

-RoomList

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

RoomList 开关指定通讯组的所有成员都是会议室邮箱。 不必为此开关指定值。

您可以为组织中的办公楼创建一个通讯组,然后将该办公楼中的所有会议室添加到该通讯组中。 会议室列表通讯组用于在 Outlook 2010 或更高版本中生成会议请求的生成位置列表。 会议室列表允许用户选择办公楼并获取有关该办公楼中所有会议室的可用性信息,而无需单独添加每个会议室。

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

-SamAccountName

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

此参数只在本地 Exchange 中可用。

SamAccountName 参数(亦称为 Windows 2000 以前版本的用户帐户或组名称)指定与旧版 Microsoft Windows 客户端和服务器操作系统兼容的对象标识符。 该值可以包含字母、数字、空格、句点 (.) ,以及以下字符:!、#、$、%^、&、-、_、{、}和 ~。 不得以句点字符结尾。 虽然允许使用 Unicode 字符,但重音符号可能会产生冲突(例如,o 和 ö 匹配)。

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

-SendModerationNotifications

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

客户端通过代理从客户端访问服务连接到本地或远程邮箱服务器上的后端服务。 有效值包含:

  • 始终:在其邮件未获批准时通知所有发件人。 此值为默认值。
  • Always:当发件人的邮件未得到批准时,通知所有发件人。此为默认值。
  • Internal:当组织中发件人的邮件未得到批准时,通知这些发件人。

只有在 ModerationEnabled 参数具有值$true) 时,才启用审查, (此参数才有意义。

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

-Type

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

Type 参数指定要创建的组的类型。 有效值包含:

  • 分发:通讯组。 无法为这些组分配权限。 此值为默认值。
  • 安全性:启用邮件的安全组。 这些组可以分配权限。

组的作用域始终为通用。

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

-WhatIf

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

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

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

输入

Input types

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

输出

Output types

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