Set-GlobalAddressList
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Set-GlobalAddressList Cmdlet (GAL) 修改現有的全域通訊清單。
在 Exchange Online 中,此 Cmdlet 僅適用於通訊清單角色,而且預設情況下,該角色不會指派給任何角色群組。 若要使用此 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
此範例會將新名稱 GALwithNewName 指派給 GUID 為 96d0c505-eba8-4103-ad4f-577a1bf4ad7b 的 GAL。
參數
-ConditionalCompany
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(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 |
-ForceUpgrade
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
ForceUpgrade 參數會隱藏如果物件是在舊版 Exchange 中建立時顯示的確認訊息。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 參數會指定您要修改的全域通訊清單。 您可以使用任何可唯一識別 GAL 的值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | GlobalAddressListIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | 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 布林值運算子。
參數屬性
| 類型: | WellKnownRecipientType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Name 參數會指定 GAL 的唯一名稱。 最大長度為 64 個字元。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | 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 Cmdlet 傳回的組織單位 (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 比較運算子 (例如
-eq,用於等號和-like字串比較) 。 如需比較運算子的詳細資訊,請參閱 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
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。