New-UnifiedGroup
此指令程式只能在雲端式服務中使用。
使用 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 位址。 因此，您必須確認已正確格式化任何自訂位址。
如果您未包含電子郵件地址的
- 使用位址上的 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
{{ Fill IsMemberAllowedToEditContent Description }}
| 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 |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應