Set-GlobalAddressList

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2009-05-12

使用 Set-GlobalAddressList cmdlet 可以修改 Active Directory 目录服务全局地址列表 (GAL) 中的属性。

语法

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 cmdlet 修改 GAL 中的属性。

若要运行 Set-GlobalAddressList cmdlet，必须为您使用的帐户委派以下角色：

• 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 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

在此示例中，使用 Set-GlobalAddressList 命令向 GUID 为 96d0c505-eba8-4103-ad4f-577a1bf4ad7b 的 GAL 指定新名称 GALwithNewName。

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