New-AddressList
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。
使用 New-AddressList 指令程式會建立通訊清單並將其套用至收件者。
在 Exchange Online 中，這個指令小程式僅存在於地址清單角色中，且預設情況下，該角色不會被指派到任何角色群組。 要使用此 cmdlet，你需要將地址清單角色加入角色群組， (例如組織管理角色群組) 。 欲了解更多資訊，請參閱 「新增角色到角色群組」。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
PrecannedFilter
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>]
CustomFilter
New-AddressList
[-Name] <String>
-RecipientFilter <String>
[-Confirm]
[-Container <AddressListIdParameter>]
[-DisplayName <String>]
[-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 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 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 的信箱。
參數
-ConditionalCompany
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCompany 參數指定一個預設過濾器，基於接收者公司屬性的值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute1
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute1 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute1 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute10
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute10 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute10 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute11
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute11 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute11 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute12
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute12 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute12 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute13
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute13 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute13 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute14
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute14 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute14 屬性的值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute15
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute15 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute15 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute2
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute2 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute2 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute3
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute3 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute3 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute4
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute4 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute4 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute5
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute5 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute5 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute6
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute6 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute6 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute7
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute7 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute7 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute8
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute8 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute8 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalCustomAttribute9
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalCustomAttribute9 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute9 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalDepartment
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalDepartment 參數指定一個預設過濾器，該過濾器基於接收者的 Department 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConditionalStateOrProvince
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ConditionalStateOrProvince 參數指定一個預設過濾器，該過濾器基於接收者的 StateOrProvince 屬性值。 您可以指定多個以逗號分隔的值。
當你對此參數使用多個值時，會套用 OR 布林運算子。 欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。
你可以將此參數與 IncludedRecipients 參數結合使用，作為預先預設過濾器的一部分。 你不能將任何條件參數與 RecipientFilter 參數 (一起使用，而 RecipientFilter 是用來建立自訂 OPATH 過濾器的) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 參數會指定要顯示或隱藏確認提示。 此切換對指令令的影響取決於指令令是否需要確認後才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 對於這些指令，若未設定 Confirm 開關，會產生暫停，迫使你在繼續前確認該指令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Container
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Container 參數會指定要建立通訊清單的位置。 此參數的有效輸入在根目錄 "\" (也稱為「所有通訊清單」) 之下或現有的通訊清單之下。 您可以使用任何可唯一識別通訊清單的值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
- 例如路徑：
"\AddressListName"或"\ContainerName\AddressListName"(，"\All Users"或"\All Contacts\Marketing")
如果您未使用此參數，則通訊清單會建立於根目錄 (\) 之下。
參數屬性
| 類型: | AddressListIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayName
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
DisplayName 參數會指定通訊清單的顯示名稱。 顯示名稱會在 Exchange 管理中心和 Outlook 中顯示。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。
如果您未使用 DisplayName 參數，則 Name 參數的值會用於顯示名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludedRecipients
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
IncludedRecipients 參數指定一個預設的過濾器，該過濾器基於接收者類型。 有效值為：
- AllRecipients：此值僅能單獨使用。
- MailboxUsers
- 郵件聯絡人
- 郵件群組
- MailUsers
- MailUsers
您可以指定多個以逗號分隔的值。 當你使用多個值時，會套用 OR 布林運算子。
當你使用任何條件參數作為預設過濾器的一部分時，都需要使用這個參數。 你不能將此參數與 RecipientFilter 參數 (一起使用，後者用於建立自訂的 OPATH 過濾器) 。
參數屬性
| 類型: | WellKnownRecipientType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PrecannedFilter
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Name 參數會指定新通訊清單的唯一名稱。 長度上限為 64 個字元，而且不能包含換行符號或反斜線 (\)。 如果值包含空格，請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientContainer
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
RecipientContainer 參數指定一個基於收件人在 Active Directory 中位置的過濾器。 此參數的有效輸入是由 Get-OrganizationalUnit 指令碼返回 (OU) 或領域中的組織單位。 您可以使用唯一識別 OU 或網域的任何值。 例如：
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
GUID
參數屬性
| 類型: | OrganizationalUnitIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientFilter
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
RecipientFilter 參數指定一個自訂的 OPATH 過濾器，該過濾器基於任何可用接收者屬性的值。 你可以使用任何可用的 Windows PowerShell 運算子，並且支援萬用字組和部分匹配。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。
- 將整個 OPATH 濾波器包在雙引號中 “”。 如果篩選條件包含系統值 (例如
$true、$false或$null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。 - Property 是可篩選的屬性。 關於可篩選屬性，請參見 RecipientFilter 參數的可篩選屬性。
- ComparisonOperator 是一種 OPATH 比較運算子，例如用於等值和
-like字串比較) (-eq。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。 - 價值是要篩選的房產價值。 以單引號括住文字值和變數 (
'Value'或'$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用'$($User -Replace "'","''")'，而不是'$User'。 不要用引號包住整數或系統值， (例如，使用500、、$true$false，或$null) 。 - 在雲端環境中，你不能用萬用卡作為第一個角色。 例如，
'Sales*'是允許的，但'*Sales'又不允許。 - 在本地 Exchange 中，萬用字元僅作為第一個或最後一個字元有效。 例如，
'Sales*''*Sales'或是被允許，但'Sa*les'不被允許。
欲了解 Exchange 中 OPATH 過濾器的詳細資訊，請參見 「額外 OPATH 語法資訊」。
你不能將此參數與 IncludedRecipients 參數或任何用於建立預設過濾器 (的條件參數一起使用，) 。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
CustomFilter
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 開關顯示指令的功能，且不做任何修改。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。