New-EmailAddressPolicy

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

使用 New-EmailAddressPolicy Cmdlet 建立電子郵件地址原則。 在 Exchange Online 中,電子郵件地址原則僅適用於 Microsoft 365 群組。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。

語法

AllTemplatesWithPrecannedFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
    -IncludedRecipients <WellKnownRecipientType>
    [-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]
    [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

AllTemplatesWithCustomFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
    -RecipientFilter <String>
    [-Confirm]
    [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

SMTPTemplateWithPrecannedFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledPrimarySMTPAddressTemplate <String>
    -IncludedRecipients <WellKnownRecipientType>
    [-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]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

SMTPTemplateWithCustomFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledPrimarySMTPAddressTemplate <String>
    -RecipientFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

AllTemplatesForUnifiedGroupRecipientsFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
    [-IncludeUnifiedGroupRecipients]
    [-ManagedByFilter <String>]
    [-Confirm]
    [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

SMTPTemplateForUnifiedGroupRecipientsFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledPrimarySMTPAddressTemplate <String>
    [-IncludeUnifiedGroupRecipients]
    [-ManagedByFilter <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

在內部部署 Exchange 組織中使用 New-EmailAddressPolicy Cmdlet 建立電子郵件地址原則之後,您必須使用 Update-EmailAddressPolicy Cmdlet 將新原則套用至收件者。

搭配 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-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"

此範例會在使用預先設定收件者篩選的內部部署 Exchange 組織中建立電子郵件地址原則:

  • 名稱:東南辦事處
  • 預設收件者篩選:擁有州/省值為喬治亞州、阿拉巴馬州或路易斯安那州 (州信箱為 GA、AL 或 LA 的所有使用者) 。
  • 主要 SMTP 電子郵件地址: <last name>.<first two letters of the first name>@contoso.com
  • 其他 Proxy 電子郵件地址: <last name>.<first two letters of the first name>@contoso.net
  • Priority:N+1,其中 N 是我們未使用 Priority 參數 (已存在的手動建立電子郵件地址原則數目,預設值為 N+1) 。

範例 2

New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2

此範例會在使用自訂收件者篩選器的內部部署 Exchange 組織中建立電子郵件地址原則:

  • 姓名:Northwest Executives
  • 自訂收件者篩選:擁有 [標題] 值包含 [總監] 或 [經理] 且 [州/省] 值為 WA、OR 或 ID 的所有使用者 (華盛頓州、奧勒岡州或愛達荷州) 。
  • 主要 SMTP 電子郵件地址: <first two letters of the first name><last name>@contoso.com
  • 其他 Proxy 電子郵件地址:無
  • 優先順序:2

參數

-ConditionalCompany

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCompany 參數會根據收件者的 [公司] 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute1

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute1 參數會根據收件者的 CustomAttribute1 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute10

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute10 參數會根據收件者的 CustomAttribute10 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute11

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute11 參數會根據收件者的 CustomAttribute11 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute12

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute12 參數會根據收件者的 CustomAttribute12 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute13

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute13 參數會根據收件者的 CustomAttribute13 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute14

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute14 參數會根據收件者的 CustomAttribute14 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute15

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute15 參數會根據收件者的 CustomAttribute15 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute2

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute2 參數會根據收件者的 CustomAttribute2 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute3

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute3 參數會根據收件者的 CustomAttribute3 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute4

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute4 參數會根據收件者的 CustomAttribute4 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute5

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute5 參數會根據收件者的 CustomAttribute5 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute6

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute6 參數會根據收件者的 CustomAttribute6 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute7

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute7 參數會根據收件者的 CustomAttribute7 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute8

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute8 參數會根據收件者的 CustomAttribute8 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalCustomAttribute9

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalCustomAttribute9 參數會根據收件者的 CustomAttribute9 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalDepartment

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalDepartment 參數會根據收件者的 Department 屬性值指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

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

-ConditionalStateOrProvince

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

ConditionalStateOrProvince 參數會根據收件者的 StateOrProvince 屬性值來指定預先儲存的篩選條件。 您可以指定多個以逗號分隔的值。

當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用,做為預先儲存篩選的一部分。 您無法將任何條件參數與 RecipientFilter 參數 (結合使用,後者是用來建立自訂 OPATH 篩選) 。

參數屬性

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

參數集

AllTemplatesWithPrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
SMTPTemplateWithPrecannedFilter
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

-DisabledEmailAddressTemplates

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

DisabledEmailAddressTemplates 參數會指定包含在電子郵件地址原則中的 Proxy 電子郵件地址範本,但不會用來設定收件者的電子郵件地址。

此參數的有效語法為 Type:AddressFormat:

  • 類型:有效的電子郵件地址類型,如 Exchange Server 中的電子郵件地址原則中的「Email 類型」一節中所述。 例如,smtp 或 X400。 您不可以使用 SMTP 指定停用的主要 SMTP 電子郵件地址。
  • AddressFormat:針對 SMTP 電子郵件地址、設定為接受網域的網域或子網域 (權威或內部轉送) ,以及有效的變數和 ASCII 文字字元,如Exchange Server中的Email地址原則中的「地址格式」一節中所述。 例如: alias@contoso.com 需要值 %m@contoso.com,也 firstname.lastname@contoso.com 需要值 %g.%s@contoso.com.

您可以指定多個停用的電子郵件地址範本,並以逗號分隔: "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"。

參數屬性

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

參數集

AllTemplatesWithPrecannedFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
AllTemplatesWithCustomFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
AllTemplatesForUnifiedGroupRecipientsFilter
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

-EnabledEmailAddressTemplates

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

若要設定封鎖的檔案類型,請使用 FileTypes 參數。

此參數的有效語法為 Type:AddressFormat:

  • 類型:有效的電子郵件地址類型,如 Exchange Server 電子郵件地址原則中的「地址類型」一節所述,Email 位址類型。 例如,SMTP 代表主要電子郵件地址,而 smtp 代表 Proxy 位址。
  • AddressFormat:針對 SMTP 電子郵件地址、設定為接受網域的網域或子網域 (權威或內部轉送) ,以及有效的變數和 ASCII 文字字元,如Exchange Server中的Email地址原則中的「地址格式」一節中所述。 例如: alias@contoso.com 需要值 %m@contoso.com,也 firstname.lastname@contoso.com 需要值 %g.%s@contoso.com.

此參數至少需要一個範本的類型值為 SMTP (,以定義主要 SMTP 電子郵件地址) 。 之後,如果不包含範本的類型首碼,則會假定值 smtp (SMTP Proxy 位址) 。

您可以指定多個電子郵件地址範本,並以逗號分隔: "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"。

您無法將此參數與 EnabledPrimarySMTPAddressTemplate 參數搭配使用。

在 Exchange Online PowerShell 中,您無法在電子郵件地址範本中使用變數。

參數屬性

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

參數集

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

-EnabledPrimarySMTPAddressTemplate

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

EnabledPrimarySMTPAddressTemplate 參數會在電子郵件地址原則中指定用來為收件者產生主要 SMTP 電子郵件地址的規則。 如果原則只套用主要電子郵件地址而不套用其他 Proxy 位址,則可以使用此參數,而非 EnabledEmailAddressTemplates。

此參數的有效語法是設定為權威接受網域的網域或子網域,以及有效的變數和 ASCII 文字字元,如 Exchange Server 中的Email位址原則中的「位址格式」一節中所述。 例如: alias@contoso.com 需要值 %m@contoso.com,也 firstname.lastname@contoso.com 需要值 %g.%s@contoso.com.

您無法將此參數與 EnabledEmailAddressTemplates 參數搭配使用。

在 Exchange Online PowerShell 中,您無法在電子郵件地址範本中使用變數。

參數屬性

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

參數集

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

-IncludedRecipients

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

IncludedRecipients 參數會根據收件者類型指定預先儲存的篩選條件。 有效值為:

  • AllRecipients:此值只能單獨使用。
  • MailboxUsers
  • 郵件連絡人
  • 郵件群組
  • MailUsers
  • MailUsers

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

當您使用任何 [條件式] 參數做為預先儲存篩選的一部分時,您必須使用此參數。 您無法將此參數與用來建立自訂 OPATH 篩選) 的 RecipientFilter 參數 (結合使用。

參數屬性

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

參數集

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

-IncludeUnifiedGroupRecipients

適用:Exchange Online

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

IncludeUnifiedGroupRecipients 參數會指定電子郵件地址原則僅適用於 Microsoft 365 群組。 您不需要使用此參數指定值。

在 Exchange Online PowerShell 中,您一律需要使用此切換,因為 Exchange Online 中的電子郵件地址原則僅適用於 Microsoft 365 群組。

參數屬性

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

參數集

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

-ManagedByFilter

適用:Exchange Online

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

ManagedByFilter 參數會根據建立 Microsoft 365 群組之使用者的屬性,指定要套用至 Microsoft 365 群組的電子郵件地址原則。

此參數是根據任何可用收件者屬性的值而來的 OPATH 篩選 ("Department -eq 'Sales'" 例如) 。 您可以使用任何可用的 Windows PowerShell 運算子,而且支援萬用字元和部分比對。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。

  • 以雙引號 “ ” 括住整個 OPATH 篩選器。 如果篩選條件包含系統值 (例如 $true、 $false 或 $null),請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊),您也可以使用大括弧 { },但只有在篩選條件不包含變數時。
  • Property 是可篩選的屬性。 如需可篩選的收件者屬性,請參閱 RecipientFilter 參數的可篩選屬性。
  • ComparisonOperator 是一種 OPATH 比較運算子 (例如 -eq ,用於等號和 -like 字串比較) 。 如需比較運算子的詳細資訊,請參閱 about_Comparison_Operators。
  • Value 是要搜尋的屬性值。 以單引號括住文字值和變數 ('Value' 或 '$Variable')。 如果變數值包含單引號,您必須識別 (逸出) 單引號,以正確展開變數。 例如,使用 '$($User -Replace "'","''")',而不是 '$User'。 請勿用引號括住整數或系統值 (例如,使用 500、 $true$false,或$null改為使用) 。
  • 您不能使用萬用字元做為第一個字元。 例如, 'Sales*' 是允許,但 '*Sales' 不允許。

如需詳細資訊,請參閱建立 Microsoft 365 群組時選擇要使用的網域。

如需有關 Exchange 中 OPATH 篩選的詳細資訊,請參閱 其他 OPATH 語法資訊。

您只能在 Exchange Online PowerShell 中搭配 IncludeUnifiedGroupRecipients 切換使用此參數。

參數屬性

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

參數集

AllTemplatesForUnifiedGroupRecipientsFilter
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
SMTPTemplateForUnifiedGroupRecipientsFilter
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 個字元。 如果值包含空格,請使用引號 (") 括住值。

參數屬性

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

參數集

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

-Priority

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Priority 參數會指定評估電子郵件地址原則的順序。 根據預設,每次您新增電子郵件地址原則時,都會為原則指派 N+1 的優先順序,其中 N 是您建立的電子郵件地址原則數目。

Priority 參數會指定評估電子郵件地址原則的順序。根據預設,每次您新增新的電子郵件地址原則時,原則會指派 N+1 的優先順序,其中 N 是您所建立的電子郵件地址原則的數目。

注意:識別收件者的第一個電子郵件地址原則會設定收件者的電子郵件地址。 即使第一個原則未套用且無法設定收件者的電子郵件地址,也會忽略所有其他原則。

參數屬性

類型:EmailAddressPolicyPriority
預設值: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。

RecipientContainer 參數會根據收件者在 Active Directory 中的位置來指定篩選。 此參數的有效輸入是 Get-OrganizationalUnit Cmdlet 傳回的組織單位 (OU) 或網域。 您可以使用唯一識別 OU 或網域的任何值。 例如:

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

GUID

參數屬性

類型: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。

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 參數或任何用來建立預先儲存篩選 (條件參數) 結合使用。

參數屬性

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

參數集

AllTemplatesWithCustomFilter
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
SMTPTemplateWithCustomFilter
Position:Named
必要:True
來自管線的值: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

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