New-UnifiedGroup

語法

Identity (預設值)

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

ProvisioningOptions

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

SegmentationOption

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

DlMigration

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

Description

範例

範例 1

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

參數

-AccessType

適用：Exchange Online，內建本地信箱安全外掛

AccessType 參數指定了 Microsoft 365 群組的隱私類型。 有效值為：

• 公開：群組內容和對話對所有人開放，任何人都可以在沒有群組擁有者同意的情況下加入群組。 這個值是預設值。
• 私人：群組內容與對話僅限群組成員使用，加入群組需獲得群組擁有者的批准。

您可以在群組生命週期中的任何一點變更隱私類型。

注意：雖然用戶必須是會員才能參與私人群組，但任何人都可以向私人群組發送電子郵件，並收到該群組的回覆。

參數屬性

參數集

-Alias

適用：Exchange Online，內建本地信箱安全外掛

Alias 參數指定了 Exchange 別名 (也稱為郵件暱稱) ，適用於 Microsoft 365 群組。 此值識別收件人為啟用郵件的物件，不應與同一收件人的多個電子郵件地址混淆 (也稱為代理地址) 。 收件人只能有一個別名值。 最大長度為 64 個字元。

Alias 值可包含字母、數字及以下字元：

• ！， #， %; *， +， -， /， =， ？， ^， _， and ~。
• $， &， '， '， {， }， and |例如，需要 (-Alias what`'snew) 或以單引 (-Alias 'what'snew' 號包裹的整個值，例如) 。 & 字元不支援 Microsoft Entra 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 為。

Alias 值會附加 ExternalDirectoryObjectId 屬性值，並作為 Microsoft 365 群組 (<Alias>_<ExternalDirectoryObjectId>) 的名稱屬性值。

參數屬性

參數集

-AlwaysSubscribeMembersToCalendarEvents

適用：Exchange Online，內建本地信箱安全外掛

AlwaysSubscribeMembersToCalendarEvents 開關控制新加入 Microsoft 365 群組成員的預設訂閱設定。

• 如果你使用這個開關但沒有設定值，所有未來加入群組的成員訂閱都會設定為 ReplyAndEvents。
• 如果你使用這個語法 -AlwaysSubscribeMembersToCalendarEvents:$false：，所有未來加入群組的成員訂閱都設定為僅回覆。

群組成員可以更改自己的訂閱設定，這可能會覆蓋你原本打算使用這個開關的用途。

AutoSubscribeNewMembers 交換器會覆蓋此交換。

參數屬性

參數集

-AutoSubscribeNewMembers

適用：Exchange Online，內建本地信箱安全外掛

AutoSubscribeNewMembers 開關會指定是否自動訂閱新增到 Microsoft 365 群組的新成員到對話和行事曆事件。 您不需要使用此參數指定值。

您不需要將此參數與 SubscriptionEnabled 參數一起使用。

參數屬性

參數集

-Classification

適用：Exchange Online，內建本地信箱安全外掛

將保留此參數供 Microsoft 內部使用。

參數屬性

參數集

-Confirm

適用：Exchange Online，內建本地信箱安全外掛

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

• 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
• 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

參數集

-ConvertClosedDlToPrivateGroup

適用：Exchange Online，內建本地信箱安全外掛

ConvertClosedDlToPrivateGroup 交換器會指定是否要將封閉的發行群組遷移到私有的 Microsoft 365 群組。 您不需要使用此參數指定值。

預設情況下，此切換在遷移封閉分發群組時始終套用，且不再必要。

若分發群組的 MemberDepartRestricted 或 MemberJoinRestriction 參數值為 Closed，則該分發群組總是會遷移到私人的 Microsoft 365 群組。 對於開放的發行群組，遷移後的 Microsoft 365 群組始終是公開的，而非私人的。

您只能將此參數與 DlIdentity 參數一起使用。

參數屬性

參數集

-DataEncryptionPolicy

適用：Exchange Online，內建本地信箱安全外掛

DataEncryptionPolicy 參數指定了套用到 Microsoft 365 群組的資料加密政策。 您可以使用唯一識別原則的任何值。 例如：

• 名稱
• 辨別名稱 (DN)
• GUID

參數屬性

參數集

-DeleteDlAfterMigration

適用：Exchange Online，內建本地信箱安全外掛

DeleteDlAfterMigration 交換器會指定是否在遷移到 Microsoft 365 群組後刪除該群組。 您不需要使用此參數指定值。

您只能將此參數與 DlIdentity 參數一起使用。

參數屬性

參數集

-DisplayName

適用：Exchange Online，內建本地信箱安全外掛

DisplayName 參數指定 Microsoft 365 群組的名稱。 顯示名稱可在 Exchange 管理中心、地址清單及 Outlook 中看到。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。

對於 Microsoft 365 群組，DisplayName 值會用於獨特的 Name 屬性。 然而，由於 DisplayName 值不需要唯一，當 DisplayName 屬性使用時，會加上底線字元 (_) 和一個簡短的 GUID 值。

參數屬性

參數集

-DlIdentity

適用：Exchange Online，內建本地信箱安全外掛

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 群組的擁有者。

參數屬性

參數集

-EmailAddresses

適用：Exchange Online，內建本地信箱安全外掛

EmailAddresses 參數指定了 Microsoft 365 群組所有) (代理地址的電子郵件地址，包括主要的 SMTP 地址。 在雲端組織中，Microsoft 365 群組的主要 SMTP 位址及其他代理位址通常由電子郵件地址政策設定。 不過，你可以用這個參數來設定 Microsoft 365 群組的其他代理位址。

此參數的有效語法為 "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN"。 可選 Type 值則指定電子郵件地址的類型。 有效價值的例子包括：

• SMTP：主要的 SMTP 位址。 這個值在指令中只能使用一次。
• SMTP：主要 SMTP 地址。在命令中，您只能使用這個值一次。
• SPO：SharePoint 電子郵件地址。

若未包含電子郵件地址的類型值，該地址即視為 SMTP 電子郵件地址。 SMTP 電子郵件地址的語法會被驗證，但其他電子郵件地址類型的語法則不會被驗證。 因此，你需要確認任何自訂地址的格式是否正確。

如果您未包含電子郵件地址的 值，則假設為 smtp 值。請注意，exExchangeNoVersion 不會驗證自訂地址類型 (包括 X.400 地址) 的語法。因此，您需要確認所有自訂地址的格式是否正確。

• 在位址上使用 Type 值 SMTP。
• 第一個電子郵件地址是你不使用任何 Type 值，或是使用多個小寫 smtp Type 值時。
• 改用 PrimarySmtpAddress 參數。 你不能在同一指令中使用 EmailAddresses 參數和 PrimarySmtpAddress 參數。

參數屬性

參數集

-ExecutingUser

適用：Exchange Online，內建本地信箱安全外掛

將保留此參數供 Microsoft 內部使用。

參數屬性

參數集

-ExoErrorAsWarning

適用：Exchange Online，內建本地信箱安全外掛

ExoErrorAsWarning 交換器規定，您在建立 Microsoft 365 群組時遇到的 Exchange Online 錯誤，將視為警告而非錯誤。 您不需要使用此參數指定值。

建立 Microsoft 365 群組涉及在 Microsoft Entra ID 和 Exchange Online 中的背景操作。 你在 Exchange Online 遇到的錯誤不會阻止群組 (的建立，因此不算真正的錯誤) ，因為 Microsoft Entra ID 中的群組物件已同步回 Exchange Online。

參數屬性

參數集

-HiddenGroupMembershipEnabled

適用：Exchange Online，內建本地信箱安全外掛

HiddenGroupMembershipEnabled 交換器會指定是否要對非群組成員的使用者隱藏 Microsoft 365 群組的成員。 您不需要使用此參數指定值。

你可以利用這個設定來協助遵守規定，要求你對外人隱藏群組成員身份，例如 (代表班級) 學生的 Microsoft 365 群組。

注意：建立群組之後，無法變更此設定。 如果你用隱藏的成員身份建立群組，之後無法編輯群組來揭露成員身份，反之亦然。 此外，任何帶有隱藏群組成員資格的 Microsoft 365 群組都不被敏感度標籤政策所支援。

參數屬性

參數集

-IsMemberAllowedToEditContent

適用：Exchange Online，內建本地信箱安全外掛

{{ 填寫 IsMemberPermitedToEditContent 描述 }}

參數屬性

參數集

-Language

適用：Exchange Online，內建本地信箱安全外掛

Language 參數指定 Microsoft 365 群組的語言偏好。

此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。

參數屬性

參數集

-MailboxRegion

適用：Exchange Online，內建本地信箱安全外掛

MailboxRegion 參數指定了 Microsoft 365 群組在多地理環境中 PDL) (偏好的資料位置。

參數屬性

參數集

-ManagedBy

適用：Exchange Online，內建本地信箱安全外掛

將保留此參數供 Microsoft 內部使用。

參數屬性

參數集

-Members

適用：Exchange Online，內建本地信箱安全外掛

成員參數指定 (郵件啟用物件) 的收件人，這些物件是 Microsoft 365 群組的成員。 您可以使用唯一識別收件者的任何值。 例如：

• 名稱
• 別名
• 辨別名稱 (DN)
• 辨別名稱 (DN)
• 標準 DN
• GUID

您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號，請使用下列語法: "Value1","Value2",..."ValueN"。

參數屬性

參數集

-Name

適用：Exchange Online，內建本地信箱安全外掛

此參數已不再使用。

過去若你為此參數指定值，會加入一個隨機的 GUID 值，作為 Microsoft 365 群組 (Name_<RandomGUID>) 的名稱屬性值。 現在，Name 屬性的值由 Alias 參數值和 ExternalDirectoryObjectId 屬性值 (<Alias>_<ExternalDirectoryObjectId>) 填充。

參數屬性

參數集

-Notes

適用：Exchange Online，內建本地信箱安全外掛

Notes 參數指定了 Microsoft 365 群組的描述。 如果值包含空格，請使用引號括住值。

參數屬性

參數集

-Owner

適用：Exchange Online，內建本地信箱安全外掛

擁有者參數指定了 Microsoft 365 群組的 。 擁有者是擁有特定權限的群組成員，例如編輯群組屬性的能力。

您為此參數指定的擁有者必須是信箱或郵件使用者 (可接受權限指派且已啟用郵件功能的安全性主體)。 您可以使用唯一識別擁有者的任何值。 例如：

• 名稱
• 別名
• 辨別名稱 (DN)
• 辨別名稱 (DN)
• 標準 DN
• GUID

參數屬性

參數集

-PrimarySmtpAddress

適用：Exchange Online，內建本地信箱安全外掛

PrimarySmtpAddress 參數會指定用於收件者的主要回覆電子郵件地址。 你不能在同一個指令中使用 EmailAddresses 和 PrimarySmtpAddress 參數。

參數屬性

參數集

-RequireSenderAuthenticationEnabled

適用：Exchange Online，內建本地信箱安全外掛

RequireSenderAuthenticationEnabled 參數指定是否只接受來自已認證 (內部) 發送者的訊息。 有效值為：

• $true：訊息僅接受來自已認證 (內部) 發送者。 來自未經驗證 (外部) 寄件者的訊息會被拒絕。
• $true：只接受來自驗證過 (內部) 寄件者的郵件。來自未經驗證 (外部) 寄件者的郵件會遭到拒絕。

參數屬性

參數集

-SensitivityLabelId

適用：Exchange Online，內建本地信箱安全外掛

SensitivityLabelId 參數指定指派給 Microsoft 365 群組的敏感度標籤的 GUID 值。

注意：在 Get-UnifiedGroup cmdlet 的輸出中，這個屬性被命名為 SensitivityLabel，而非 SensitivityLabelId。

參數屬性

參數集

-SubscriptionEnabled

適用：Exchange Online，內建本地信箱安全外掛

SubscriptionEnabled 開關會指定是否啟用 Microsoft 365 群組的對話與行事曆事件訂閱。 您不需要使用此參數指定值。

參數屬性

參數集

-SuppressWarmupMessage

適用：Exchange Online，內建本地信箱安全外掛

此參數已不再使用。

參數屬性

參數集

-WhatIf

適用：Exchange Online，內建本地信箱安全外掛

WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

參數屬性

參數集

CommonParameters