Set-ExchangeSettings
內部部署 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 |