Set-EmailAddressPolicy
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Set-EmailAddressPolicy Cmdlet 修改電子郵件地址原則。 在 Exchange Online 中,電子郵件地址原則僅適用於 Microsoft 365 群組。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Set-EmailAddressPolicy
[-Identity] <EmailAddressPolicyIdParameter>
[-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>]
[-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-EnabledPrimarySMTPAddressTemplate <String>]
[-ForceUpgrade]
[-IncludedRecipients <WellKnownRecipientType>]
[-Name <String>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-RecipientFilter <String>]
[-WhatIf]
[<CommonParameters>]
Description
使用 Set-EmailAddressPolicy Cmdlet 修改內部部署 Exchange 組織中的電子郵件地址原則之後,您必須使用 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 以自訂 OPATH 篩選取代預先儲存的篩選,反之亦然。 您只能修改現有的篩選條件。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}
在內部部署 Exchange 中,此範例透過在預先儲存的收件者篩選器中新增州或省值 TX (Texas) ,以修改名為 Southeast Executives 的現有電子郵件地址原則。
範例 2
Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null
在內部部署 Exchange 中,此範例會從名為 Contoso Corp. 的電子郵件地址原則中清除停用的電子郵件地址範本。
範例 3
Set-EmailAddressPolicy -Identity "Office 365 Groups" -EnabledEmailAddressTemplates "SMTP:@contoso.com","smtp:@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"
在 Exchange Online 中,此範例修改名為 “Office 365 Groups” 的現有電子郵件地址原則,並將已啟用的電子郵件地址範本設定為使用 “@contoso.com” 作為主要 SMTP 位址,並將 “@contoso.onmicrosoft.com” 和 “@contoso.microsoftonline.com” 用作 Proxy 位址。
參數
-ConditionalCompany
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
ConditionalCompany 參數會根據收件者的 [公司] 屬性值來指定預先儲存的篩選條件。
當您為此參數使用多個值時,會套用 OR 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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 布林值運算子。 如需條件式參數運作方式的詳細資訊,請參閱本文的詳細描述一節。
若要輸入會覆寫任何現有項目的多個值,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"。
若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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"。
一般而言,此屬性只會在從舊版 Exchange 移轉之後填入值。 若要清除這些值,請使用此參數的值$null。
參數屬性
| 類型: | ProxyAddressTemplateCollection |
| 預設值: | 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 |
-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 中,如果您將此參數與 IncludeUnifiedGroupRecipients 搭配使用,您就無法在電子郵件地址範本中使用變數。
參數屬性
| 類型: | ProxyAddressTemplateCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | 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 中,如果您將此參數與 IncludeUnifiedGroupRecipients 搭配使用,您就無法在電子郵件地址範本中使用變數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ForceUpgrade
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
ForceUpgrade 參數會隱藏如果物件是在舊版 Exchange 中建立時顯示的確認訊息。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
Identity 參數會指定您要修改的電子郵件地址原則。 您可以使用唯一識別原則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | EmailAddressPolicyIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludedRecipients
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
IncludedRecipients 參數會根據收件者類型指定預先儲存的篩選條件。 有效值為:
- AllRecipients:此值只能單獨使用。
- MailboxUsers
- 郵件連絡人
- 郵件群組
- MailUsers
- MailUsers
您可以指定多個以逗號分隔的值。 當您使用多個值時,會套用 OR 布林值運算子。
參數屬性
| 類型: | WellKnownRecipientType |
| 預設值: | 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 個字元。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | 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'是允許,但'Sa*les'不允許。
如需有關 Exchange 中 OPATH 篩選的詳細資訊,請參閱 其他 OPATH 語法資訊。
參數屬性
| 類型: | String |
| 預設值: | 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。