共用方式為

New-DynamicDistributionGroup

模組:
Exchange PowerShell

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。

使用 New-DynamicDistributionGroup 指令碼來建立動態分配群組。 動態分發群組會查詢支援郵件的物件，並根據結果建立群組成員資格。 每當收到電子郵件發送給群組時，群組成員資格會被重新計算。

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

語法

PrecannedFilter 

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

CustomFilter 

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 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

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

此範例建立一個名為 Marketing Group 的動態分發群組，包含所有部門欄位等於「Marketing」或「Sales」字串的收件人。 因為我們沒有使用 OrganizationalUnit 或 RecipientContainer 參數，群組通常會在預設位置 (Users 容器) 尋找接收者。

範例 2

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

此範例建立一個動態的分發群組，稱為華盛頓管理團隊，包含位於華盛頓州、職稱以「Director」或「Manager」開頭的組織單位中所有名為北美洲的使用者。

參數

-Alias

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

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

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

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

如果您修改了現有收件人的別名值，主要電子郵件地址僅在該收件人受電子郵件政策影響的環境中自動更新， (EmailAddressPolicyEnabled 屬性對該收件人) 為 True。

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ArbitrationMailbox

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

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

參數屬性

類型:MailboxIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCompany

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCompany 參數指定一個預設過濾器，基於接收者公司屬性的值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute1

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute1 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute1 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute10

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute10 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute10 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute11

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute11 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute11 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute12

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute12 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute12 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute13

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute13 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute13 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute14

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute14 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute14 屬性的值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute15

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute15 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute15 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute2

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute2 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute2 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute3

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute3 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute3 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute4

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute4 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute4 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute5

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute5 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute5 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute6

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute6 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute6 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute7

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute7 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute7 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute8

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute8 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute8 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalCustomAttribute9

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalCustomAttribute9 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute9 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalDepartment

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalDepartment 參數指定一個預設過濾器，該過濾器基於接收者的 Department 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConditionalStateOrProvince

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ConditionalStateOrProvince 參數指定一個預設過濾器，該過濾器基於接收者的 StateOrProvince 屬性值。 您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DirectMembershipOnly

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

此參數只能在雲端式服務中使用。

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

參數屬性

類型:Boolean
預設值:False
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DisplayName

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

DisplayName 參數指定動態分發群組的顯示名稱。 顯示名稱可在 Exchange 管理中心及地址列表中顯示。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。

如果您未使用 DisplayName 參數，則 Name 參數的值會用於顯示名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IncludedRecipients

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

IncludedRecipients 參數指定一個預設的過濾器，該過濾器基於接收者類型。 有效值為：

  • AllRecipients：此值僅能單獨使用。
  • MailboxUsers
  • 郵件聯絡人
  • 郵件群組
  • MailUsers
  • MailUsers

您可以指定多個以逗號分隔的值。 當你使用多個值時，會套用 OR 布林運算子。

當你使用任何條件參數作為預設過濾器的一部分時，都需要使用這個參數。 你不能將此參數與 RecipientFilter 參數 (一起使用，後者用於建立自訂的 OPATH 過濾器) 。

參數屬性

類型:WellKnownRecipientType
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PrecannedFilter
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ModeratedBy

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ModeratedBy 參數會指定此收件者的一或多位仲裁者。 傳送給此收件者的郵件必須先經過仲裁者核准才能傳遞。 仲裁者必須是組織中的信箱、郵件使用者或郵件連絡人。 您可以使用唯一識別仲裁者的任何值。 例如：

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

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

當你將 ModerationEnabled 參數設為 $true 值時，你用這個參數來指定至少一個 moderator。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ModerationEnabled

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

ModerationEnabled 參數指定該收件人是否啟用 moderation。 有效值為：

  • $true：此收件人已啟用版主權限。 發送給該收件人的訊息必須經版主批准後才能送達。
  • $false：此收件人已停用版主權限。 發送給此收件人的訊息未經版主批准即可送達。 這個值是預設值。

你可以用 ModeratedBy 參數來指定 moderator。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

名稱參數指定動態分布群的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。

如果您未使用 DisplayName 參數，此值也會用於 DisplayName 內容。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OrganizationalUnit

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

OrganizationalUnit 參數指定 OU (組織單位) 動態分配群組的建立單位。

此參數的有效輸入是由 Get-OrganizationalUnit 指令碼返回 (OU) 或領域中的組織單位。 您可以使用唯一識別 OU 或網域的任何值。 例如：

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

如果你不使用這個參數，預設值通常是你所連接的 Exchange 伺服器網域中的 Users 容器， (也就是所謂的接收範圍) 。 在本地 Exchange，你可以使用 Set-AdServerSettings cmdlet 更改目前 PowerShell 會話的接收範圍。

如果你不使用 RecipientContainer 參數，動態分發群組的位置會被用作 RecipientContainer 屬性 (預設位置，或你為 OrganizationalUnit 參數) 指定的值。

注意：雖然此參數在 Exchange Online 中可用，但 Exchange Online 組織中只有一個可用的 OU，因此使用此參數不會產生影響。

參數屬性

類型:OrganizationalUnitIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PrimarySmtpAddress

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

PrimarySmtpAddress 參數會指定用於收件者的主要回覆電子郵件地址。

參數屬性

類型:SmtpAddress
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RecipientContainer

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

RecipientContainer 參數指定一個基於收件人在 Active Directory 中位置的過濾器。 此參數的有效輸入是由 Get-OrganizationalUnit 指令碼返回 (OU) 或領域中的組織單位。 您可以使用唯一識別 OU 或網域的任何值。 例如：

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

GUID

RecipientContainer 屬性不能是空白。 群組只能在特定地點尋找收件人， (你為此參數指定的值，或群組建立的地點) 。

注意：雖然此參數在 Exchange Online 中可用，但 Exchange Online 組織中只有一個可用的 OU，因此使用此參數不會產生影響。

參數屬性

類型:OrganizationalUnitIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RecipientFilter

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

RecipientFilter 參數指定一個自訂的 OPATH 過濾器，該過濾器基於任何可用接收者屬性的值。 你可以使用任何可用的 Windows PowerShell 運算子，並且支援萬用字組和部分匹配。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。

  • 將整個 OPATH 濾波器包在雙引號中 “”。 如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
  • Property 是可篩選的屬性。 關於可篩選屬性，請參見 RecipientFilter 參數的可篩選屬性。
  • ComparisonOperator 是一種 OPATH 比較運算子，例如用於等值和-like字串比較) (-eq。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。
  • 價值是要篩選的房產價值。 以單引號括住文字值和變數 ('Value' 或 '$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用 '$($User -Replace "'","''")'，而不是 '$User'。 不要用引號包住整數或系統值， (例如，使用500、、$true$false，或 $null) 。
  • 在雲端環境中，你不能用萬用卡作為第一個角色。 例如， 'Sales*' 是允許的，但 '*Sales' 又不允許。
  • 在本地 Exchange 中，萬用字元僅作為第一個或最後一個字元有效。 例如， 'Sales*''*Sales' 或是被允許，但 'Sa*les' 不被允許。

欲了解 Exchange 中 OPATH 過濾器的詳細資訊，請參見 「額外 OPATH 語法資訊」。

你不能將此參數與 IncludedRecipients 參數或任何用於建立預設過濾器 (的條件參數一起使用，) 。

RecipientFilter 屬性的最大長度為 2048 字元，包含內部語法。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CustomFilter
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SendModerationNotifications

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

系統會將用戶端連線從用戶端存取服務 Proxy 處理到本機或遠端信箱伺服器上的後端服務。 有效值為：

  • 永遠：當訊息未被批准時，請通知所有寄件人。 這個值是預設值。
  • Always：在所有寄件者的郵件未獲核准時加以通知。此為預設值。
  • Internal：在組織中寄件者的郵件未獲核准時加以通知。

此參數僅在啟用 moderation 時有意義 (且 ModerationEnabled 參數的值為 $true) 。

參數屬性

類型:TransportModerationNotificationFlags
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地安全外掛信箱

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。