Compartilhar via

Add-ServiceFabricConfigurationParameterOverrides

  • Referência
Módulo:
ServiceFabric

Adiciona uma ou mais substituições de configuração temporárias ao nó de cluster especificado.

Syntax

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

Description

Os parâmetros de configuração de nó dinâmico podem ser alterados temporariamente, embora alguns exijam o -Force sinalizador, pois geralmente não são seguros para serem alterados. Somente parâmetros com tipos simples podem ser substituídos; parâmetros de tipo complexos não são substituíveis.

Exemplos

Exemplo 1: Habilitar o comando no manifesto do cluster

Esse comando está desabilitado por padrão. Habilite-o adicionando o seguinte parâmetro de configuração dinâmica ao manifesto do cluster:

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

Exemplo 2: Adicionar substituição ao parâmetro de configuração para posicionamento/balanceamento 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]

Exemplo 3: Adicionar substituições de configuração a cada nó

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

Exemplo 4: Verificar se uma substituição foi aplicada com êxito a um nó

Para verificar se uma substituição foi aplicada com êxito ao nó, chame o comando Get-ServiceFabricConfigurationOverrides ou verifique o arquivo ConfigurationOverride.xml no nó, por exemplo:

<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 especificam o SectionName, ParameterName e ParameterValue (e o valor de tempo limite opcional, consulte Exemplo 1) para cada substituição de configuração desejada.

O valor de tempo limite opcional especifica a duração da substituição. O padrão é 1 dia; duração máxima é de 7 dias.

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

Força parâmetros de configuração que, de outra forma, não podem ser substituídos. Os parâmetros que exigem esse sinalizador geralmente não são seguros para serem alterados.

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

-NodeName

Nome do nó de cluster ao qual a substituição de configuração será aplicada.

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

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

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

Entradas

None

Saídas

System.Object