通过

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

适用：Exchange Online、Exchange Online Protection

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

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

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

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

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

-Alias

适用：Exchange Online、Exchange Online Protection

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

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

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

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

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

别名值与 ExternalDirectoryObjectId 属性值一起追加，并用作 Microsoft 365 Group (<Alias>_<ExternalDirectoryObjectId>) 的 Name 属性值。

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

-AlwaysSubscribeMembersToCalendarEvents

适用：Exchange Online、Exchange Online Protection

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

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

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

AutoSubscribeNewMembers 开关将替代此开关。

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

-AutoSubscribeNewMembers

适用：Exchange Online、Exchange Online Protection

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

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

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

-Classification

适用：Exchange Online、Exchange Online Protection

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

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

-Confirm

适用：Exchange Online、Exchange Online Protection

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

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConvertClosedDlToPrivateGroup

适用：Exchange Online、Exchange Online Protection

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

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

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

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

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

-DataEncryptionPolicy

适用：Exchange Online、Exchange Online Protection

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

  • 名称
  • 可分辨名称 (DN)
  • GUID
类型:DataEncryptionPolicyIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeleteDlAfterMigration

适用：Exchange Online、Exchange Online Protection

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

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

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

-DisplayName

适用：Exchange Online、Exchange Online Protection

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

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

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

-DlIdentity

适用：Exchange Online、Exchange Online Protection

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 Group 的行为就像是设置这些参数的默认值一样， (ReportToManager 是$false和 ReportToOriginator $true) 。 换句话说，传递状态通知 (也称为 DSN、未送达报告、NDR或退回邮件) 发送给邮件发件人，而不是发送给Microsoft 365 组的所有者。

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

-EmailAddresses

适用：Exchange Online、Exchange Online Protection

EmailAddresses 参数指定Microsoft 365 组的所有电子邮件地址 (代理地址) ，包括主 SMTP 地址。 在基于云的组织中，Microsoft 365 组的主要 SMTP 地址和其他代理地址通常由电子邮件地址策略设置。 但是，可以使用此参数为 Microsoft 365 组配置其他代理地址。

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

  • SMTP：主 SMTP 地址。 在命令中只能使用此值一次。
  • SMTP：主 SMTP 地址。此值只能在命令中使用一次。
  • SPO：SharePoint 电子邮件地址。

如果未包含电子邮件地址的 Type 值，则假定该地址是 SMTP 电子邮件地址。 SMTP 电子邮件地址的语法已验证，但不会验证其他电子邮件地址类型的语法。 因此，需要验证任何自定义地址的格式是否正确。

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

  • 在地址上使用“类型”值 SMTP。
  • 不使用任何 Type 值或使用多个小写 smtp Type 值时的第一个电子邮件地址。
  • 请改用 PrimarySmtpAddress 参数。 不能在同一命令中使用 EmailAddresses 参数和 PrimarySmtpAddress 参数。
类型:ProxyAddressCollection
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExecutingUser

适用：Exchange Online、Exchange Online Protection

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

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

-ExoErrorAsWarning

适用：Exchange Online、Exchange Online Protection

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

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

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

-HiddenGroupMembershipEnabled

适用：Exchange Online、Exchange Online Protection

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

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

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

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

-IsMemberAllowedToEditContent

适用：Exchange Online、Exchange Online Protection

{{ Fill IsMemberAllowedToEditContent Description }}

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

-Language

适用：Exchange Online、Exchange Online Protection

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

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

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

-MailboxRegion

适用：Exchange Online、Exchange Online Protection

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

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

-ManagedBy

适用：Exchange Online、Exchange Online Protection

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

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

-Members

适用：Exchange Online、Exchange Online Protection

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

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

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

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

-Name

适用：Exchange Online、Exchange Online Protection

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

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

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

-Notes

适用：Exchange Online、Exchange Online Protection

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

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

-Owner

适用：Exchange Online、Exchange Online Protection

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

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

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID
类型:RecipientIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PrimarySmtpAddress

适用：Exchange Online、Exchange Online Protection

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

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

-RequireSenderAuthenticationEnabled

适用：Exchange Online、Exchange Online Protection

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

  • $true：仅接受来自经过身份验证 (内部) 发件人的邮件。 来自未经身份验证 (外部) 发件人的邮件将被拒绝。
  • $true：只接受经过身份验证的（内部）发件人的邮件。未经身份验证的（外部）发件人的邮件会遭到拒绝。
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SensitivityLabelId

适用：Exchange Online、Exchange Online Protection

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

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

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

-SubscriptionEnabled

适用：Exchange Online、Exchange Online Protection

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

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

-SuppressWarmupMessage

适用：Exchange Online、Exchange Online Protection

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

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

-WhatIf

适用：Exchange Online、Exchange Online Protection

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

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