Share via


Add-ServiceFabricConfigurationParameterOverrides

將一或多個暫存組態覆寫 () 新增至指定的叢集節點。

Syntax

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:將覆寫新增至放置/負載平衡的組態參數

$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

指定 SectionNameParameterNameParameterValue (和選擇性 逾時 值的物件清單,請參閱每個所需組態覆寫的 範例 1) 。

選擇性 逾時 值會指定覆寫的持續時間。 預設值為 1 天;最大持續時間為 7 天。

Type:System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

強制覆寫其他不可覆寫的組態參數。 需要此旗標的參數通常不安全,無法變更。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeName

組態覆寫將套用的叢集節點名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

指定作業的逾時期間,以秒為單位。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

System.Object