New-EmailAddressPolicy

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

ConditionalCompany 參數會根據收件者的 Company 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute1 參數會根據收件者的 CustomAttribute1 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute10 參數會根據收件者的 CustomAttribute10 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute11 參數會根據收件者的 CustomAttribute11 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute12 參數會根據收件者的 CustomAttribute12 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute13 參數會根據收件者的 CustomAttribute13 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute14 參數會根據收件者的 CustomAttribute14 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute15 參數會根據收件者的 CustomAttribute15 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute2 參數會根據收件者的 CustomAttribute2 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute3 參數會根據收件者的 CustomAttribute3 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute4 參數會根據收件者的 CustomAttribute4 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute5 參數會根據收件者的 CustomAttribute5 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute6 參數會根據收件者的 CustomAttribute6 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute7 參數會根據收件者的 CustomAttribute7 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute8 參數會根據收件者的 CustomAttribute8 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalCustomAttribute9 參數會根據收件者的 CustomAttribute9 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalDepartment 參數會根據收件者的 Department 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

ConditionalStateOrProvince 參數會根據收件者的 StateOrProvince 屬性值，指定預先掃描的篩選準則。 您可以指定多個以逗號分隔的值。

當您針對此參數使用多個值時，會套用 OR 布林運算子。 如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

您可以將此參數與 IncludedRecipients 參數結合使用，作為預先掃描篩選的一部分。 您無法使用任何條件式參數搭配 RecipientFilter 參數 (用來建立自訂 OPATH 篩選) 。

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

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

此參數僅適用於內部部署 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" 。

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

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

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

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

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

此參數至少需要一個類型值為 SMTP (的範本，才能定義主要 SMTP 電子郵件地址) 。 之後，如果您未包含範本的 Type 前置詞，則會假設 smtp 值 (SMTP Proxy 位址) 。

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

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

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

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 中，您無法在電子郵件地址範本中使用變數。

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

IncludedRecipients 參數會指定以收件者類型為基礎的預先掃描篩選。 有效值為：

• AllRecipients：此值只能單獨使用。
• MailboxUsers
• MailContacts
• MailGroups
• MailUsers
• MailUsers

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

當您使用任何條件式參數做為預先掃描篩選的一部分時，必須使用此參數。 您無法將此參數與 RecipientFilter 參數搭配使用， (用來建立自訂 OPATH 篩選) 。

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

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

在 Exchange Online PowerShell 中，您一律需要使用此參數，因為Exchange Online中的電子郵件地址原則只會套用至Microsoft 365 群組。

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

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

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

• 以雙引號 「」 括住整個 OPATH 篩選準則。 如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
• Property 是可篩選的屬性。 如需可篩選的收件者屬性，請 參閱 RecipientFilter 參數的可篩選屬性。
• ComparisonOperator 是 OPATH 比較運算子 (例如 -eq equals 和 -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 參數使用此參數。

Name 參數會指定電子郵件地址原則的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。

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

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

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

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

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

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

GUID

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

RecipientFilter 參數會指定以任何可用收件者屬性值為基礎的自訂 OPATH 篩選準則。 您可以使用任何可用的Windows PowerShell運算子，並支援萬用字元和部分相符專案。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。

• 以雙引號 「」 括住整個 OPATH 篩選準則。 如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
• Property 是可篩選的屬性。 如需可篩選的屬性，請 參閱 RecipientFilter 參數的可篩選屬性。
• ComparisonOperator 是 OPATH 比較運算子 (例如 -eq equals 和 -like 字串比較) 。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。
• Value 是要篩選的屬性值。 以單引號括住文字值和變數 ('Value' 或 '$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用 '$($User -Replace "'","''")'，而不是 '$User'。 請勿以引號括住整數或系統值 (例如，請改用 500 、 $true 、 $false 或 $null) 。
• 在雲端式環境中，您無法使用萬用字元作為第一個字元。 例如， 'Sales*' 是允許的，但 '*Sales' 不允許。
• 在內部部署 Exchange 中，萬用字元只作為第一個或最後一個字元有效。 例如， 'Sales*' 或 '*Sales' 是允許的，但 'Sa*les' 不允許。

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

您無法將此參數與 IncludedRecipients 參數或用來建立預先掃描篩選) 的任何條件式參數 (搭配使用。

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