Set-GlobalAddressList (RTM)

Exchange 2007
 

適用版本: Exchange Server 2007

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

使用 Set-GlobalAddressList 指令程式,可為全域通訊清單 (GAL) 修改 Active Directory 目錄服務中的屬性。


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


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

Set-GlobalAddressList 指令程式可修改 GAL 上的內容。

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

  • Exchange 組織系統管理員角色

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

 

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

使用 Identity 參數,可以指定代表特定 GAL 的 GUID、辨別名稱或通訊清單 (GAL) 名稱。您也可以使用 Path\GlobalAddressListName 的格式加入路徑。

您可以省略參數標籤 Identity,而只提供 GAL 名稱或 GUID。

ConditionalCompany

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 參數是用來指定公司。您可以使用以逗點分隔的清單,為這個參數指定多個值。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute1

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute10

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute11

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute12

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute13

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute14

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute15

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute2

選用

System.String

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

ConditionalCustomAttribute3

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute4

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute5

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute6

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute7

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute8

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalCustomAttribute9

選用

System.String

此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

ConditionalDepartment

選用

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment 參數是用來指定部門。只要是部門屬性符合您為此參數所輸入之值的 GAL,都會納入。您可以使用以逗點分隔的清單,為這個參數指定多個值。若您使用 Conditional 參數,則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

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

ForceUpgrade

選用

System.Management.Automation.SwitchParameter

ForceUpgrade 參數會抑制下列確認:「若要儲存物件上的變更,物件必須更新到目前的 Exchange 版本。更新之後,即無法以舊版 Exchange 系統管理員管理此物件。您要繼續更新並儲存物件嗎?」升級 Microsoft Exchange Server 2003 或 Exchange 2000 Server 中建立的 GAL 時,會出現此確認。除非使用 RecipientFilterIncludedRecipients 參數來更新物件版本並變更收件者篩選器,否則無法使用 Exchange 管理主控台來管理 Exchange 2003 或 Exchange 2000 GAL。

IncludedRecipients

選用

System.Nullable

IncludedRecipients 參數可篩選用來建立 GAL 的收件者類型。IncludedRecipients 參數可用的值有 AllRecipients、MailboxUsers、Resources、Contacts 及 MailGroups。

AllRecipients 值只能單獨使用。當 IncludedRecipients 參數的多個值以逗號隔開時,會套用 OR 布林運算子。

若使用任何一個 Conditional 參數,則必須使用此參數。如果使用 RecipientFilter 參數,則不可以使用此參數。

Instance

選用

Microsoft.Exchange.Data.Directory.Management.GlobalAddressList

Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。

Name

選用

System.String

無。

RecipientFilter

選用

System.String

RecipientFilter 參數可為要加入 GAL 的收件者指定篩選器。若您使用下列任一篩選器參數,則無法使用這個參數:

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateorProvince

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

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

ConditionalStateOrProvince

選用

Microsoft.Exchange.Data.MultiValuedProperty

無。

 

錯誤 描述

 

 

例外狀況 描述

 

在此範例中,Set-GlobalAddressList 命令會用來將新名稱 (GALwithNewName) 指派給 GUID 為 96d0c505-eba8-4103-ad4f-577a1bf4ad7b 的 GAL。

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName
 
顯示: