New-DistributionGroup

模块:: Exchange PowerShell

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。某些参数和设置可能是一个环境或另一个环境独占。

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

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

语法

Default (默认值)

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"

此示例创建名为 Managers 的启用邮件的安全组，但不指定任何成员。

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

示例 2

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

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

参数

-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

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

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

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

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

参数属性

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

参数集

(All)

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

-ArbitrationMailbox

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

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

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

参数属性

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

参数集

(All)

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

-BccBlocked

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

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

$true：如果在密件抄送行中使用了该组，则该组的成员不会收到邮件，发件人会收到未送达报告 (也称为 NDR 或退回邮件) 。不会阻止该消息的其他收件人。如果外部发件人使用密件抄送行中的组，则不会阻止该组的成员。对于嵌套组，仅为顶级组的成员阻止消息。
$false：在密件抄送邮件行中使用组没有任何限制。此值为默认值。

参数属性

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

参数集

(All)

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

-BypassNestedModerationEnabled

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

$true：审阅人批准发送给该组的消息后，将自动批准属于该组成员的所有其他已审查组。
$false：审阅人批准发送给该组的消息后，作为该组成员的每个已主持组都需要单独审批。此值为默认值。

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

参数属性

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

参数集

(All)

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

-Confirm

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

-CopyOwnerToMember

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

参数属性

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

参数集

(All)

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

-Description

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

参数属性

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

参数集

(All)

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

-DisplayName

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

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

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

参数属性

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

参数集

(All)

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

-DomainController

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

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

参数属性

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

参数集

(All)

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

-HiddenGroupMembershipEnabled

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

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

使用此设置来帮助遵守要求你对成员或外部人员隐藏组成员身份的法规，例如，代表班级) 中注册的学生的通讯组 (。

注意：如果您创建了使用隐藏成员身份的群组，则以后无法编辑该群组以向该群组显示成员身份。

参数属性

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

参数集

(All)

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

-IgnoreNamingPolicy

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

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

参数属性

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

参数集

(All)

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

-ManagedBy

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

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

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

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

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

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

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

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

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

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

参数属性

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

参数集

(All)

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

-MemberDepartRestriction

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

开放：成员可以在未经其中一位群组所有者批准的情况下离开群组。此值是通用通讯组的默认值。不能在通用安全组上使用此值。
Open：成员可以离开组，无需得到组所有者之一的批准。这是通用通讯组的默认值。此值是通用安全组的默认值。

参数属性

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

参数集

(All)

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

-MemberJoinRestriction

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

开放：用户可以将自己添加到组中，而无需获得组所有者的批准。不能在通用安全组上使用此值。
已关闭：用户无法将自己添加到组中，并且自动拒绝加入组的请求。这是通用通讯组的默认值。此值是通用安全组和通用通讯组上的默认值。
Closed：用户无法将自己添加到组中，并自动拒绝加入组的请求。请求获得组所有者之一的批准后，将用户添加到组中。这是通用安全组和通用通讯组的默认值。

参数属性

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

参数集

(All)

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

-Members

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

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

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

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

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

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

参数属性

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

参数集

(All)

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

-ModeratedBy

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

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

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

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

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

参数属性

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

参数集

(All)

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

-ModerationEnabled

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

$true：已为此收件人启用审查。发送给此收件人的消息必须在传递消息之前获得审阅人的批准。
$false：已为此收件人禁用审查。发送给此收件人的邮件未经审阅人批准即可发送。此值为默认值。

可以使用 ModeratedBy 参数指定审阅人。

参数属性

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

参数集

(All)

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

-Name

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

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

参数属性

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

参数集

(All)

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

-Notes

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

参数属性

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

参数集

(All)

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

-OrganizationalUnit

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

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

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

参数属性

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

参数集

(All)

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

-PrimarySmtpAddress

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

参数属性

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

参数集

(All)

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

-RequireSenderAuthenticationEnabled

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

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

默认值为 $true。

参数属性

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

参数集

(All)

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

-RoomList

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

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

参数属性

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

参数集

(All)

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

-SamAccountName

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

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

参数属性

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

参数集

(All)

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

-SendModerationNotifications

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

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

仅当启用审查 (ModerationEnabled 参数的值为 $true) 时，此参数才有意义。

参数属性

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

参数集

(All)

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

-Type

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

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

组的作用域始终为通用。

参数属性

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

参数集

(All)

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

-WhatIf

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

反馈

此页面是否有帮助？