New-UnifiedGroup

參考

模組:: ExchangePowerShell

適用於:: Exchange Online, Exchange Online Protection

此指令程式只能在雲端式服務中使用。

使用 New-UnifiedGroup Cmdlet 在雲端式組織中建立Microsoft 365 群組。若要將成員、擁有者和訂閱者新增至Microsoft 365 群組，請使用 Add-UnifiedGroupLinks Cmdlet。

注意：如果您使用憑證式驗證連線， (也稱為 CBA 或自動腳本的僅限應用程式驗證) 或 Azure 受控識別，則無法使用此 Cmdlet 來建立Microsoft 365 群組。取而代之，您可以使用 Microsoft Graph。如需詳細資訊，請參閱建立群組。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

Microsoft 365 群組是跨 Microsoft 365 服務提供的群組物件。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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 群組的郵件昵稱) 。此值會將收件者識別為啟用郵件的物件，且不應與相同收件者 (也稱為 proxy 位址) 的多個電子郵件地址混淆。收件者只能有一個別名值。最大長度為 64 個字元。

別名值可以包含字母、數位和下列字元：

！、#、% *、+、-、/、=、？、^、_和 ~。
$、 & 、'、'、{、}和 | 必須逸出 (例如 -Alias what`'snew) 或以單引號括住的整個值 (例如 -Alias 'what'snew' ，) 。 &Azure AD Connect 同步處理的別名值不支援字元。
(.) 的句號必須以其他有效字元括住， help.desk 例如) (。
Unicode 字元 U+00A1 至 U+00FF。

如果您在建立 Microsoft 365 群組時未使用 Alias 參數，DisplayName 參數的值會用於別名值。空格遭到移除、不支援的字元會轉換成問號 (?)，而且可能會加入數字以維護 Alias 值的唯一性。

當您在不使用 EmailAddresses 參數的情況下建立 Microsoft 365 群組時，會使用 Alias 值來產生主要電子郵件地址 (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 群組。

通訊群組的別名和 Proxy 位址會移至 Microsoft 365 群組，並在通訊群組上以值 DLMigrated_<GUID> 取代。原始 Proxy 位址會複製到通訊群組的 ExtensionCustomAttribute5 屬性。

Microsoft 365 群組沒有 ReportToManager 和 ReportToOriginator 參數，因此這些參數的值不會從通訊群組移轉至 Microsoft 365 群組。 Microsoft 365 群組的行為就像是設定這些參數的預設值 (ReportToManager 是$false且 ReportToOriginator 是$true) 。換句話說，傳遞狀態通知 (也稱為 DSN、非傳遞報告、DDR 或退回的郵件) 會傳送給郵件寄件者，而不是 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 參數會指定收件者 (Proxy 位址) 的所有電子郵件地址，包括主要 SMTP 位址。在內部部署 Exchange 組織中，主要 SMTP 位址和其他 Proxy 位址通常是由電子郵件地址原則所設定。不過，您可以使用此參數來設定收件者的其他 Proxy 位址。如需詳細資訊，請參閱Email Exchange Server中的位址原則。

此參數的有效語法為 "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 地址) 的語法。因此，您需要確認所有自訂地址的格式是否正確。

使用位址上的 Type 值 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

您可以輸入多個以逗號分隔的值。如果值包含空格或需要引號，請使用下列語法： "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

Syntax

Description

範例

範例 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

意見反應

其他資源