Add-ServiceFabricConfigurationParameterOverrides
將一或多個暫存組態覆寫新增至指定的叢集節點。
語法
Add-ServiceFabricConfigurationParameterOverrides
-NodeName <String>
-ConfigParameterOverrideList <System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]>
[-Force]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
動態節點組態參數可以暫時變更,不過有些參數需要 -Force
旗標,因為它們通常不安全而無法變更。 只能覆寫具有簡單類型的參數;無法覆寫複雜類型參數。
範例
範例 1:在叢集指令清單中啟用 命令
此命令預設為停用。 將下列動態組態參數新增至叢集指令清單來啟用它:
<Section Name="Testability">
<Parameter Name="AllowConfigurationOverrides" Value="true" />
</Section>
範例 2:將覆寫新增至用於放置/負載平衡的 config 參數
$timeout = New-TimeSpan -Hours 3 -Minutes 30
$configOverride = New-Object -TypeName System.Fabric.Description.ConfigParameterOverride(
"PlacementAndLoadBalancing",
"DummyPLBEnabled",
"True",
$timeout)
$configOverrideList = New-Object 'System.Collections.Generic.List[System.Fabric.Description.ConfigParameterOverride]'
$configOverrideList.Add($configOverride)
Add-ServiceFabricConfigurationParameterOverrides -NodeName DB.0 -ConfigParameterOverrideList $configOverrideList [-Force]
範例 3:將組態覆寫新增至每個節點
Get-ServiceFabricNode | ForEach-Object {Add-ServiceFabricConfigurationParameterOverrides -NodeName $_.NodeName -ConfigParameterOverrideList $confOverrideList}
範例 4:確認覆寫已成功套用至節點
若要確認覆寫已成功套用至節點,請呼叫 Get-ServiceFabricConfigurationOverrides 命令,或檢查節點上的 ConfigurationOverride.xml 檔案,例如:
<Settings xmlns="http://schemas.microsoft.com/2011/01/fabric">
<Section Name="PlacementAndLoadBalancing">
<Parameter SectionName="PlacementAndLoadBalancing" Name="MoveParentToFixAffinityViolation" Value="True" Timeout="2019-11-20 14:33:24.326" PersistAcrossUpgrade="false" IsEncrypted="false" Type="" />
</Section>
</Settings>
參數
-ConfigParameterOverrideList
指定 SectionName、ParameterName和 ParameterValue 的物件清單(以及選擇性 逾時 值,請參閱 每個所需組態覆寫的範例 1)。
選擇性 逾時 值會指定覆寫的持續時間。 默認值為 1 天;最大持續時間為7天。
類型: | System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride] |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
強制覆寫不可覆寫的組態參數。 需要此旗標的參數通常不安全,無法變更。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NodeName
將套用組態覆寫的叢集節點名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-TimeoutSec
指定作業的逾時期間,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
System.Object