通过

New-DistributionGroup (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2007-06-05

使用 New-DistributionGroup cmdlet 新建通讯组。

语法

New-DistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-TemplateInstance <PSObject>]

详细说明

可以使用 New-DistributionGroup cmdlet 创建下列类型的新 Active Directory 组对象：

  • 已启用邮件的通用安全组

  • 通用通讯组

通讯组用于将多个收件人组合并为电子邮件的单个联系点。不能使用通讯组来分配对 Active Directory 目录服务中的网络资源的权限。

若要运行 New-DistributionGroup cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 收件人管理员角色

  • 帐户操作员角色（对于适用的 Active Directory 容器）

有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

Name

必需

System.String

此参数指定新通讯组的名称。如果未指定 DisplayName 参数，在 Name 参数中指定的值也可用于 DisplayName。

Name 值不得超过 64 个字符。

如果 Name 和 DisplayName 的值不同：

  • Name 指定 Active Directory 用户和计算机中以及 Exchange 管理控制台的“组名”字段中的通讯组名称。

  • DisplayName 指定 Exchange 管理控制台和 Exchange 全局地址列表 (GAL) 中的通讯组名称。

OrganizationalUnit

必需

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

此参数使用规范名称语法，指定在 Active Directory 中创建通讯组的位置。

SamAccountName

必需

System.String

此参数指定该对象中运行早期操作系统的客户端的名称。SamAccountName 参数显示在 Active Directory 中以及 Exchange 管理控制台的“组名（Windows 2000 以前的版本）”字段中。如果未指定 Alias 参数，则满足下列条件：

  • SAMAccountName 的值用于 Alias 参数的值，任何空格均转换为下划线。

  • SAMAccountName（任何空格均转换为下划线）用于生成对象的主简单邮件传输协议 (SMTP) 电子邮件地址。

类型

必需

Microsoft.Exchange.Management.RecipientTasks.GroupType

此参数指定将在 Active Directory 中创建的组类型。组的作用域始终为通用。有效值为 Distribution 或 Security。

Alias

可选

System.String

此参数可以用于指定通讯组的别名。Alias 参数用于生成对象的主 SMTP 电子邮件地址。Alias 的值不得包含空格。如果未指定 Alias，则使用 SAMAccountName 的值生成主 SMTP 电子邮件地址，任何空格均转换为下划线。

DisplayName

可选

System.String

此参数可以用于指定通讯组在 Exchange 管理控制台以及 Exchange GAL 中的名称。如果未指定 DisplayName 参数，Name 参数的值将用于 DisplayName。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 域控制器的完全限定的域名 (FQDN)，请包含 DomainController 参数。

ManagedBy

可选

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

此参数可以用于指定邮箱用户、已启用邮件的组或已启用邮件的联系人在 Active Directory 对象的“管理者”选项卡中显示的名称。可将下列任何一个值用于此参数：

  • 可分辨名称 (DN)

  • Canonical name

  • GUID

  • 名称

  • Display name

  • Legacy Exchange DN

  • 主 SMTP 电子邮件地址

TemplateInstance

可选

System.Management.Automation.PSObject

为此参数提供现有的对象时，cmdlet 将使用该对象创建对象的副本。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下代码示例显示如何使用 New-DistributionGroup cmdlet 创建已启用邮件的新通用安全组，并采用下列参数：

  • 组名将为“Managers”。

  • 将在 Contoso.com 域的 Users 容器中创建组。

  • 组的 SAM 帐户名将为“Managers”。

  • 组类型将为 Security。

New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"