New-DynamicDistributionGroup
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 New-DynamicDistributionGroup Cmdlet 建立動態通訊群組。 動態通訊群組會查詢已啟用郵件功能的物件,並根據結果建立群組成員資格。 每當電子郵件訊息傳送至群組時,群組成員資格就會重新計算。
如需下方<語法>一節中參數集的詳細資訊,請參閱 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>]
[-ManagedBy <GeneralRecipientIdParameter>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-Notes <String>]
[-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>]
[-ManagedBy <GeneralRecipientIdParameter>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-Notes <String>]
[-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"
此範例會建立名為 Washington Management Team 的動態通訊群組,其中包含來自華盛頓州北美洲的組織單位中,頭銜開頭為「總監」或「經理」的所有使用者。
參數
-Alias
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
Alias 參數會指定收件者的 Exchange 別名 (也稱為郵件暱稱) 。 這個值會將收件者識別為已啟用郵件的物件,而且不應與相同收件者的多個電子郵件地址混淆 (也稱為 Proxy 位址) 。 一個收件者只能有一個別名值。 最大長度為 64 個字元。
[別名] 值可以包含字母、數字及下列字元:
- !、#、%,*、+、-、/、=、?、^、_ 和 ~。
- $、&、'、'、{、} 和 |例如,必須逸出 (
-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 的環境中,才會自動更新主要電子郵件地址。
Alias 參數永遠不會產生或更新郵件連絡人或郵件使用者的主要電子郵件地址。
參數屬性
| 類型: | 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 參數 (結合使用,後者是用來建立自訂 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 |
| 別名: | CF |
參數集
(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 布林值運算子。
當您使用任何 [條件式] 參數做為預先儲存篩選的一部分時,您必須使用此參數。 您無法將此參數與用來建立自訂 OPATH 篩選) 的 RecipientFilter 參數 (結合使用。
參數屬性
| 類型: | WellKnownRecipientType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ManagedBy
適用項目:Exchange Online、Exchange Online Protection
此參數只能在雲端式服務中使用。
{{ 填滿 ManagedBy 描述 }}
參數屬性
| 類型: | GeneralRecipientIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | 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 時,您可以使用此參數指定至少一個仲裁者。
參數屬性
| 類型: | 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 參數會指定是否為此收件者啟用仲裁。 有效值為:
- $true:已對此收件者啟用仲裁。 傳送給此收件者的郵件必須先經主持人的核准,郵件才會傳遞。
- $false:已停用此收件者的仲裁。 傳送給此收件者的郵件未經仲裁者核准即可傳遞。 此值為預設值。
您可以使用 ModeratedBy 參數來指定仲裁者。
參數屬性
| 類型: | 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、內部部署的內建安全性附加元件信箱
Name 參數會指定動態通訊群組的唯一名稱。 最大長度為 64 個字元。 如果值包含空格,請使用引號 (") 括住值。
如果您未使用 DisplayName 參數,此值也會用於 DisplayName 內容。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Notes
適用項目:Exchange Online、Exchange Online Protection
此參數只能在雲端式服務中使用。
{{ 填寫筆記描述 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | 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 Cmdlet 傳回的組織單位 (OU) 或網域。 您可以使用唯一識別 OU 或網域的任何值。 例如:
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
如果不使用此參數,預設值通常是連線至 Exchange 伺服器網域中的使用者容器 (也稱為收件者範圍) 。 在內部部署 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 Cmdlet 傳回的組織單位 (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 比較運算子 (例如
-eq,用於等號和-like字串比較) 。 如需比較運算子的詳細資訊,請參閱 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:在組織中寄件者的郵件未獲核准時加以通知。
只有在啟用仲裁 (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 |
| 別名: | WI |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。