Set-GlobalAddressList

 

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

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

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

語法

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

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

詳細描述

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	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute10	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute11	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute12	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute13	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute14	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute15	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute2	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute3	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute4	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute5	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute6	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute7	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute8	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalCustomAttribute9	選用	Microsoft.Exchange.Data.MultiValuedProperty	此參數指定自訂屬性。您可以使用這些屬性來儲存其他資訊。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalDepartment	選用	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalDepartment 參數是用來指定部門。只要是部門屬性符合您為此參數所輸入之值的 GAL，都會納入。您可以逗點分隔的清單來使用多個值。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
ConditionalStateOrProvince	選用	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalStateOrProvince 參數設定全域通訊清單的省/市。它可以接受使用逗點分隔的清單輸入的多個值。若您使用 Conditional 參數，則必須使用 IncludedRecipients 參數。如果使用 RecipientFilter 參數，則不可以使用此參數。
Confirm	選用	System.Management.Automation.SwitchParameter	Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。
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 時，會出現此確認。除非使用 RecipientFilter 或 IncludedRecipients 參數來更新物件版本並變更收件者篩選器，否則無法使用 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	Name 參數指定全域通訊清單的新名稱。
RecipientFilter	選用	System.String	RecipientFilter 參數可為要加入 GAL 的收件者指定篩選器。若您使用下列任一篩選器參數，則無法使用這個參數： ConditionalCompany ConditionalDepartment IncludedRecipients ConditionalStateorProvince 您必須使用此參數，或上列其中一個篩選器參數。 如需可過濾內容的相關資訊，請參閱 -RecipientFilter 參數的可過濾內容。
UseRusServer	選用	System.String	附註： 只有在 Exchange 2007 SP2 中才能使用此參數。 UseRusServer 參數會指示此命令，使用通訊清單服務執行所在的指定信箱伺服器來取得並設定信箱及 Active Directory 使用者屬性。 通訊清單服務是 Exchange System Attendant 服務的一個元件。通訊清單服務會在 Active Directory 中建立並維護 Exchange 的特定屬性。您可以使用特定資訊 (如通訊清單成員資格與電子郵件地址)，透過通訊清單服務來更新網域中的收件者物件。
WhatIf	選用	System.Management.Automation.SwitchParameter	WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤	描述

例外狀況

例外狀況	描述

範例

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

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