Condividi tramite

Update-ServiceFabricApplicationUpgrade

  • Riferimento
Modulo:
ServiceFabric

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

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 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 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 set di repliche su 0 per un aggiornamento in sospeso in fabric:/MyApplication. L'aggiornamento lascia solo 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 la conferma dell'utente 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 di 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. 5,10,15, ad esempio, 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 ha esito negativo. I valori validi per questo parametro sono:

  • Rollback
  • 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, in secondi, dopo la quale Service Fabric esegue il tentativo di verifica dell'integrità se il controllo di 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, che Service Fabric attende per verificare che l'applicazione sia stabile prima di continuare con il dominio di aggiornamento successivo o completare 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 svuotare in modo corretto. Questa durata di attesa è valida solo per le istanze di tali servizi senza stato che hanno un valore diverso da zero configurato per InstanceCloseDelayDuration e 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 diversi tipi di servizio. Specificare la mappa come tabella hash nel formato seguente: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Ad 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, 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, che Service Fabric richiede per aggiornare un singolo dominio di aggiornamento. Dopo questo periodo, l'aggiornamento ha esito negativo.

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, che Service Fabric richiede per l'intero aggiornamento. Dopo questo periodo, l'aggiornamento ha esito negativo.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. 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