Partager via

Add-ServiceFabricConfigurationParameterOverrides

  • Référence
Module:
ServiceFabric

Ajoute une ou plusieurs substitutions de configuration temporaires au nœud de cluster spécifié.

Syntaxe

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

Description

Les paramètres de configuration de nœud dynamique peuvent être temporairement modifiés, même si certains nécessitent l’indicateur -Force, car ils sont généralement dangereux de changer. Seuls les paramètres avec des types simples peuvent être substitués ; les paramètres de type complexes ne sont pas substituables.

Exemples

Exemple 1 : Activer la commande dans le manifeste du cluster

Cette commande est désactivée par défaut. Activez-le en ajoutant le paramètre de configuration dynamique suivant au manifeste du cluster :

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

Exemple 2 : Ajouter un remplacement au paramètre de configuration pour le placement/ l’équilibrage de charge

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

Exemple 3 : Ajouter des remplacements de configuration à chaque nœud

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

Exemple 4 : Vérifier qu’un remplacement a été appliqué avec succès à un nœud

Pour vérifier qu’une substitution a été correctement appliquée au nœud, appelez la commande Get-ServiceFabricConfigurationOverrides ou vérifiez le fichier ConfigurationOverride.xml sur le nœud, par exemple :

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

Paramètres

-ConfigParameterOverrideList

Liste d’objets spécifiant les SectionName, ParameterNameet ParameterValue (et facultatif valeur de délai d’expiration, consultez Exemple 1) pour chaque remplacement de configuration souhaité.

La valeur facultative délai d’expiration spécifie la durée du remplacement. La valeur par défaut est 1 jour ; la durée maximale est de 7 jours.

Type:System.Collections.Generic.List`1[System.Fabric.Description.ConfigParameterOverride]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force les paramètres de configuration qui ne sont pas substituables autrement. Les paramètres nécessitant cet indicateur sont généralement dangereux à modifier.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NodeName

Nom du nœud de cluster auquel le remplacement de configuration s’applique.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object