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 技術資源中心.