Set-AddressList

 

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

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

使用 Set-AddressList cmdlet 可以修改现有地址列表。

语法

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

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

详细说明

若要运行 Set-AddressList cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange 组织管理员角色

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项

如果要使用 Exchange 管理控制台管理在 Exchange Server 2003 或 Exchange 2000 Server 中创建的地址列表,必须执行下列操作:

  • 使用 ForceUpgrade 参数更新地址列表的版本属性。

  • 使用 RecipientFilter 参数或下列筛选器参数之一更改收件人筛选器:

    • ConditionalCompany

    • ConditionalDepartment

    • ConditionalStateOrProvince

    • IncludedRecipients

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

使用 Identity 参数指定代表特定地址列表的 GUID、可分辨名称或地址列表名称。还可以包含采用 Path\AddressListName 格式的路径。

可以省略参数标签 Identity,以便只提供地址列表名称或 GUID。

ConditionalCompany

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 参数是用于指定公司的筛选器。其公司属性与您输入的该参数值相匹配的所有收件人都将包含在要修改的地址列表中。可以使用以逗号分隔的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute1

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute1 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute10

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute10 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute11

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute11 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute12

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute12 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute13

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute13 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute14

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute14 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute15

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute15 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute2

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute2 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute3

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute3 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute4

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute4 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute5

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute5 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute6

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute6 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute7

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute7 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute8

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute8 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalCustomAttribute9

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute9 参数指定自定义属性。通过自定义属性可以在地址列表中添加可作为地址列表排序或分组依据的其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalDepartment

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment 参数是用于指定部门的筛选器。其部门属性与为此参数所输入的值相匹配的所有收件人都将包括在地址列表中。可以使用以逗号分隔的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

ConditionalStateOrProvince

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince 参数是用于指定省/市/自治区的筛选器。其 ConditionalStateOrProvince 属性与为此参数输入的值相匹配的所有收件人都将包括在地址列表中。可以使用以逗号分隔的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DisplayName

可选

System.String

DisplayName 参数指定所期望的地址列表显示名称。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。

ForceUpgrade

可选

System.Management.Automation.SwitchParameter

ForceUpgrade 参数禁用以下确认:“若要保存对对象的更改,必须将该对象升级到当前的 Exchange 版本。完成升级后,无法通过早期版本的 Exchange 系统管理器来管理此对象。要继续升级并保存该对象吗?”在升级 Microsoft Exchange Server 2003 或 Exchange 2000 Server 中创建的地址列表时会出现此确认消息。在更新对象版本并使用 RecipientFilterIncludedRecipients 参数更改收件人筛选器之前,无法使用 Exchange 管理控制台管理 Exchange 2003 或 Exchange 2000 地址列表。

IncludedRecipients

可选

System.Nullable

IncludedRecipients 参数可筛选用于构建全局地址列表 (GAL) 的收件人类型。IncludedRecipients 参数的可用值为 AllRecipients、MailboxUsers、Resources、Contacts 和 MailGroups。

AllRecipients 值只能单独使用。当 IncludedRecipients 参数的多个值使用逗号分隔时,将应用 OR 布尔运算符。

如果使用任何 Conditional 参数,则必须使用此参数。如果使用 RecipientFilter 参数,则不能使用此参数。

Instance

可选

Microsoft.Exchange.Data.Directory.Management.AddressList

使用命令行的管理员很少使用 Instance 参数。该参数表包含于参数表,供开发人员参考。

Name

可选

System.String

Name 参数指定地址列表的新名称。该名称不能超过 64 个字符,并且不能包含换行符或反斜线 (\)。

RecipientFilter

可选

System.String

RecipientFilter 参数指定要包括在地址列表中的收件人筛选器。如果使用了下列筛选器参数中的任何一个,则不能使用此参数:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

  • RecipientContainer

有关可筛选属性的详细信息,请参阅 -RecipientFilter 参数的可筛选属性

UseRusServer

可选

System.String

note注意:
此参数仅在 Exchange 2007 SP2 中可用。

UseRusServer 参数指示该命令使用运行地址列表服务的指定邮箱服务器获取并设置邮箱和 Active Directory 用户属性。

地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息(如地址列表成员身份和电子邮件地址),您可以使用地址列表服务来更新域中的收件人对象。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

第一个示例显示如何修改现有地址列表的名称。

第二个示例显示如何修改将包含在名为 MyAddressList2 的现有地址列表中的收件人类型和收件人部门。MyAddressList2 是来自 Exchange 2003 的地址列表,所以该命令还将升级此地址列表。

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

使用通过管道传递给 Format-ListGet-AddressList 命令可以获取现有地址列表的 GUID、可分辨名称或路径和名称。也可以使用 Get-AddressList 获取特定现有地址列表,然后将输出通过管道直接传递给 Set-AddressList