Update-ServiceFabricApplicationUpgrade

  • Riferimento
Modulo:
ServiceFabric

Modifica la descrizione dell'aggiornamento di un aggiornamento dell'applicazione attivo.

Sintassi

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Update-ServiceFabricApplicationUpgrade modifica i parametri di una descrizione dell'aggiornamento dell'applicazione mentre l'aggiornamento è ancora attivo. Service Fabric rileva e applica le modifiche in base al valore UpgradeStatusPollInterval, come specificato nel manifesto del cluster. Ad eccezione dei criteri di valutazione dell'integrità, questo cmdlet aggiorna solo i parametri specificati. I parametri non specificati rimangono invariati. È necessario aggiornare insieme i criteri di valutazione dell'integrità seguenti, non singolarmente:

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster.

Esempio

Esempio 1: Aggiornare un valore per un aggiornamento dell'applicazione

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Questo comando imposta il valore di timeout del timeout del set di repliche su 0 per un aggiornamento in sospeso in fabric:/MyApplication. L'aggiornamento lascia soli tutti gli altri valori di aggiornamento.

Parametri

-ApplicationName

Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric. Il cmdlet aggiorna le impostazioni per l'aggiornamento per l'applicazione con l'URI specificato da questo parametro.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-ConsiderWarningAsError

Indica se considerare un report sull'integrità degli avvisi come errore durante la valutazione dell'integrità.

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

-DefaultServiceTypeHealthPolicy

Specifica i criteri di integrità predefiniti per i tipi di servizio. I criteri di integrità vengono usati per l'aggiornamento monitorato. Il criterio segue il formato MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Ad esempio, 5.10.15 indica i valori seguenti:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FailureAction

Specifica l'azione da eseguire se l'aggiornamento monitorato non riesce. I valori accettabili per questo parametro sono:

  • Replica
  • Manuale
Tipo:UpgradeFailureAction
Valori accettati:Invalid, Rollback, Manual
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che questo cmdlet ignora il messaggio di avviso e forza l'aggiornamento.

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

-ForceRestart

Indica se l'host del servizio viene riavviato anche se l'aggiornamento è una modifica di sola configurazione.

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

-HealthCheckRetryTimeoutSec

Specifica la durata, espressa in secondi, dopo la quale Service Fabric ritenta il controllo integrità se il controllo integrità precedente ha esito negativo.

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

-HealthCheckStableDurationSec

Specifica la durata, in secondi, di attesa di Service Fabric per verificare che l'applicazione sia stabile prima che continui al dominio di aggiornamento successivo o completi l'aggiornamento. Questa durata di attesa impedisce modifiche non rilevate dell'integrità subito dopo l'esecuzione del controllo integrità.

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

-HealthCheckWaitDurationSec

Specifica la durata, in secondi, che Service Fabric attende prima di eseguire il controllo di integrità iniziale al termine dell'aggiornamento nel dominio di aggiornamento.

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

-InstanceCloseDelayDurationSec

Specifica la durata in secondi, per attendere prima che un'istanza senza stato interessata dall'aggiornamento dell'applicazione venga chiusa, per consentire alle richieste attive di svuotarsi normalmente. Questa durata di attesa è valida solo per le istanze di tali servizi senza stato con un valore diverso da zero configurato per InstanceCloseDelayDuration ed eseguirà l'override del valore preconfigurato. Per informazioni dettagliate, vedere InstanceCloseDelayDuration.

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

-MaxPercentUnhealthyDeployedApplications

Specifica la percentuale massima di applicazioni distribuite tollerate che possono avere uno stato di integrità di errore. Se la percentuale di istanze dell'applicazione non integre distribuite nei nodi del cluster supera il valore specificato da questo parametro, lo stato di integrità dell'applicazione è errore.

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

-ServiceTypeHealthPolicyMap

Specifica la mappa dei criteri di integrità da usare per tipi di servizio diversi. Specificare la mappa come tabella hash nel formato seguente: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Per esempio:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
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

-UpgradeDomainTimeoutSec

Specifica il tempo massimo, in secondi, impiegato da Service Fabric per aggiornare un singolo dominio di aggiornamento. Dopo questo periodo, l'aggiornamento non riesce.

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

-UpgradeMode

Specifica il nuovo UpgradeMode per l'aggiornamento.

Tipo:RollingUpgradeMode
Valori accettati:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UpgradeReplicaSetCheckTimeoutSec

Specifica il tempo massimo, in secondi, che Service Fabric attende che un servizio venga riconfigurato in uno stato sicuro, se non già in uno stato sicuro, prima che Service Fabric proceda con l'aggiornamento.

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

-UpgradeTimeoutSec

Specifica il tempo massimo, in secondi, richiesto da Service Fabric per l'intero aggiornamento. Dopo questo periodo, l'aggiornamento non riesce.

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

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

Input

None

Output

System.Object