Update-ServiceFabricService

Module:

ServiceFabric

Mises à jour un service Service Fabric.

Syntax

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

L’applet de commande Update-ServiceFabricService met à jour les propriétés d’un service Service Fabric en cours d’exécution. L’ensemble de propriétés qui peuvent être mises à jour est un sous-ensemble des propriétés spécifiées au moment de la création du service (à l’aide New-ServiceFabricService ou 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 de déplacer votre application d’une version vers une autre, d’un domaine de mise à niveau à la fois. Pour plus d’informations, consultez La 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 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 du 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 demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 valides pour ce paramètre sont :

• Zéro
• Faible
• Moyenne
• Élevé

Pour plus d’informations sur le coût de déplacement, consultez le coût du déplacement des services pour influencer les choix de Resource Manager de cluster.

Type:	String
Accepted values:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DropSourceReplicaOnMove

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

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

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 demandes actives de s’écouler 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceLifecycleDescription

Description du cycle de vie des instances appartenant à ce service. Si aucune configuration de cette section n’est 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 tombe en panne est susceptible de récupérer dans un court laps de temps. 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinInstanceCount

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

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

-MinInstancePercentage

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

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

-MinReplicaSetSize

Spécifie la taille de jeu de réplicas minimale mise à jour pour le service avec état Service Fabric. La valeur doit être inférieure à 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

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

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementPolicy

Spécifie un tableau mis à jour de 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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, voir Get-Help New-TimeSpan.

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

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

-ReplicaLifecycleDescription

Description du cycle de vie des réplicas appartenant à ce service. Si aucune configuration de cette section n’est 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceDnsName

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

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

-ServiceName

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

Type:	Uri
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServicePlacementTimeLimit

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

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

-StandByReplicaKeepDuration

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

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

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

-Stateful

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

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

-Stateless

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

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

-TagsRequiredToPlace

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

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagsRequiredToRun

Déclare les balises requises au placement et au fonctionnement d’un service. Utile pour influencer dynamiquement le placement et le fonctionnement des services. Pour plus d’informations, consultez Balises de nœud dynamique Service Fabric

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetReplicaSetSize

Spécifie la taille de jeu de réplicas cible mise à 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Spécifie la période d’expiration, en secondes, pour l’opération.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

System.Uri

Sorties

System.Object

Liens associés

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