New-GlobalAddressList

参考

模块:: ExchangePowerShell

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

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

使用 New-GlobalAddressList cmdlet (GAL) 创建全局地址列表。

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

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

语法

New-GlobalAddressList
   [-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]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

New-GlobalAddressList
   [-Name] <String>
   -RecipientFilter <String>
   [-Confirm]
   [-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-GlobalAddressList -Name "NewGAL"

此示例创建名为 NewGAL 的 GAL。

示例 2

New-GlobalAddressList -Name GAL_AgencyB -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -eq 'AgencyB')"

此示例使用 RecipientFilter 参数创建名为 GAL_AgencyB 的 GAL，以包含其自定义属性 15 等于 AgencyB 的所有邮箱用户。