Partager via

Update-ServiceFabricApplicationUpgrade

  • Référence
Module:
ServiceFabric

Modifie la description de mise à niveau d’une mise à niveau d’une application active.

Syntaxe

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

Description

L’applet de commande Update-ServiceFabricApplicationUpgrade modifie les paramètres d’une description de mise à niveau d’application pendant que la mise à niveau est toujours active. Service Fabric détecte et applique des modifications en fonction de la valeur UpgradeStatusPollInterval , comme spécifié dans le manifeste du cluster. À l’exception des stratégies d’évaluation de l’intégrité, cette applet de commande met à jour uniquement les paramètres que vous spécifiez. Les paramètres non spécifiés restent non affectés. Vous devez mettre à jour les stratégies d’évaluation d’intégrité suivantes ensemble, pas individuellement :

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster .

Exemples

Exemple 1 : Mettre à jour une valeur pour une mise à niveau d’application

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

Cette commande définit la valeur de délai d’expiration du jeu de réplicas sur 0 pour une mise à niveau en attente sur fabric:/MyApplication. La mise à jour laisse toutes les autres valeurs de mise à niveau seules.

Paramètres

-ApplicationName

Spécifie l’URI (Uniform Resource Identifier) d’une application Service Fabric. L’applet de commande met à jour les paramètres de la mise à niveau de l’application avec l’URI spécifié par ce paramètre.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-ConsiderWarningAsError

Indique s’il faut traiter un rapport d’intégrité d’avertissement comme erreur lors de l’évaluation de l’intégrité.

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

-DefaultServiceTypeHealthPolicy

Spécifie la stratégie d’intégrité par défaut pour les types de service. La stratégie d’intégrité est utilisée pour la mise à niveau surveillée. La stratégie suit le format MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Par exemple, 5,10,15 indique les valeurs suivantes :

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FailureAction

Spécifie l’action à entreprendre si la mise à niveau surveillée échoue. Les valeurs valides pour ce paramètre sont :

  • Restauration
  • Manuel
Type:UpgradeFailureAction
Valeurs acceptées:Invalid, Rollback, Manual
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Indique que cette applet de commande ignore le message d’avertissement et force la mise à jour.

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

-ForceRestart

Indique si l’hôte de service redémarre même si la mise à niveau est une modification de configuration uniquement.

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

-HealthCheckRetryTimeoutSec

Spécifie la durée, en secondes, après laquelle Service Fabric réessaye la vérification d’intégrité si la vérification d’intégrité précédente échoue.

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

-HealthCheckStableDurationSec

Spécifie la durée, en secondes, que Service Fabric attend pour vérifier que l’application est stable avant qu’elle continue vers le domaine de mise à niveau suivant ou termine la mise à niveau. Cette durée d’attente empêche les modifications non détectées de l’intégrité juste après l’exécution du contrôle d’intégrité.

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

-HealthCheckWaitDurationSec

Spécifie la durée, en secondes, que Service Fabric attend avant d’effectuer le contrôle d’intégrité initial une fois la mise à niveau terminée sur le domaine de mise à niveau.

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

-InstanceCloseDelayDurationSec

Spécifie la durée en secondes, à attendre avant qu’une instance sans état impactée par la mise à niveau de l’application soit fermée, pour permettre aux requêtes actives de se vider correctement. Cette durée d’attente est effective uniquement pour les instances de ces services sans état qui ont une valeur non nulle configurée pour l’instanceCloseDelayDuration, et remplacent la valeur préconfigurée. Pour plus d’informations, consultez InstanceCloseDelayDuration .

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

-MaxPercentUnhealthyDeployedApplications

Spécifie le pourcentage maximal d’applications déployées tolérées qui peuvent avoir un état d’intégrité d’erreur. Si le pourcentage d’instances d’application non saines déployées sur les nœuds du cluster dépasse la valeur spécifiée par ce paramètre, l’état d’intégrité de l’application est une erreur.

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

-ServiceTypeHealthPolicyMap

Spécifie la carte de la stratégie d’intégrité à utiliser pour différents types de service. Spécifiez la carte en tant que table de hachage au format suivant : @ {"ServiceTypeName » : « MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Exemple :

@{ « ServiceTypeName01 » = « 5,10,5 »; « ServiceTypeName02 » = « 5,5,5 » }

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

-TimeoutSec

Spécifie la période 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

-UpgradeDomainTimeoutSec

Spécifie la durée maximale, en secondes, que Service Fabric prend pour mettre à niveau un domaine de mise à niveau unique. Après cette période, la mise à niveau échoue.

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

-UpgradeMode

Spécifie le nouveau UpgradeMode pour la mise à niveau.

Type:RollingUpgradeMode
Valeurs acceptées:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UpgradeReplicaSetCheckTimeoutSec

Spécifie la durée maximale, en secondes, que Service Fabric attend qu’un service reconfigure dans un état sûr, s’il n’est pas déjà dans un état sûr, avant que Service Fabric continue avec la mise à niveau.

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

-UpgradeTimeoutSec

Spécifie la durée maximale, en secondes, que Service Fabric prend pour toute la mise à niveau. Après cette période, la mise à niveau échoue.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

None

Sorties

System.Object