New-UnifiedGroup

参考

模块:: ExchangePowerShell

适用于:: Exchange Online, Exchange Online Protection

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

使用 New-UnifiedGroup cmdlet 在基于云的组织中创建Microsoft 365 组。若要将成员、所有者和订阅者添加到Microsoft 365 组，请使用 Add-UnifiedGroupLinks cmdlet。

注意：如果使用基于证书的身份验证 Microsoft 365 组 (也称为 CBA 或仅限应用的身份验证进行连接，则不能使用此 cmdlet 来创建) 或 Azure 托管标识的无人参与脚本。可以改为使用 Microsoft Graph。有关详细信息，请参阅创建组。

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

语法

New-UnifiedGroup
   [-DisplayName <String>]
   [-AccessType <ModernGroupTypeInfo>]
   [-MailboxRegion <String>]
   [-Alias <String>]
   [-AlwaysSubscribeMembersToCalendarEvents]
   [-AutoSubscribeNewMembers]
   [-Classification <String>]
   [-Confirm]
   [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-ExecutingUser <RecipientIdParameter>]
   [-ExoErrorAsWarning]
   [-HiddenGroupMembershipEnabled]
   [-IsMemberAllowedToEditContent <System.Boolean>]
   [-Language <CultureInfo>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-Owner <RecipientIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SensitivityLabelId <Sustem.Guid>]
   [-SuppressWarmupMessage]
   [-WhatIf]
   [<CommonParameters>]

New-UnifiedGroup
   [-DisplayName <String>]
   [-AccessType <ModernGroupTypeInfo>]
   [-Alias <String>]
   [-AlwaysSubscribeMembersToCalendarEvents]
   [-AutoSubscribeNewMembers]
   [-Classification <String>]
   [-Confirm]
   [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-ExecutingUser <RecipientIdParameter>]
   [-ExoErrorAsWarning]
   [-HiddenGroupMembershipEnabled]
   [-Language <CultureInfo>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-Owner <RecipientIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SensitivityLabelId <Sustem.Guid>]
   [-SuppressWarmupMessage]
   [-WhatIf]
   [<CommonParameters>]

New-UnifiedGroup
   [-DisplayName <String>]
   [-SubscriptionEnabled]
   [-AccessType <ModernGroupTypeInfo>]
   [-Alias <String>]
   [-AlwaysSubscribeMembersToCalendarEvents]
   [-AutoSubscribeNewMembers]
   [-Classification <String>]
   [-Confirm]
   [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-ExecutingUser <RecipientIdParameter>]
   [-ExoErrorAsWarning]
   [-HiddenGroupMembershipEnabled]
   [-Language <CultureInfo>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-Owner <RecipientIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SensitivityLabelId <Sustem.Guid>]
   [-SuppressWarmupMessage]
   [-WhatIf]
   [<CommonParameters>]

New-UnifiedGroup
   -DlIdentity <DistributionGroupIdParameter>
   [-ConvertClosedDlToPrivateGroup]
   [-DeleteDlAfterMigration]
   [-Confirm]
   [-ExecutingUser <RecipientIdParameter>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Owner <RecipientIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

说明

Microsoft 365 组是跨 Microsoft 365 服务可用的组对象。

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

示例

示例 1

New-UnifiedGroup -DisplayName "Engineering Department" -Alias "engineering"

此示例创建名为“工程部”的新 Microsoft 365 组。

参数

-AccessType

AccessType 参数指定 Microsoft 365 组的隐私类型。有效值包含:

公共：组内容和对话可供所有人使用，任何人都可以在未经组所有者批准的情况下加入组。此值为默认值。
专用：组内容和对话仅对组成员可用，加入组需要组所有者的批准。

你可以在组生命周期的任何时间点更改隐私类型。

注意：尽管用户需要是成员才能参与专用组，但任何人都可以向专用组发送电子邮件，并接收来自专用组的答复。

Type:	ModernGroupTypeInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Alias

Alias 参数指定 Exchange 别名 (也称为 Microsoft 365 组的邮件昵称) 。此值将收件人标识为已启用邮件的对象，且不得与同一个收件人的多个电子邮件地址混淆（也称为代理地址）。收件人只能有一个 Alias 值。最大长度为 64 个字符。

别名值可以包含字母、数字和以下字符：

！、#、%*、+、-、/、=、？、^、_和 ~。
$、 &、、{、} 和|需要 (进行转义，例如 -Alias what`'snew) 或用单引号括起来的整个值 (例如 -Alias 'what'snew') 。 & Azure AD Connect 同步的“别名”值不支持该字符。
句点 (.) 必须用其他有效字符括起来， (例如 help.desk) 。
Unicode 字符 U+00A1 到 U+00FF。

如果在创建 Microsoft 365 组时不使用 Alias 参数，则 DisplayName 参数的值将用于 Alias 值。系统会删除空格，将不受支持的字符转换为问号 (?)，并可能会添加数字以维护 Alias 值的唯一性。

在不使用 EmailAddresses 参数的情况下创建 Microsoft 365 组时，别名值用于生成主电子邮件地址 (alias@domain) 。支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。例如，主电子邮件地址中的 U+00F6 (ö) 更改为 oe 。

别名值追加了 ExternalDirectoryObjectId 属性值，并用作 Microsoft 365 组 (<Alias>_<ExternalDirectoryObjectId>) 的 Name 属性值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-AlwaysSubscribeMembersToCalendarEvents

AlwaysSubscribeMembersToCalendarEvents 开关控制添加到 Microsoft 365 组的新成员的默认订阅设置。

如果使用没有设置值的此开关，则会将添加到组的所有未来成员的订阅设置为 ReplyAndEvents。
如果使用以下确切语法： -AlwaysSubscribeMembersToCalendarEvents:$false，则添加到组的所有未来成员的订阅都将设置为 ReplyOnly。

组成员可以更改他们自己的订阅设置，这将替代此开关的预期使用。

AutoSubscribeNewMembers 开关将替代此开关。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-AutoSubscribeNewMembers

AutoSubscribeNewMembers 开关指定是否自动订阅添加到 Microsoft 365 组的新成员以用于对话和日历事件。不必为此开关指定值。

需要将此开关与 SubscriptionEnabled 开关一起使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Classification

保留此参数以供 Microsoft 内部使用。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ConvertClosedDlToPrivateGroup

ConvertClosedDlToPrivateGroup 开关指定是否将关闭的通讯组迁移到专用 Microsoft 365 组。不必为此开关指定值。

默认情况下，迁移已关闭的通讯组时始终应用此开关，不再需要此开关。

如果通讯组具有 MemberDepartRestriction 或 MemberJoinRestriction 参数的值 Closed，则通讯组将始终迁移到专用 Microsoft 365 组。对于开放通讯组，迁移的 Microsoft 365 组始终是公共的，而不是私有的。

此开关只能与 DlIdentity 参数一起使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-DataEncryptionPolicy

DataEncryptionPolicy 参数指定应用于 Microsoft 365 组的数据加密策略。可以使用任何能够唯一标识该策略的值。例如：

名称
可分辨名称 (DN)
GUID

Type:	DataEncryptionPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-DeleteDlAfterMigration

DeleteDlAfterMigration 开关指定在迁移到 Microsoft 365 组后是否删除通讯组。不必为此开关指定值。

此开关只能与 DlIdentity 参数一起使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-DisplayName

DisplayName 参数指定 Microsoft 365 组的名称。显示名称在 Exchange 管理中心、地址列表和 Outlook 中可见。最大长度为 64 个字符。如果值中有空格，请使用双引号 (") 将此值括起来。

对于Microsoft 365 组，DisplayName 值用于唯一的 Name 属性。但是，由于 DisplayName 值不需要是唯一的，因此在将 DisplayName 值用于 Name 属性时，将附加下划线字符 (_) 和短 GUID 值。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-DlIdentity

DlIdentity 参数指定要迁移到 Microsoft 365 组的通讯组 (也称为通讯组列表或 DL) 。通讯组必须是一个通用通讯组（RecipientTypeDetails 属性值为 MailUniversalDistributionGroup）。可以使用任何能够唯一标识该通讯组的值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
规范 DN
GUID

通讯组的所有属性和成员身份都复制到 Microsoft 365 组。

通讯组的别名和代理地址将移动到 Microsoft 365 组，并在通讯组上替换为值 DLMigrated_<GUID>。原始代理地址将复制到通讯组的 ExtensionCustomAttribute5 属性。

Microsoft 365 组没有 ReportToManager 和 ReportToOriginator 参数，因此这些参数的值不会从通讯组迁移到 Microsoft 365 组。 Microsoft 365 组的行为就像设置这些参数的默认值一样， (ReportToManager 是$false和 ReportToOriginator $true) 。换句话说，传递状态通知 (也称为 DSN、未送达报告、NDR或退回邮件) 发送给邮件发件人，而不是发送给 Microsoft 365 组的所有者。

Type:	DistributionGroupIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EmailAddresses

EmailAddresses 参数指定收件人) 的所有电子邮件地址 (代理地址，包括主 SMTP 地址。在本地 Exchange 组织中，主 SMTP 地址和其他代理地址通常由电子邮件地址策略设置。但是，可以使用此参数为收件人配置其他代理地址。有关详细信息，请参阅 Exchange Server 中的Email地址策略。

此参数的有效语法为 "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN"。可选的'Type 值指定电子邮件地址的类型。有效值的示例包括：

SMTP：主 SMTP 地址。在命令中只能使用此值一次。
SMTP：主 SMTP 地址。此值只能在命令中使用一次。
X400：本地 Exchange 中的 X.400 地址。
X500：本地 Exchange 中的 X.500 地址。

如果未包含电子邮件地址的 Type 值，则假定值为 smtp。请注意，Exchange 不会验证自定义地址类型的语法 (包括 X.400 地址) 。因此，需要验证任何自定义地址的格式是否正确。

如果您没有为电子邮件地址添加值，则系统假定为值 smtp。请注意，exExchangeNoVersion 不验证自定义地址类型（包括 X.400 地址）的语法。因此，您需要验证所有自定义地址的格式是否正确。

在地址上使用“类型”值 SMTP。
不使用任何 Type 值或使用多个小写 smtp Type 值时的第一个电子邮件地址。
请改用 PrimarySmtpAddress 参数。不能在同一命令中使用 EmailAddresses 参数和 PrimarySmtpAddress 参数。

Type:	ProxyAddressCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ExecutingUser

保留此参数以供 Microsoft 内部使用。

Type:	RecipientIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ExoErrorAsWarning

ExoErrorAsWarning 开关指定在创建 Microsoft 365 组时遇到的Exchange Online错误被视为警告，而不是错误。不必为此开关指定值。

创建Microsoft 365 组涉及 Azure Active Directory 和 Exchange Online 中的后台操作。 Exchange Online中可能遇到的错误不会阻止创建组 (因此并不是) 错误，因为 Azure Active Directory 中的组对象已同步回Exchange Online。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-HiddenGroupMembershipEnabled

HiddenGroupMembershipEnabled 开关指定是否对不是组成员的用户隐藏 Microsoft 365 组的成员。不必为此开关指定值。

可以使用此设置来帮助遵守要求你向外部人员隐藏组成员身份 (例如，Microsoft 365 组表示在课堂) 注册的学生。

注意：创建组后将无法更改此设置。如果创建具有隐藏成员身份的组，则以后无法编辑组以向组显示成员身份，反之亦然。此外，敏感度标记策略不支持具有此设置的任何Microsoft 365 组。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsMemberAllowedToEditContent

Type:	System.Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Language

Language 参数指定 Microsoft 365 组的语言首选项。

此参数的有效输入是 Microsoft .NET Framework CultureInfo 类支持的区域性代码值。例如，da-DK 表示丹麦语，ja-JP 表示日语。有关详细信息，请参阅 CultureInfo 类。

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MailboxRegion

MailboxRegion 参数指定多地理位置环境中 Microsoft 365 组的首选数据位置 (PDL) 。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ManagedBy

保留此参数以供 Microsoft 内部使用。

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Members

Members 参数指定属于 Microsoft 365 组成员 (启用邮件的对象) 收件人。可以使用任何能够唯一标识该收件人的值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
规范 DN
GUID

Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Name

此参数已被弃用，将不再使用。

以前，如果为此参数指定了值，则会添加一个随机 GUID 值，并将其用作 Microsoft 365 组 (Name_<RandomGUID>) 的 Name 属性值。现在，Name 属性的值由 Alias 参数值和 ExternalDirectoryObjectId 属性值填充 (<Alias>_<ExternalDirectoryObjectId>) 。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Notes

Notes 参数指定 Microsoft 365 组的说明。如果值包含空格，则使用引号括住该值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Owner

Owner 参数指定 Microsoft 365 组的。所有者是具有某些特权（例如编辑组属性的能力）的组成员。

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

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
规范 DN
GUID

Type:	RecipientIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PrimarySmtpAddress

PrimarySmtpAddress 参数指定对收件人使用的主要返回电子邮件地址。不能在同一命令中使用 EmailAddresses 和 PrimarySmtpAddress 参数。

Type:	SmtpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RequireSenderAuthenticationEnabled

RequireSenderAuthenticationEnabled 参数指定是否仅接受来自经过身份验证 (内部) 发件人的消息。有效值包含:

$true：仅接受来自经过身份验证 (内部) 发件人的邮件。来自未经身份验证 (外部) 发件人的邮件将被拒绝。
$true：只接受经过身份验证的（内部）发件人的邮件。未经身份验证的（外部）发件人的邮件会遭到拒绝。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SensitivityLabelId

SensitivityLabelId 参数指定分配给 Microsoft 365 组的敏感度标签的 GUID 值。

注意：在 Get-UnifiedGroup cmdlet 的输出中，此属性名为 SensitivityLabel，而不是 SensitivityLabelId。

Type:	System.Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SubscriptionEnabled

SubscriptionEnabled 开关指定是否为 Microsoft 365 组启用对对话和日历事件的订阅。不必为此开关指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SuppressWarmupMessage

此参数已被弃用，将不再使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

通过

New-UnifiedGroup

语法

说明

示例

示例 1

参数

-AccessType

-Alias

-AlwaysSubscribeMembersToCalendarEvents

-AutoSubscribeNewMembers

-Classification

-Confirm

-ConvertClosedDlToPrivateGroup

-DataEncryptionPolicy

-DeleteDlAfterMigration

-DisplayName

-DlIdentity

-EmailAddresses

-ExecutingUser

-ExoErrorAsWarning

-HiddenGroupMembershipEnabled

-IsMemberAllowedToEditContent

-Language

-MailboxRegion

-ManagedBy

-Members

-Name

-Notes

-Owner

-PrimarySmtpAddress

-RequireSenderAuthenticationEnabled

-SensitivityLabelId

-SubscriptionEnabled

-SuppressWarmupMessage

-WhatIf

反馈

其他资源