Set-AddressList

參考

模組:: ExchangePowerShell

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

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

使用 Set-AddressList 指令程式可修改現有的通訊清單。

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

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

Syntax

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

Description

使用透過管道傳送至 Format-List 的 Get-AddressList 指令程式，可取得現有通訊清單的 GUID、辨別名稱 (DN) 或路徑與名稱。或者，也可以使用 Get-AddressList 取得特定現有通訊清單，然後直接將輸出傳送至 Set-AddressList指令程式。

搭配 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 或參數所需的權限，請參閱 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 識別的現有通訊清單內所含的收件者類型及收件者所屬部門。

參數

-ConditionalCompany

ConditionalCompany 參數會根據收件者的 Company 屬性值，指定預先掃描的篩選準則。

當您針對此參數使用多個值時，會套用 OR 布林運算子。如需條件參數如何運作的詳細資訊，請參閱本主題的詳細描述一節。

若要輸入覆寫任何現有專案的多個值，請使用下列語法： Value1,Value2,...ValueN 。如果值包含空格或需要引號，請使用下列語法： "Value","Value2",..."ValueN" 。