Set-ExchangeSettings

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

使用 Set-ExchangeSettings Cmdlet 來設定您使用 New-ExchangeSettings Cmdlet 建立的 Exchange 設定物件。

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

Syntax

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-ClearHistory]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ConfigName <String>
   -ConfigValue <String>
   -Reason <String>
   [-UpdateSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ConfigName <String>
   -Reason <String>
   [-RemoveSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ExpirationDate <DateTime>
   -Reason <String>
   [-ConfigPairs <String[]>]
   [-Confirm]
   [-CreateSettingsGroup]
   [-Disable]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-MaxVersion <String>]
   [-MinVersion <String>]
   [-NameMatch <String>]
   [-Priority <Int32>]
   [-Scope <ExchangeSettingsScope>]
   [-ScopeFilter <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ExpirationDate <DateTime>
   -GuidMatch <Guid>
   -Reason <String>
   [-ConfigPairs <String[]>]
   [-Confirm]
   [-CreateSettingsGroup]
   [-Disable]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-Priority <Int32>]
   [-Scope <ExchangeSettingsScope>]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -SettingsGroup <String>
   [-CreateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ExpirationDate <DateTime>
   -Reason <String>
   [-CreateSettingsGroup]
   [-ConfigPairs <String[]>]
   [-GenericScopeName <String>]
   [-GenericScopeValue <String>]
   [-GroupName <String>]
   [-Confirm]
   [-Disable]
   [-DomainController <Fqdn>]
   [-Force]
   [-Priority <Int32>]
   [-Scope <ExchangeSettingsScope>]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-ExpirationDate <DateTime>]
   [-GroupName <String>]
   [-UpdateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Priority <Int32>]
   [-ScopeFilter <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -ConfigPairs <String[]>
   [-GroupName <String>]
   [-RemoveSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-GroupName <String>]
   [-RemoveSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -SettingsGroup <String>
   [-UpdateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -ConfigPairs <String[]>
   [-GroupName <String>]
   [-UpdateSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-EnableGroup <String>]
   [-DisableGroup <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Set-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

此範例可讓使用者查看整合稽核記錄的結果。本範例假設您已執行 -Name Audit 命令，以建立 Audit 組態架構的 Exchange 設定物件New-ExchangeSettings。

參數

-ClearHistory

ClearHistory 參數會指定您想要清除 Exchange 設定物件修改歷程記錄中的專案。您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-ConfigName

ConfigName 參數會指定您要在 Exchange 設定物件中新增、移除或更新的可用 Exchange 設定。此參數的有效值取決於 New-ExchangeSettings Cmdlet 上 Name 參數所指定的組態架構。

針對新增和更新作業，您也需要使用 ConfigValue 參數來指定設定的實際值。您無法搭配 ConfigPairs 參數使用 ConfigName 參數。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-ConfigPairs

ConfigName 參數會指定您要在 Exchange 設定物件中新增、移除或更新的可用 Exchange 設定。此參數的有效值取決於 New-ExchangeSettings Cmdlet 上 Name 參數所指定的組態架構。值的語法為 <Key>=<Value> 。您可以分隔多個以逗號分隔的值。

您無法搭配 ConfigName 或 ConfigValue 參數使用 ConfigPairs 參數。

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-ConfigValue

ConfigValue 參數會指定您使用 ConfigName 參數指定之 Exchange 設定的值。這些值取決於設定類型 (數位、時間範圍、$true或$false等) 。

您無法搭配 ConfigPairs 參數使用 ConfigValue 參數。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-CreateSettingsGroup

CreateSettingsGroup 參數會指定您要建立 Exchange 設定群組，這是一組相關的 Exchange 設定。您不需要使用此參數指定值。

視您要設定設定群組的方式而定，您可以使用 GroupName 參數或 SettingsGroup 參數來指定 Exchange 設定群組的名稱。請謹慎選擇，因為您無法重新命名現有的設定群組。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Disable

[停用] 參數會指定已停用 Exchange 設定群組。您不需要使用此參數指定值。

您只能搭配 CreateSettingsGroup 參數使用此參數。

若要使用此參數來啟用 Exchange 設定群組，請使用這個確切語 -Disable:$false 法。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-DisableGroup

DisableGroup 參數會指定您想要停用的已啟用 Exchange 設定組名。如果值包含空格，請使用引號 (") 括住值。

您可以在同一個命令中同時使用 DisableGroup 和 EnableGroup 參數，同時啟用和停用不同的 Exchange 設定群組。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-DomainController

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-EnableGroup

EnableGroup 參數會指定您想要啟用的已停用 Exchange 設定組名。如果值包含空格，請使用引號 (") 括住值。

您可以在同一個命令中同時使用 DisableGroup 和 EnableGroup 參數，同時啟用和停用不同的 Exchange 設定群組。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-ExpirationDate

ExpirationDate 參數會指定由指定 Exchange 設定群組所定義之 Exchange 設定的結束日期/時間。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。您可以只輸入日期，或者也可以輸入日期和時間。如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。

您只能搭配 CreateSettingsGroup 或 UpdateSettings 群組參數使用 ExpirationDate 參數。

Type:	DateTime
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Force

Force 參數會隱藏警告或確認訊息。您不需要使用此參數指定值。

在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-GenericScopeName

GenericScopeName 參數會指定範圍的名稱。可用的值取決於 Exchange 設定物件的架構。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-GenericScopeValue

GenericScopeValue 參數會指定 GenericScopeName 參數所指定範圍的值。可用的值取決於 Exchange 設定物件的架構。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-GroupName

GroupName 參數會指定群組作業中 Exchange 設定群組的名稱。例如：

建立 Exchange 設定群組，並同時設定群組範圍和優先順序。
修改現有 Exchange 設定群組的 ExpirationDate、Priority 和 ScopeFilter 值。
移除現有的 Exchange 設定群組。
新增、移除或更新現有 Exchange 設定群組中的 Exchange 設定物件。

如果值包含空格，請使用引號 (") 括住值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-GuidMatch

GuidMatch 參數會根據物件的 GUID 來指定 Exchange 設定群組的範圍 (例如信箱資料庫的 GUID) 。此參數可用於樹系以外的所有 Scope 參數值。

只有當您使用 CreateSettingsGroup 參數搭配 GroupName 參數建立 Exchange 設定群組時，才會使用 GuidMatch 參數。

您無法搭配 GenericScopeName、GenericScopeValue、MaxVersion、MinVersion 或 NameMatch 參數使用此參數。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定現有 Exchange 設定物件的名稱，其中包含您想要設定的 Exchange 設定。

這個參數的值是建立 Exchange 設定物件時，New-ExchangeSetting Cmdlet 上 Name 參數的值。

Type:	ExchangeSettingsIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-MaxVersion

MaxVersion 參數會根據物件版本 (指定 Exchange 設定群組的範圍，例如，安裝在伺服器上的 Exchange 版本) 。此參數可用於樹系以外的所有 Scope 參數值。

只有在使用 CreateSettingsGroup 參數搭配 GroupName 參數建立 Exchange 設定群組時，才可以使用 MaxVersion 參數與 MinVersion 參數。

您無法搭配 GuidMatch、GenericScopeName 或 GenericScopeValue 參數使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-MinVersion

MinVersion 參數會根據物件的版本來指定 Exchange 設定群組的範圍 (例如，安裝在伺服器上的 Exchange 版本) 。此參數可用於樹系以外的所有 Scope 參數值。

只有當您使用 CreateSettingsGroup 參數搭配 GroupName 參數建立 Exchange 設定群組時，才能使用 MinVersion 參數與 MaxVersion 參數。

您無法搭配 GuidMatch、GenericScopeName 或 GenericScopeValue 參數使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-NameMatch

NameMatch 參數會根據物件的名稱來指定 Exchange 設定群組的範圍 (例如，進程名稱) 。此參數可用於樹系以外的所有 Scope 參數值。

只有當您使用 CreateSettingsGroup 參數搭配 GroupName 參數建立 Exchange 設定群組時，才會使用 NameMatch 參數。

您無法搭配 GuidMatch、GenericScopeName 或 GenericScopeValue 參數使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Priority

Priority 參數會指定 Exchange 設定群組的優先順序。每個群組的優先順序值必須是唯一的。較低的優先順序值表示較高的優先順序。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Reason

Reason 參數會指定建立或修改 Exchange 設定群組的原因描述。如果值包含空格，請使用引號 (") 括住值。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-RemoveSetting

RemoveSetting 參數會指定您要從 Exchange 設定物件移除現有的 Exchange 設定。您不需要使用此參數指定值。

您可以使用 ConfigPairs 參數或 ConfigName 參數來指定您要移除的設定。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-RemoveSettingsGroup

RemoveSettingsGroup 參數會指定您要移除 Exchange 設定群組。您不需要使用此參數指定值。

您可以使用 GroupName 參數來指定要移除的 Exchange 設定群組。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Scope

Scope 參數會指定 Exchange 設定物件的範圍。有效值為：

Dag
Database
樹系
Generic
Organization
程序
伺服器
使用者

Type:	ExchangeSettingsScope
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-ScopeFilter

ScopeFilter 參數會使用 OPATH 篩選語法來指定以 Exchange 設定群組為基礎的範圍。語法為 "Property -ComparisonOperator 'Value'" (例如，"ServerRole -like 'Mailbox*'")。

以雙引號「」括住整個 OPATH 篩選準則。如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
Property 是可篩選的屬性。
ComparisonOperator 是 OPATH 比較運算子 (例如 -eq equals 和 -like 字串比較) 。如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。
Value 是要搜尋的屬性值。以單引號括住文字值和變數 ('Value' 或 '$Variable')。如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。例如，使用 '$($User -Replace "'","''")'，而不是 '$User'。請勿以引號括住整數或系統值 (例如，請改用 500 、 $true 、 $false 或 $null) 。

您可以使用邏輯運算子 -and 和 -or 將多個搜尋準則鏈結在一起。例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。

如需 Exchange 中 OPATH 篩選的詳細資訊，請參閱其他 OPATH 語法資訊。

您無法搭配 Scope 參數和值 Forest 或其他範圍相關參數使用此參數。

只有當您使用 UpdateSettingsGroup 參數搭配 GroupName 參數來更新 Exchange 設定群組時，才使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-SettingsGroup

SettingsGroup 參數會指定現有的 Exchange 設定群組，用來建立新的設定群組，或修改現有的設定群組。

您無法搭配 GroupName 參數使用 SettingsGroup 參數。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-UpdateSetting

UpdateSetting 參數會指定您要更新現有 Exchange 設定物件中的 Exchange 設定。您不需要使用此參數指定值。

您可以使用 ConfigPairs 參數或 ConfigName 和 ConfigValue 參數來設定 Exchange 設定。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-UpdateSettingsGroup

UpdateSettingsGroup 參數會指定您要修改 Exchange 設定群組。您不需要使用此參數指定值。

視您要設定設定群組的方式而定，您可以使用 GroupName 參數或 SettingsGroup 參數來指定要修改的 Exchange 設定群組。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf 參數會模擬命令的動作。使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。您不需要使用此參數指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

Set-ExchangeSettings

Syntax

Description

範例

範例 1

參數

-ClearHistory

-ConfigName

-ConfigPairs

-ConfigValue

-Confirm

-CreateSettingsGroup

-Disable

-DisableGroup

-DomainController

-EnableGroup

-ExpirationDate

-Force

-GenericScopeName

-GenericScopeValue

-GroupName

-GuidMatch

-Identity

-MaxVersion

-MinVersion

-NameMatch

-Priority

-Reason

-RemoveSetting

-RemoveSettingsGroup

-Scope

-ScopeFilter

-SettingsGroup

-UpdateSetting

-UpdateSettingsGroup

-WhatIf

意見反應

意見反應

其他資源