New-AddressList

参考

模块:: ExchangePowerShell

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

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

使用 New-AddressList cmdlet 可创建地址列表并将其应用于收件人。

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

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

New-AddressList
   [-Name] <String>
   -IncludedRecipients <WellKnownRecipientType>
   [-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]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

New-AddressList
   [-Name] <String>
   -RecipientFilter <String>
   [-Confirm]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

说明

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

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

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

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

示例

示例 1

New-AddressList -Name MyAddressList -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))"

本示例创建地址列表 MyAddressList。此地址列表包括身份为邮箱用户并且其 StateOrProvince 属性设置为 Washington 或 Oregon 的收件人。

示例 2

New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers

本示例创建地址列表 MyAddressList2，该地址列表包含 ConditionalStateOrProvince 参数设置为 Washington 的邮箱。

示例 3

New-AddressList -Name "AL_AgencyB" -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -like 'AgencyB*'))"

本示例创建了地址列表 AL_AgencyB，该地址列表包括 CustomAttribute15 参数值包含 AgencyB 的邮箱。