New-DistributionGroup

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2009-05-12

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

语法

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

详细说明

可以使用 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) 中的通讯组名称。

SamAccountName

必需

System.String

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

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

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

Type

必需

Microsoft.Exchange.Management.RecipientTasks.GroupType

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

Alias

可选

System.String

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

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

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)

  • 规范名称

  • GUID

  • 名称

  • 显示名称

  • 旧版 Exchange DN

  • 主 SMTP 电子邮件地址

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

TemplateInstance

可选

System.Management.Automation.PSObject

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

UseRusServer

可选

System.String
note注意：
此参数仅在 Exchange Server 2007 SP2 中可用。

UseRusServer 参数指示该命令使用运行地址列表服务的指定邮箱服务器获取并设置邮箱和 Active Directory 用户属性。

地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

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

  • 组名将为“Managers”。

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

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

  • 组类型将为 Security。

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