Update-ServiceFabricService

Module:

ServiceFabric

Met à jour un service Service Fabric.

Syntaxe

Update-ServiceFabricService
      [-Stateless]
      [-ServiceName] <Uri>
      [-InstanceCount <Int32>]
      [-MinInstanceCount <Int32>]
      [-MinInstancePercentage <Int32>]
      [-InstanceLifecycleDescription <InstanceLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-InstanceCloseDelayDuration <TimeSpan>]
      [-InstanceRestartWaitDuration <TimeSpan>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-ServiceFabricService
      [-Stateful]
      [-ServiceName] <Uri>
      [-TargetReplicaSetSize <Int32>]
      [-MinReplicaSetSize <Int32>]
      [-ReplicaRestartWaitDuration <TimeSpan>]
      [-QuorumLossWaitDuration <TimeSpan>]
      [-StandByReplicaKeepDuration <TimeSpan>]
      [-ServicePlacementTimeLimit <TimeSpan>]
      [-DropSourceReplicaOnMove <Boolean>]
      [-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La Update-ServiceFabricService cmdlet met à jour les propriétés d’un service Service Fabric en cours d’exécution. L’ensemble de propriétés pouvant être mis à jour est un sous-ensemble des propriétés spécifiées au moment de la création du service (à l’aide de New-ServiceFabricService ou de New-ServiceFabricServiceFromTemplate). Vous pouvez obtenir les propriétés actuelles de votre service à l’aide de Get-ServiceFabricServiceDescription.

Notez que la mise à jour des propriétés d’un service en cours d’exécution est différente de la mise à niveau de votre service à l’aide de Start-ServiceFabricApplicationUpgrade. La mise à niveau de votre service (par exemple, l’application) est une tâche en arrière-plan longue qui implique le déplacement de votre application, d’une version à l’autre, d’un domaine de mise à niveau à la fois. Pour plus d’informations, consultez mise à niveau des applications Service Fabric.

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 un service avec état

PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5

Cette commande met à jour les MinReplicaSetSize et TargetReplicaSetSize d’un service Fabric en cours d’exécution sur trois (3) et cinq (5).

Exemple 2 : Mettre à jour un service sans état

PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1

Cette commande met à jour le nombre d’instances d’un service Fabric en cours d’exécution sur la valeur -1.

Exemple 3 : Mettre à jour les contraintes de placement

PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"

Cette commande met à jour les contraintes de placement.

Exemple 4 : Mettre à jour les métriques de chargement par défaut

PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")

La première commande met à jour les métriques de chargement par défaut pour un service sans état.

La deuxième commande met à jour les métriques de chargement par défaut pour un service avec état.

Exemple 5 : Mettre à jour la stratégie de placement

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")

Cette commande met à jour la stratégie de placement.

Exemple 6 : Mettre à jour la corrélation de service

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")

Cette commande met à jour la corrélation de service.

Exemple 7 : Mettre à jour le nom DNS du service

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns

Cette commande met à jour le nom DNS du service d’un service. Remarque : Si le nom DNS mis à jour a déjà été interrogé sur le cluster ou que le service de mise à jour avait déjà un nom DNS, le service DNS doit être redémarré après la mise à jour pour invalider le cache.

Paramètres

-Confirm

Vous invite à confirmer 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

-Correlation

Spécifie un tableau mis à jour de contraintes de corrélation pour ce service. Pour en savoir plus sur la corrélation de service, consultez Configuration et utilisation de l’affinité de service dans Service Fabric.

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

-DefaultMoveCost

Spécifie le coût de déplacement par défaut mis à jour dont disposent les réplicas lors de leur création. Les valeurs acceptables pour ce paramètre sont les suivantes :

• Zéro
• Bas
• Douleur moyenne
• Haut

Pour plus d’informations sur le coût de déplacement, consultez coût de déplacement de service pour influencer les choix de Cluster Resource Manager.

Type:	String
Valeurs acceptées:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DropSourceReplicaOnMove

Permet aux réplicas secondaires sources d’être supprimés avant que les nouveaux réplicas secondaires terminent la génération.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-InstanceCloseDelayDuration

Spécifie la durée en secondes, à attendre avant qu’une instance sans état affectée par la mise à niveau de l’application soit fermée, pour permettre aux requêtes actives de 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. Ne spécifiez pas ce paramètre pour les services avec état.

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

-InstanceCount

Spécifie le nombre mis à jour d’instances pour le service sans état Service Fabric. Ne spécifiez pas ce paramètre pour les services avec état.

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

-InstanceLifecycleDescription

Description du cycle de vie des instances appartenant à ce service. Si une configuration de cette section n’est pas spécifiée, la valeur par défaut est extraite du paramètre de cluster du même nom (le cas échéant).

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

-InstanceRestartWaitDuration

Lorsqu’une instance sans état tombe en panne, ce minuteur démarre. Lorsqu’il expire, Service Fabric crée une instance sur n’importe quel nœud du cluster. Cette configuration consiste à réduire la création inutile d’une nouvelle instance dans les situations où l’instance est susceptible de se récupérer dans un court délai. Par exemple, lors d’une mise à niveau. La valeur par défaut est 0, ce qui indique que lorsque l’instance sans état tombe en panne, Service Fabric commence immédiatement à créer son remplacement.

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

-Metric

Spécifie le tableau de métriques mis à jour que le service signale. Pour en savoir plus sur les métriques, consultez Gestion de la consommation et de la charge des ressources dans Service Fabric avec des métriques.

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

-MinInstanceCount

Spécifie le nombre minimal mis à jour d’instances de la partition de service sans état. Pour plus d’informations, consultez MinInstanceCount (dans New-ServiceFabricService). Ne spécifiez pas ce paramètre pour les services avec état.

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

-MinInstancePercentage

Spécifie le pourcentage minimal mis à jour de InstanceCount d’une partition de service sans état. Pour plus d’informations, consultez MinInstancePercentage (dans New-ServiceFabricService). Ne spécifiez pas ce paramètre pour les services avec état.

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

-MinReplicaSetSize

Spécifie la taille minimale du jeu de réplicas mis à jour pour le service avec état Service Fabric. La valeur doit être inférieure à la TargetReplicaSetSize de ce service. Pour plus d’informations, consultez StatefulServiceDescription.MinReplicaSetSize.

Ne spécifiez pas ce paramètre pour les services sans état.

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

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

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

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

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

-PlacementConstraints

Spécifie la contrainte de placement mise à jour pour le service. Pour en savoir plus sur les contraintes de placement, consultez Contraintes de placement et propriétés de nœud.

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

-PlacementPolicy

Spécifie un tableau mis à jour des stratégies de placement pour un service. Pour en savoir plus sur PlacementPolicy, consultez stratégies de placement pour les services Service Fabric.

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

-QuorumLossWaitDuration

Spécifie la durée mise à jour, en tant qu’objet TimeSpan, que Service Fabric attend avant de déclarer la perte de données pour une partition de service.

Pour obtenir un objet TimeSpan, utilisez l’applet de commande New-TimeSpan. Pour plus d’informations, tapez Get-Help New-TimeSpan.

Pour en savoir plus sur le paramètre QuorumLossWaitDuration, consultez StatefulServiceDescription.QuorumLossWaitDuration.

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

-ReplicaLifecycleDescription

Description du cycle de vie des réplicas appartenant à ce service. Si une configuration de cette section n’est pas spécifiée, la valeur par défaut est extraite du paramètre de cluster du même nom (le cas échéant).

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

-ReplicaRestartWaitDuration

Spécifie l’intervalle mis à jour, en tant qu’objet TimeSpan, que Service Fabric attend que le réplica redémarre avant de créer un réplica de remplacement. Pour obtenir un objet TimeSpan, utilisez l’applet de commande New-TimeSpan.

Pour en savoir plus sur QuorumLossWaitDuration, consultez StatefulServiceDescription.ReplicaRestartWaitDuration.

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

-ScalingPolicies

{{Fill ScalePolicies Description}}

Type:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ServiceDnsName

Spécifie le nom DNS mis à jour d’un service.

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

-ServiceName

Spécifie l’URI d’un service Service Fabric dont les propriétés doivent être mises à jour.

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

-ServicePlacementTimeLimit

Définit la limite de temps de placement du service.

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

-StandByReplicaKeepDuration

Spécifie la durée de conservation du réplica autonome mise à jour en tant qu’objet TimeSpan.

Pour en savoir plus sur QuorumLossWaitDuration, consultez StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

Indique que le service est un service avec état Service Fabric.

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

-Stateless

Indique que le service est un service sans état Service Fabric.

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

-TagsRequiredToPlace

Déclare les étiquettes requises pour le placement d’un service. Utile pour influencer dynamiquement le placement du service. Pour plus d’informations, consultez balises de nœud dynamique Service Fabric.

Type:	System.Collections.Generic.List`1[System.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

-TagsRequiredToRun

Déclare les balises requises pour le placement et l’exécution d’un service. Utile pour influencer dynamiquement le placement et l’exécution du service. Pour plus d’informations, consultez balises de nœud dynamique Service Fabric

Type:	System.Collections.Generic.List`1[System.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

-TargetReplicaSetSize

Spécifie la taille du jeu de réplicas cible mis à jour pour un service avec état Service Fabric. Pour plus d’informations, consultez StatefulServiceDescription.TargetReplicaSetSize.

Ne spécifiez pas ce paramètre pour un service sans état.

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

-TimeoutSec

Spécifie le délai 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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

System.Uri

Sorties

System.Object

Liens associés

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService