Set-EmailAddressPolicy (RTM)

Exchange 2007
 

適用版本: 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 中建立的電子郵件地址原則時,會出現此確認。除非使用 RecipientFilterIncludedRecipients 參數來更新物件版本並變更收件者篩選器,否則無法使用 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
 
顯示: