New-GlobalAddressList

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 New-GlobalAddressList Cmdlet 建立 GAL) (全域通訊清單。

在Exchange Online中，此 Cmdlet 只能在 [通訊清單] 角色中使用，而且根據預設，角色不會指派給任何角色群組。若要使用此 Cmdlet，您必須將 [通訊清單] 角色新增至角色群組 (例如，新增至組織管理角色群組) 。如需詳細資訊，請參閱將角色新增至角色群組。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

搭配 IncludedRecipients 參數使用的 Conditional 參數受到以下限制：

EQV 運算子用於每個屬性值，如同 "Department equals Sales"。不支援萬用字元和部分相符項目。
OR 運算子一律用於相同屬性的多個值 (如同 "Department equals Sales OR Marketing")。
AND 運算子一律用於多個屬性 (如同 "Department equals Sales AND Company equals Contoso")。

若要建立使用任何可用收件者屬性且不受這些限制的彈性篩選，您可以使用 RecipientFilter 參數來建立 OPATH 篩選。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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 參數來包含自訂屬性 15 等於 AgencyB 的所有信箱使用者，以建立名為 GAL_AgencyB GAL。