共用方式為


New-AddressList

 

適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間: 2009-05-12

使用 New-AddressList 指令程式來建立新通訊清單並套用至收件者。

語法

New-AddressList -Name <String> [-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 [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

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

  • Exchange 組織系統管理員角色

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

參數

參數 必要 類型 描述

Name

必要

System.String

Name 參數可指定所希望的新通訊清單名稱。名稱不得超過 64 個字元,而且不能包含換行符號或反斜線 (\)。

ConditionalCompany

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 參數是指定公司的篩選器。通訊清單中會包含具有公司屬性的所有收件者,而此屬性符合您為此參數所輸入的值。您可以逗點分隔的清單來使用多個值。如果使用 RecipientFilter 參數,則不可以使用此參數。您必須使用 RecipientFilter 參數或下列其中一個篩選器參數:

  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

ConditionalCustomAttribute1

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute1 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute10

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute10 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute11

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute11 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute12

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute12 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute13

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute13 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute14

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute14 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute15

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute15 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute2

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute2 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute3

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute3 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute4

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute4 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute5

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute5 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute6

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute6 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute7

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute7 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute8

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute8 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalCustomAttribute9

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute9 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

ConditionalDepartment

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment 參數是指定部門的篩選器。只要是部門屬性符合您為此參數所輸入之值的收件者,都會加入通訊清單中。您可以逗點分隔的清單來使用多個值。如果使用 RecipientFilter 參數,則不可以使用此參數。您必須使用 RecipientFilter 參數或下列其中一個篩選器參數:

  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

ConditionalStateOrProvince

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince 參數是指定省/市的篩選器。通訊清單中會包含具有 ConditionalStateOrProvince 屬性的所有收件者,而此屬性符合您為此參數所輸入的值。您可以逗點分隔的清單來使用多個值。如果使用 RecipientFilter 參數,則不可以使用此參數。您必須使用 RecipientFilter 參數或下列其中一個篩選器參數:

  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理,並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

Container

選用

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Container 參數可指定將於其中建立這份新通訊清單之父項通訊清單的識別碼。若未指定任何父項通訊清單,則會在 [所有通訊清單] 根目錄下建立此通訊清單。

DisplayName

選用

System.String

DisplayName 參數可指定希望的通訊清單顯示名稱。若未提供顯示名稱,則通訊清單的名稱也會成為顯示名稱。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。

IncludedRecipients

選用

System.Nullable

IncludedRecipients 參數是指定要包含在通訊清單中之收件者類型的篩選器。您可以使用下列一或多種類型:


  • UserMail
  • Resources
  • MailGroups
  • MailContacts
  • AllRecipients

如果使用 RecipientFilter 參數,則不可以使用此參數。您必須使用 RecipientFilter 參數或下列其中一個篩選器參數:

  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

RecipientFilter

選用

System.String

RecipientFilter 參數可指定要包含在通訊清單中之收件者的篩選器。如果使用下列任一篩選器參數,就不可以使用此參數。

  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

您必須使用此參數,或上述其中一個篩選器參數。

如需可過濾內容的相關資訊,請參閱 -RecipientFilter 參數的可過濾內容

TemplateInstance

選用

System.Management.Automation.PSObject

TemplateInstance 參數提供現有的物件時,命令會使用該物件之組態,在本機或目標伺服器上建立該物件的實際複寫。

UseRusServer

選用

System.String

note附註:
只有在 Exchange Server 2007 SP2 中才能使用此參數。

UseRusServer 參數會指示此命令,使用通訊清單服務執行所在的指定信箱伺服器來取得並設定信箱及 Active Directory 使用者屬性。

通訊清單服務是 Exchange System Attendant 服務的一個元件。通訊清單服務會在 Active Directory 中建立並維護 Exchange 的特定屬性。您可以使用特定資訊 (如通訊清單成員資格與電子郵件地址),透過通訊清單服務來更新網域中的收件者物件。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

第一個範例會示範如何建立名為 MyAddressList 的新通訊清單。此通訊清單包含屬於信箱使用者並且將 StateOrProvince 設為 Washington 或 Oregon 的收件者。

第二個範例則會示範如何建立名為 MyAddressList2,且包含 ConditionalStateOrProvince 參數設為 Washington 之信箱的新通訊清單。

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers

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