Set-Group

 

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

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

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

语法

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

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

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

详细说明

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

无法使用 Set-Group cmdlet 修改动态通讯组。若要修改动态通讯组,请使用 Set-DynamicDistributionGroup cmdlet。

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

  • Exchange 收件人管理员角色

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

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

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

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • Name

  • 显示名称

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

Confirm

可选

System.Management.Automation.SwitchParameter

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

DisplayName

可选

System.String

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

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置,并使用整个林作为作用域。这样,该命令可以访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数时将受到下列限制:

  • 不能使用 DomainController 参数。该命令将自动使用相应的全局编录服务器。

  • 仅可以对 Identity 参数使用 DN。不接受其他形式的标识,如别名或 GUID。

Instance

可选

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

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

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

ManagedBy

可选

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

  • 可分辨名称 (DN)

  • 规范名称

  • GUID

  • Name

  • 显示名称

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 参数将组的作用域从 globaldomain local 更改为 universal

UseRusServer

可选

System.String

note注意:
此参数仅在 Exchange 2007 SP2 中可用。

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

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

WhatIf

可选

System.Management.Automation.SwitchParameter

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

WindowsEmailAddress

可选

Microsoft.Exchange.Data.SmtpAddress

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

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

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

  • 添加 verified 作为注释值。

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