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 參數或下列其中一個篩選器參數：
|
||
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 參數或下列其中一個篩選器參數：
|
||
ConditionalStateOrProvince |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince 參數是指定省/市的篩選器。通訊清單中會包含具有 ConditionalStateOrProvince 屬性的所有收件者，而此屬性符合您為此參數所輸入的值。您可以逗點分隔的清單來使用多個值。如果使用 RecipientFilter 參數，則不可以使用此參數。您必須使用 RecipientFilter 參數或下列其中一個篩選器參數：
|
||
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 參數是指定要包含在通訊清單中之收件者類型的篩選器。您可以使用下列一或多種類型：
如果使用 RecipientFilter 參數，則不可以使用此參數。您必須使用 RecipientFilter 參數或下列其中一個篩選器參數：
|
||
RecipientFilter |
選用 |
System.String |
RecipientFilter 參數可指定要包含在通訊清單中之收件者的篩選器。如果使用下列任一篩選器參數，就不可以使用此參數。
您必須使用此參數，或上述其中一個篩選器參數。 如需可過濾內容的相關資訊，請參閱 -RecipientFilter 參數的可過濾內容。 |
||
TemplateInstance |
選用 |
System.Management.Automation.PSObject |
對 TemplateInstance 參數提供現有的物件時，命令會使用該物件之組態，在本機或目標伺服器上建立該物件的實際複寫。 |
||
UseRusServer |
選用 |
System.String |
UseRusServer 參數會指示此命令，使用通訊清單服務執行所在的指定信箱伺服器來取得並設定信箱及 Active Directory 使用者屬性。 通訊清單服務是 Exchange System Attendant 服務的一個元件。通訊清單服務會在 Active Directory 中建立並維護 Exchange 的特定屬性。您可以使用特定資訊 (如通訊清單成員資格與電子郵件地址)，透過通訊清單服務來更新網域中的收件者物件。 |
||
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。 |
.gif "note")
附註：輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
例外狀況
| 例外狀況 | 描述 |
|---|---|
|
|
範例
第一個範例會示範如何建立名為 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 技術資源中心.