通过

Set-Group (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

使用 Set-Group cmdlet 可以修改现有 Microsoft Windows 组的设置。

语法

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-DisplayName <String>] [-DomainController <Fqdn>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

详细说明

您可以使用 Set-Group cmdlet 修改在 Active Directory 用户和计算机中可见的组对象设置。如果该组是已启用邮件的安全组或通讯组，则可以使用 Set-DistributionGroup cmdlet 来修改使用 Set-Group cmdlet 不可修改的其他 Microsoft Exchange Server 2007 设置。

无法使用 Set-Group cmdlet 修改动态通讯组。若要修改动态通讯组，请使用 Set-DynamicDistributionGroup cmdlet。有关 Set-DynamicDistributionGroup cmdlet 的详细信息，请参阅 Set-DynamicDistributionGroup (RTM)。

若要运行 Set-Group cmdlet，必须为您使用的帐户委派下列角色：

  • Exchange 收件人管理员角色

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

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Identity 参数指定要修改的对象。Identity 参数可以接受组的任何下列值：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名

如果指定了 Instance 参数，则不能使用 Identity 参数。

DisplayName

可选

System.String

DisplayName 参数指定组在 Exchange 管理控制台和 Exchange 全局地址列表 (GAL) 中的名称。只有该组已启用邮件时，此参数才很重要。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

Instance

可选

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

如果指定了 Identity 参数，则不可使用 Instance 参数。

ManagedBy

可选

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

ManagedBy 参数指定在 Active Directory 对象的“管理者”选项卡中出现的用户、组或联系人的名称。可将下列任何一个值用于此参数：

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • 名称

  • 显示名

Name

可选

System.String

Name 参数指定组名。Name 参数指定在 Active Directory 用户和计算机中的组名，以及在 Exchange 管理控制台的“组名”字段中的组名（如果组启用了邮件）。

Notes

可选

System.String

Notes 参数指定用于描述组的用途的注释。

PhoneticDisplayName

可选

System.String

PhoneticDisplayName 参数指定 DisplayName 参数的拼音发音。

此参数值的最大长度为 255 个字符。有关 PhoneticDisplayName 参数和语音识别的详细信息，请参阅了解自动语音识别目录查找。

SimpleDisplayName

可选

System.String

SimpleDisplayName 参数显示只允许一组有限字符时对象的备用说明。这组有限的字符包括从 26 到 126 的 ASCII 字符（包含 26 和 126）。SimpleDisplayName 只对已启用邮件的对象有意义。

Universal

可选

System.Management.Automation.SwitchParameter

Universal 参数将组的作用域从 global 或 domain local 更改为 universal。

WindowsEmailAddress

可选

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 参数指定 Active Directory 对象的“电子邮件”字段值。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

下列代码示例显示如何使用 Set-Group 命令将下列更改应用到名为“Legal Department”的现有全局安全组：

  • 将组的作用域更改为通用。

  • 添加 verified 作为注释值。

Set-Group -Identity "Legal Department" -Universal -Notes "verified"