Add-ServiceFabricConfigurationParameterOverrides
指定したクラスター ノードに 1 つ以上の一時的な構成オーバーライドを追加します。
構文
Add-ServiceFabricConfigurationParameterOverrides
-NodeName <String>
-ConfigParameterOverrideList <System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]>
[-Force]
[-TimeoutSec <Int32>]
[<CommonParameters>]
説明
動的ノード構成パラメーターは一時的に変更できますが、一部のパラメーターは一般的に変更しても安全でがないため、-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
必要な構成オーバーライドごとに、SectionName、ParameterName、および ParameterValue (および省略可能な タイムアウト 値) を指定するオブジェクトの一覧 例 1を参照してください。
省略可能な タイムアウト 値は、オーバーライドの期間を指定します。 既定値は 1 日です。最大期間は 7 日です。
型: | System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
それ以外の場合はオーバーライドできない構成パラメーターを強制的にオーバーライドします。 このフラグを必要とするパラメーターは、通常、変更するのは安全ではありません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NodeName
構成オーバーライドが適用されるクラスター ノードの名前。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object