New-DynamicDistributionGroup

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 New-DynamicDistributionGroup Cmdlet 來建立動態通訊群組。動態通訊群組會查詢啟用郵件功能的物件，並根據結果建置群組成員資格。每當電子郵件訊息傳送至群組時，就會重新計算群組成員資格。

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

Syntax

New-DynamicDistributionGroup
   [-Name] <String>
   -IncludedRecipients <WellKnownRecipientType>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-ConditionalCompany <MultiValuedProperty>]
   [-ConditionalCustomAttribute1 <MultiValuedProperty>]
   [-ConditionalCustomAttribute10 <MultiValuedProperty>]
   [-ConditionalCustomAttribute11 <MultiValuedProperty>]
   [-ConditionalCustomAttribute12 <MultiValuedProperty>]
   [-ConditionalCustomAttribute13 <MultiValuedProperty>]
   [-ConditionalCustomAttribute14 <MultiValuedProperty>]
   [-ConditionalCustomAttribute15 <MultiValuedProperty>]
   [-ConditionalCustomAttribute2 <MultiValuedProperty>]
   [-ConditionalCustomAttribute3 <MultiValuedProperty>]
   [-ConditionalCustomAttribute4 <MultiValuedProperty>]
   [-ConditionalCustomAttribute5 <MultiValuedProperty>]
   [-ConditionalCustomAttribute6 <MultiValuedProperty>]
   [-ConditionalCustomAttribute7 <MultiValuedProperty>]
   [-ConditionalCustomAttribute8 <MultiValuedProperty>]
   [-ConditionalCustomAttribute9 <MultiValuedProperty>]
   [-ConditionalDepartment <MultiValuedProperty>]
   [-ConditionalStateOrProvince <MultiValuedProperty>]
   [-Confirm]
   [-DirectMembershipOnly <Boolean>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]

New-DynamicDistributionGroup
   [-Name] <String>
   -RecipientFilter <String>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DirectMembershipOnly <Boolean>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]

Description

搭配 IncludedRecipients 參數使用的 Conditional 參數受到以下限制：

EQV 運算子用於每個屬性值，如同 "Department equals Sales"。不支援萬用字元和部分相符項目。
OR 運算子一律用於相同屬性的多個值 (如同 "Department equals Sales OR Marketing")。
AND 運算子一律用於多個屬性 (如同 "Department equals Sales AND Company equals Contoso")。

若要建立使用任何可用收件者屬性且不受這些限制的彈性篩選，您可以使用 RecipientFilter 參數來建立自訂 OPATH 篩選。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

New-DynamicDistributionGroup -Name "Marketing Group" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalDepartment "Marketing","Sales"

此範例會建立名為 Marketing Group 的動態通訊群組，其中包含 Department 欄位等於「Marketing」或「Sales」字串的所有收件者。因為我們未使用 OrganizationalUnit 或 RecipientContainer 參數，所以群組通常會在預設位置中尋找收件者 (使用者容器) 。

範例 2

New-DynamicDistributionGroup -Name "Washington Management Team" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"

此範例會建立名為 Washington Management Team 的動態通訊群組，其中包含組織單位中名稱為北美洲的所有使用者，其標題開頭為「Director」或「Manager」。

參數

-Alias

Alias 參數會指定 Exchange 別名 (也稱為收件者的郵件昵稱) 。此值會將收件者識別為啟用郵件的物件，且不應與相同收件者 (也稱為 proxy 位址) 的多個電子郵件地址混淆。收件者只能有一個別名值。最大長度為 64 個字元。

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

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

當您建立收件者但未指定電子郵件地址時，您指定的別名值會用來產生主要電子郵件地址 (alias@domain) 。支援的 Unicode 字元會對應到最合適的 US-ASCII 文字字元。例如，主要電子郵件地址中的 U+00F6 (ö) 會變更為 oe 。

如果您在建立收件者時未使用 Alias 參數，則會針對 Alias 屬性值使用不同必要參數的值：

具有使用者帳戶的收件者 (例如，使用者信箱和郵件使用者) ：使用 MicrosoftOnlineServicesID 或 UserPrincipalName 參數的左側。例如， helpdesk@contoso.onmicrosoft.com 會產生 Alias 屬性值 helpdesk 。
沒有使用者帳戶的收件者 (例如，會議室信箱、郵件連絡人和通訊群組) ：使用 Name 參數的值。空格會移除，不支援的字元會轉換成問號 (？) 。

如果您修改現有收件者的 Alias 值，主要電子郵件地址只會在收件者受限於電子郵件地址原則的環境中自動更新， (收件者) 的 EmailAddressPolicyEnabled 屬性為 True。

Alias 參數永遠不會產生或更新郵件連絡人或郵件使用者的主要電子郵件地址。

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

-ArbitrationMailbox

此參數僅適用於內部部署 Exchange。

ArbitrationMailbox 參數會指定用來管理這位收件者之仲裁程序的仲裁信箱。您可以使用唯一識別仲裁信箱的任何值。例如：

名稱
別名
辨別名稱 (DN)
辨別名稱 (DN)
Domain\Username
電子郵件地址
GUID
LegacyExchangeDN
SamAccountName
使用者識別碼或使用者主要名稱 (UPN)

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019