Set-GlobalAddressList

模組:: Exchange PowerShell

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能只限於某一環境。

使用 Set-GlobalAddressList 指令碼修改現有的全域通訊錄 (GAL) 。

在 Exchange Online 中，這個指令小程式僅存在於地址清單角色中，且預設情況下，該角色不會被指派到任何角色群組。要使用此 cmdlet，你需要將地址清單角色加入角色群組， (例如組織管理角色群組) 。欲了解更多資訊，請參閱「新增角色到角色群組」。

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

語法

Default (預設值)

Set-GlobalAddressList
    [-Identity] <GlobalAddressListIdParameter>
    [-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>]
    [-ForceUpgrade]
    [-IncludedRecipients <WellKnownRecipientType>]
    [-Name <String>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-RecipientFilter <String>]
    [-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 把預設的濾波器換成自訂的 OPATH 濾波器，反之亦然。你只能修改現有的過濾器。

您必須已獲指派權限，才能執行此指令程式。雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName

此範例為 GAL 指派新名稱 GALwithNewName，GUID 為 96d0c505-eba8-4103-ad4f-577a1bf4ad7b。

參數

-ConditionalCompany

ConditionalCompany 參數指定一個預設過濾器，基於接收者公司屬性的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute1

ConditionalCustomAttribute1 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute1 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute10

ConditionalCustomAttribute10 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute10 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute11

ConditionalCustomAttribute11 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute11 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute12

ConditionalCustomAttribute12 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute12 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute13

ConditionalCustomAttribute13 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute13 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute14

ConditionalCustomAttribute14 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute14 屬性的值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute15

ConditionalCustomAttribute15 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute15 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute2

ConditionalCustomAttribute2 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute2 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute3

ConditionalCustomAttribute3 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute3 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute4

ConditionalCustomAttribute4 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute4 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute5

ConditionalCustomAttribute5 參數指定一個預設過濾器，該過濾器基於接收者的 CustomAttribute5 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute6

ConditionalCustomAttribute6 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute6 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute7

ConditionalCustomAttribute7 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute7 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute8

ConditionalCustomAttribute8 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute8 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalCustomAttribute9

ConditionalCustomAttribute9 參數指定一個預設過濾器，該過濾器基於接收方的 CustomAttribute9 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalDepartment

ConditionalDepartment 參數指定一個預設過濾器，該過濾器基於接收者的 Department 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConditionalStateOrProvince

ConditionalStateOrProvince 參數指定一個預設過濾器，該過濾器基於接收者的 StateOrProvince 屬性值。您可以指定多個以逗號分隔的值。

當你對此參數使用多個值時，會套用 OR 布林運算子。欲了解更多條件參數的運作方式，請參閱本文的詳細說明章節。

若要輸入多個覆蓋現有條目的值，請使用以下語法： Value1,Value2,...ValueN。如果這些值包含空格或需要引號，請使用下列語法: "Value","Value2",..."ValueN"。

若要新稱或移除一個或多個值，而不影響任何現有的項目，請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。此切換對指令令的影響取決於指令令是否需要確認後才能繼續。

破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。對於這些指令，若未設定 Confirm 開關，會產生暫停，迫使你在繼續前確認該指令。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，dc01.contoso.com。

參數屬性

類型:	Fqdn
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ForceUpgrade

此參數僅適用於內部部署 Exchange。

ForceUpgrade 交換器會抑制如果該物件是在先前版本 Exchange 中建立時會出現的確認訊息。您不需要使用此參數指定值。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Identity

Identity 參數指定你想修改的全域地址清單。您可以使用任何可唯一識別 GAL 的值。例如：

名稱
辨別名稱 (DN)
GUID

參數屬性

類型:	GlobalAddressListIdParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-IncludedRecipients

IncludedRecipients 參數指定一個預設的過濾器，該過濾器基於接收者類型。有效值為：

AllRecipients：此值僅能單獨使用。
MailboxUsers
郵件聯絡人
郵件群組
MailUsers
MailUsers

您可以指定多個以逗號分隔的值。當你使用多個值時，會套用 OR 布林運算子。

參數屬性

類型:	WellKnownRecipientType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

名稱參數指定 GAL 的唯一名稱。最大長度為 64 個字元。如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RecipientContainer

此參數僅適用於內部部署 Exchange。

RecipientContainer 參數指定一個基於收件人在 Active Directory 中位置的過濾器。此參數的有效輸入是由 Get-OrganizationalUnit 指令碼返回 (OU) 或領域中的組織單位。您可以使用唯一識別 OU 或網域的任何值。例如：

名稱
名稱
辨別名稱 (DN)
GUID

GUID

參數屬性

類型:	OrganizationalUnitIdParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RecipientFilter

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 語法資訊」。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

意見反應

此頁面對您有幫助嗎？