Condividi tramite

Add-ServiceFabricConfigurationParameterOverrides

  • Riferimento
Modulo:
ServiceFabric

Aggiunge uno o più override di configurazione temporanea al nodo del cluster specificato.

Sintassi

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

Descrizione

È possibile modificare temporaneamente i parametri di configurazione dei nodi dinamici, anche se alcuni richiedono il flag di -Force, perché in genere non sono sicuri da modificare. È possibile eseguire l'override solo dei parametri con tipi semplici; i parametri di tipo complesso non sono sostituibili.

Esempio

Esempio 1: Abilitare il comando nel manifesto del cluster

Questo comando è disabilitato per impostazione predefinita. Abilitarlo aggiungendo il parametro di configurazione dinamico seguente al manifesto del cluster:

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

Esempio 2: Aggiungere override al parametro di configurazione per il posizionamento/bilanciamento del carico

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

Esempio 3: Aggiungere sostituzioni di configurazione a ogni nodo

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

Esempio 4: Verificare che un override sia stato applicato correttamente a un nodo

Per verificare che un override sia stato applicato correttamente al nodo, chiamare il comando Get-ServiceFabricConfigurationOverrides o controllare il file ConfigurationOverride.xml nel nodo, ad esempio:

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

Parametri

-ConfigParameterOverrideList

Elenco di oggetti che specificano SectionName, ParameterNamee ParameterValue (e valore facoltativo timeout, vedere esempio 1) per ogni override di configurazione desiderato.

Il valore facoltativo timeout specifica la durata dell'override. Il valore predefinito è 1 giorno; la durata massima è di 7 giorni.

Tipo:System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza l'override dei parametri di configurazione che altrimenti non possono essere sottoposti a override. I parametri che richiedono questo flag sono in genere non sicuri da modificare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NodeName

Nome del nodo del cluster a cui verrà applicato l'override della configurazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object