New-AddressList (RTM)

 

適用版本: Exchange Server 2007

上次修改主題的時間: 2007-06-05

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

語法

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

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

詳細描述

若要執行 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

選用

System.String

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

ConditionalCustomAttribute10

選用

System.String

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

ConditionalCustomAttribute11

選用

System.String

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

ConditionalCustomAttribute12

選用

System.String

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

ConditionalCustomAttribute13

選用

System.String

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

ConditionalCustomAttribute14

選用

System.String

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

ConditionalCustomAttribute15

選用

System.String

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

ConditionalCustomAttribute2

選用

System.String

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

ConditionalCustomAttribute3

選用

System.String

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

ConditionalCustomAttribute4

選用

System.String

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

ConditionalCustomAttribute5

選用

System.String

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

ConditionalCustomAttribute6

選用

System.String

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

ConditionalCustomAttribute7

選用

System.String

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

ConditionalCustomAttribute8

選用

System.String

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

ConditionalCustomAttribute9

選用

System.String

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

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

第一個範例會示範如何建立名為 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