Freigeben über

Add-ServiceFabricConfigurationParameterOverrides

  • Referenz
Modul:
ServiceFabric

Fügt dem angegebenen Clusterknoten eine oder mehrere temporäre Konfigurationsüberschreibungen hinzu.

Syntax

Add-ServiceFabricConfigurationParameterOverrides
   -NodeName <String>
   -ConfigParameterOverrideList <System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]>
   [-Force]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Beschreibung

Dynamische Knotenkonfigurationsparameter können vorübergehend geändert werden, obwohl einige das -Force Flag erfordern, da sie in der Regel nicht sicher zu ändern sind. Es können nur Parameter mit einfachen Typen außer Kraft gesetzt werden. Komplexe Typparameter können nicht überschrieben werden.

Beispiele

Beispiel 1: Aktivieren des Befehls im Clustermanifest

Dieser Befehl ist standardmäßig deaktiviert. Aktivieren Sie ihn, indem Sie dem Clustermanifest den folgenden dynamischen Konfigurationsparameter hinzufügen:

<Section Name="Testability">
    <Parameter Name="AllowConfigurationOverrides" Value="true" />
</Section>

Beispiel 2: Hinzufügen einer Außerkraftsetzung zum Konfigurationsparameter für Platzierung/Lastenausgleich

$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]

Beispiel 3: Hinzufügen von Konfigurationsüberschreibungen zu jedem Knoten

Get-ServiceFabricNode | ForEach-Object {Add-ServiceFabricConfigurationParameterOverrides -NodeName $_.NodeName -ConfigParameterOverrideList $confOverrideList}

Beispiel 4: Überprüfen, ob eine Außerkraftsetzung erfolgreich auf einen Knoten angewendet wurde

Um zu überprüfen, ob eine Außerkraftsetzung erfolgreich auf den Knoten angewendet wurde, rufen Sie entweder die Get-ServiceFabricConfigurationOverrides Befehl auf, oder überprüfen Sie die ConfigurationOverride.xml Datei auf dem Knoten, z. B.:

<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>

Parameter

-ConfigParameterOverrideList

Liste der Objekte, die den wert SectionName, ParameterNameund ParameterValue- (und optional Timeout Wert angeben, siehe Beispiel 1) für jede gewünschte Konfigurationsüberschreibung.

Der optionale Timeout Werts gibt die Dauer der Außerkraftsetzung an. Der Standardwert ist 1 Tag; Die maximale Dauer beträgt 7 Tage.

Typ:System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt Konfigurationsparameter, die andernfalls nicht außer Kraft gesetzt werden können, um außer Kraft zu setzen. Parameter, die dieses Flag erfordern, sind in der Regel nicht sicher, um sich zu ändern.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeName

Name des Clusterknotens, auf den die Außerkraftsetzung der Konfiguration angewendet wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object