Set-AddressList

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

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

在 Exchange Online 中，此 cmdlet 仅在“地址列表”角色中可用，默认情况下，该角色不会分配给任何角色组。若要使用此 cmdlet，需要将“地址列表”角色添加到角色组 (例如“组织管理”角色组) 。有关详细信息，请参阅向角色组添加角色。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange 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]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-ForceUpgrade]
   [-IncludedRecipients <WellKnownRecipientType>]
   [-Name <String>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-RecipientFilter <String>]
   [-WhatIf]
   [<CommonParameters>]

说明

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

与 IncludedRecipients 参数结合使用的 Conditional 参数受到以下限制约束：

EQV 运算符用于每个属性值，如“Department equals Sales”所示。不支持通配符和部分匹配。
OR 运算符始终用于同一个属性的多个值，如“Department equals Sales OR Marketing”所示。
AND 运算符始终用于多个属性，如在“Department equals Sales AND Company equals Contoso”所示。

若要创建使用任何可用收件人属性且不受这些限制约束的灵活筛选器，可以使用 RecipientFilter 参数创建自定义 OPATH 筛选器。

不能使用此 cmdlet 将预装筛选器替换为自定义 OPATH 筛选器，反之亦然。只能修改现有筛选器。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-AddressList -Identity "All Users\Sales\building4" -Name building9

本示例修改现有的地址列表的名称。

示例 2

Set-AddressList -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients MailboxUsers -ConditionalDepartment Sales

本示例修改包含在现有地址列表（由其 GUID 标识）中的收件人的类型和收件人的部门。