Compartir a través de

Add-ServiceFabricConfigurationParameterOverrides

  • Referencia
Módulo:
ServiceFabric

Agrega una o varias invalidaciones de configuración temporal al nodo de clúster especificado.

Syntax

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

Description

Los parámetros de configuración de nodos dinámicos se pueden cambiar temporalmente, aunque algunos requieren la -Force marca, ya que generalmente no son seguros para cambiar. Solo se pueden invalidar parámetros con tipos simples; los parámetros de tipo complejo no se pueden invalidar.

Ejemplos

Ejemplo 1: Habilitación del comando en el manifiesto del clúster

Este comando está deshabilitado de forma predeterminada. Habilite esta opción agregando el siguiente parámetro de configuración dinámica al manifiesto del clúster:

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

Ejemplo 2: Adición de invalidación al parámetro de configuración para la selección de ubicación o equilibrio de carga

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

Ejemplo 3: Agregar invalidaciones de configuración a cada nodo

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

Ejemplo 4: Comprobación de que una invalidación se aplicó correctamente a un nodo

Para comprobar que una invalidación se aplicó correctamente al nodo, llame al comando Get-ServiceFabricConfigurationOverrides o compruebe el archivo ConfigurationOverride.xml en el nodo, por ejemplo:

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

Parámetros

-ConfigParameterOverrideList

Lista de objetos que especifican SectionName, ParameterName y ParameterValue (y el valor de tiempo de espera opcional, vea Ejemplo 1) para cada invalidación de configuración deseada.

El valor de tiempo de espera opcional especifica la duración de la invalidación. El valor predeterminado es 1 día; la duración máxima es de 7 días.

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

Obliga a invalidar los parámetros de configuración que, de lo contrario, no se pueden invalidar. Los parámetros que requieren esta marca generalmente no son seguros para cambiar.

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

-NodeName

Nombre del nodo de clúster al que se aplicará la invalidación de configuración.

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

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

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

Entradas

None

Salidas

System.Object