Set-EmailAddressPolicy (RTM)

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2008-05-07

使用 Set-EmailAddressPolicy 指令程式，可設定電子郵件地址原則的 Active Directory 目錄服務屬性。

語法

Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

Set-EmailAddressPolicy [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

詳細描述

Set-EmailAddressPolicy 指令程式可讓系統管理員為特定的電子郵件地址原則設定 Active Directory 屬性。但 Set-EmailAddressPolicy 指令程式不會將變更套用到電子郵件地址原則。使用 Set-EmailAddressPolicy 指令程式後，請接著使用 Update-EmailAddressPolicy 指令程式以套用變更。

若要執行 Set-EmailAddressPolicy 指令程式，必須對您使用的帳戶委派下列項目：

• Exchange 組織系統管理員角色

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

如需 Update-EmailAddressPolicy 指令程式的相關資訊，請參閱 Update-EmailAddressPolicy (RTM)。

參數

參數	必要	類型	描述
Identity	必要	Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter	使用 Identity 參數，可以指定代表特定電子郵件地址原則的 GUID、辨別名稱或電子郵件地址原則名稱。您也可以使用 Path\EmailAddressPolicy 的格式加入路徑。 您可以省略參數標籤 Identity，而只提供電子郵件地址原則名稱或 GUID
ConditionalCompany	選用	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCompany 參數設定電子郵件地址原則的公司。它可以接受使用逗點分隔的清單輸入的多個值。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute1	選用	System.String	ConditionalCustomAttribute1 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute10	選用	System.String	ConditionalCustomAttribute10 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute11	選用	System.String	ConditionalCustomAttribute11 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute12	選用	System.String	ConditionalCustomAttribute12 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute13	選用	System.String	ConditionalCustomAttribute13 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute14	選用	System.String	ConditionalCustomAttribute14 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute15	選用	System.String	ConditionalCustomAttribute15 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute2	選用	System.String	ConditionalCustomAttribute2 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute3	選用	System.String	ConditionalCustomAttribute3 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute4	選用	System.String	ConditionalCustomAttribute4 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute5	選用	System.String	ConditionalCustomAttribute5 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute6	選用	System.String	ConditionalCustomAttribute6 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute7	選用	System.String	ConditionalCustomAttribute7 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute8	選用	System.String	ConditionalCustomAttribute8 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute9	選用	System.String	ConditionalCustomAttribute9 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalDepartment	選用	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalDepartment 參數設定電子郵件地址原則的部門。它可以接受使用逗點分隔的清單輸入的多個值。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalStateOrProvince	選用	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalStateOrProvince 參數設定電子郵件地址原則的省或市。它可以接受使用逗點分隔的清單輸入的多個值。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
DisabledEmailAddressTemplates	選用	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	DisabledEmailAddressTemplates 參數可定義納入電子郵件地址原則並停用的 Proxy 地址。它可以接受使用逗點分隔的清單輸入的多個值。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定從 Active Directory 擷取資料之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。
EnabledEmailAddressTemplates	選用	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	EnabledEmailAddressTemplates 參數可定義納入電子郵件地址原則並啟用的 Proxy 地址。它可以接受使用逗點分隔的清單輸入的多個值。
EnabledPrimarySMTPAddressTemplate	選用	System.String	EnabledPrimarySMTPAddressTemplate 參數可指定納入電子郵件地址原則並啟用的 Proxy 地址。它可以接受使用逗點分隔的清單輸入的多個值。
ForceUpgrade	選用	System.Management.Automation.SwitchParameter	ForceUpgrade 參數會抑制下列確認：「若要儲存物件上的變更，物件必須更新到目前的 Exchange 版本。更新之後，即無法以舊版 Exchange 系統管理員管理此物件。您要繼續更新並儲存物件嗎?」升級 Microsoft Exchange Server 2003 或 Exchange 2000 Server 中建立的電子郵件地址原則時，會出現此確認。除非使用 RecipientFilter 或 IncludedRecipients 參數來更新物件版本並變更收件者篩選器，否則無法使用 Exchange 管理主控台來管理 Exchange 2003 或 Exchange 2000 電子郵件地址原則。
IncludedRecipients	選用	System.Nullable	IncludedRecipients 參數可篩選用來建立全域通訊清單 (GAL) 的收件者類型。IncludedRecipients 參數可用的值有 AllRecipients、MailboxUsers、Resources、Contacts 及 MailGroups。 AllRecipients 值只能單獨使用。當 IncludedRecipients 參數的多個值以逗號隔開時，會套用 OR 布林運算子。 若使用任何一個 Conditional 參數，則必須使用此參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
Instance	選用	Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy	Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。
Name	選用	System.String	Name 參數可指定電子郵件地址原則的新名稱。
Priority	選用	Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority	Priority 參數可根據此參數的引數，讓目前的優先順序高於指定的優先順序。
RecipientFilter	選用	System.String	RecipientFilter 參數可篩選特定電子郵件地址原則中所含的收件者。如果指定了下列任一參數，則無法使用 RecipientFilter 參數： ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients 如需可過濾內容的相關資訊，請參閱 -RecipientFilter 參數的可過濾內容。

輸入類型

傳回類型

錯誤

錯誤	描述

例外狀況

例外狀況	描述

範例

下列程式碼是將電子郵件地址原則的名稱從 EMAIL_ADDRESS_POLICY01 變更為 EMAILADDRESSPOLICY02 的 Set-EmailAddressPolicy 命令範例。

Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02