Set-AddressList (RTM)

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-10-23

使用 Set-AddressList 指令程式以修改現有的通訊清單。

語法

Set-AddressList -Identity <AddressListIdParameter> [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]

Set-AddressList [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>]

詳細描述

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

• Exchange 組織系統管理員角色

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

若要使用 Exchange 管理主控台來管理 Exchange Server 2003 或 Exchange 2000 Server 中建立的通訊清單，必須執行下列動作：

• 使用 ForceUpgrade 參數更新通訊清單的版本屬性。
• 使用 RecipientFilter 參數或下列其中一個篩選器參數來變更收件者篩選器：
  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

參數

參數	必要	類型	描述
Identity	必要	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	使用 Identity 參數，可以指定代表特定接收通訊清單的 GUID、辨別名稱或通訊清單名稱。您也可以使用 Path\AddressListName 的格式加入路徑。 您可以省略參數標籤 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 參數是指定省/市的篩選器。通訊清單中會包含具有 ConditionalStateOrProvince 屬性的所有收件者，而此屬性符合您為此參數所輸入的值。您可以使用以逗點分隔的清單，為這個參數指定多個值。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
DisplayName	選用	System.String	DisplayName 參數可指定希望的通訊清單顯示名稱。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。
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.Management.AddressList	使用命令列的系統管理員很少使用 Instance 參數。將它放在參數表中是為了供開發人員參考。
Name	選用	System.String	Name 參數指定通訊清單的新名稱。名稱不得超過 64 個字元，而且不能包含換行符號或反斜線 (\)。
RecipientFilter	選用	System.String	RecipientFilter 參數指定要包含在通訊清單中之收件者的篩選器。如果使用下列任一篩選器參數，就不可以使用此參數。 ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients RecipientContainer 如需可過濾內容的相關資訊，請參閱 -RecipientFilter 參數的可過濾內容。

輸入類型

傳回類型

錯誤

錯誤	描述

例外狀況

例外狀況	描述

範例

第一個範例顯示如何修改現有通訊清單的名稱。

第二個範例顯示如何修改要加入名稱為 MyAddressList2 之現有通訊清單中的收件者類型及收件者部門。MyAddressList2 是來自 Exchange 2003 的通訊清單，所以此命令也會升級此通訊清單。

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

使用傳送至 Format-List 的 Get-AddressList 命令，可取得現有通訊清單的 GUID、辨別名稱或路徑與名稱。或者，也可以使用 Get-AddressList 取得特定現有通訊清單，然後直接將輸出傳送至 Set-AddressList。

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.