Set-Group

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Set-Group cmdlet 修改组对象设置。如果组是启用邮件的安全组或通讯组，则可以使用 Set-DistributionGroup cmdlet 修改其他Microsoft Exchange 设置，这些设置无法使用 Set-Group cmdlet。

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

语法

Set-Group
   [-Identity] <GroupIdParameter>
   [-BypassSecurityGroupManagerCheck]
   [-Confirm]
   [-Description <MultiValueProperty>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-IgnoreDefaultScope]
   [-IsHierarchicalGroup <Boolean>]
   [-ManagedBy <GeneralRecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-PhoneticDisplayName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-Universal]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

说明

不能使用 Set-Group cmdlet 修改动态通讯组。若要修改动态通讯组，请使用 Set-DynamicDistributionGroup cmdlet。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

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

此示例将以下更改应用于现有全局安全组“法律部门”：

将组的范围更改为通用。

添加“已验证”的 Notes 参数值。

示例 2

Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1

此示例指定“人力资源”组是一个分层组，并且将在其层次结构中显示最后一个，因为其索引号为 1。

参数

-BypassSecurityGroupManagerCheck

BypassSecurityGroupManagerCheck 开关指定是否允许非组所有者的用户修改或删除组。不必为此开关指定值。

如果未在组的 ManagedBy 属性中定义，则需要在修改或删除组的命令中使用此开关。若要使用此开关，你的帐户需要基于组类型的特定权限：

通讯组或启用邮件的安全组：你需要是组织管理角色组的成员，或者分配有安全组创建和成员身份角色。
通讯组或启用邮件的安全组：你必须是组织管理角色组的成员，或分配有安全组创建和成员资格角色。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

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

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

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

仅当组已启用邮件时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

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

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

边缘传输服务器上不支持 DomainController 参数。边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Identity

Identity 参数指定要修改的组。可以使用任何能够唯一标识该组的值。例如：

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

类型:	GroupIdParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-IgnoreDefaultScope

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

IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置，并将整个林用作范围。不必为此开关指定值。

此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象，但也引入了以下限制：

无法使用 DomainController 参数。此命令自动使用相应的全局编录服务器。
无法使用 DomainController 参数。此命令自动使用相应的全局编录服务器。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsHierarchicalGroup

IsHierarchicalGroup 参数指定组是否属于分层通讯簿。有效值为$true或$false。默认值为 $false。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedBy

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

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

为此参数指定的所有者必须是邮箱、邮件用户或启用邮件的安全组， (可以分配) 权限的已启用邮件的安全主体。可以使用任何能够唯一标识此所有者的值。例如：

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

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

若要在不影响其他现有条目的情况下添加或删除所有者，请使用以下语法： @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}。

使用此参数指定的所有者不会添加为组成员。需要手动将所有者添加为成员。

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

类型:	GeneralRecipientIdParameter[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Notes

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PhoneticDisplayName

PhoneticDisplayName 参数指定在统一消息 (UM) 环境中进行文本到语音转换时使用的用户名的备用拼写。通常在用户名的发音和拼写不匹配时使用此参数。长度不得超过 256 个字符。如果值中有空格，请使用双引号 (") 将此值括起来。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SeniorityIndex

SeniorityIndex 参数指定此组在分层通讯簿中的显示顺序。值为 2 的组在通讯簿中的显示比值为 1 的组要高。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SimpleDisplayName

当仅允许一组有限的字符时，SimpleDisplayName 参数用于显示对象的替代说明。有效字符为：

如果只允许使用一组有限的字符，则 SimpleDisplayName 参数用于显示对象的备用说明。有效字符包括：
a – z
A - Z
空格
" ' ( ) + , - . / : ?

仅当组已启用邮件时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Universal

通用开关将组的范围从 Global 或 DomainLocal 更改为 Universal。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WindowsEmailAddress

WindowsEmailAddress 参数指定此收件人的 Windows 电子邮件地址。这是存在于所有环境（包括没有 Exchange 的环境）中的常见 Active Directory 属性。对收件人使用 WindowsEmailAddress 参数会产生以下结果之一：

在收件人受电子邮件地址策略约束 (EmailAddressPolicyEnabled 属性设置为收件人) 值 True 的环境中，WindowsEmailAddress 参数对 WindowsEmailAddress 属性或主电子邮件地址值没有影响。
在收件人不受电子邮件地址策略约束的环境中， (EmailAddressPolicyEnabled 属性设置为收件人) 的值 False，WindowsEmailAddress 参数会将 WindowsEmailAddress 属性和主电子邮件地址更新为相同的值。

WindowsEmailAddress 属性对于电子邮件属性中的Active Directory 用户和计算机收件人可见。属性公用名为“E-mail-Addresses”，Ldap-Display-Name 为“邮件”。如果在 Active Directory 中修改此属性，则收件人主电子邮件地址不会更新为相同的值。

类型:	SmtpAddress
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。