Partager via

Move-ServiceFabricPrimaryReplica

  • Référence
Module:
ServiceFabric

Déplace le réplica principal Service Fabric d’une partition de service avec état.

Syntaxe

Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -PartitionId <Guid>
    -ServiceName <Uri>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-PartitionKindSingleton]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-PartitionKindNamed]
    -PartitionKey <String>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-PartitionKindUniformInt64]
    -PartitionKey <String>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

L’applet de commande Move-ServiceFabricPrimaryReplica déplace le réplica principal Service Fabric d’une partition de service avec état du nœud principal actuel vers un nœud spécifié. Vous pouvez également effectuer cette opération sur les services système. Vous ne pouvez pas utiliser cette applet de commande pour les services sans état.

La cmdlet Move-ServiceFabricPrimaryReplica déplace le réplica principal vers un nouvel emplacement de nœud Service Fabric une fois la commande acceptée. Toutefois, l’équilibreur de charge peut déplacer à nouveau le réplica principal en fonction des contraintes de l’équilibreur de charge ou de l’algorithme d’équilibrage de charge.

À compter de Service Fabric 7.1, Move-ServiceFabricPrimaryReplica prend en compte l’affinité alignée. Si le principal à déplacer fait partie d’une relation d’affinité alignée, tous les réplicas de cette relation seront déplacés ensemble. Si les réplicas principaux de ces services ne sont pas totalement en mesure de se déplacer dans le délai d’expiration spécifié, une exception est levée (FabricErrorCode.AsyncOperationNotComplete) indiquant que les services sont temporairement dans un état d’affinité alignée déchiré. Pour résoudre ce problème, réécriez l’opération.

Pour utiliser cette applet de commande, vous devez être membre du groupe Administrateurs.

Avant d’utiliser cette applet de commande, connectez-vous au cluster Service Fabric.

Exemples

Exemple 1 : Déplacer le réplica principal d’une partition de service avec état vers un nœud spécifié

PS C:\> Move-ServiceFabricPrimaryReplica -PartitionId 93838f53-f1d9-4b99-8492-b802ee807d03 -NodeName "N0050" -ServiceName fabric:/SampleApp/SampleService

Cette commande déplace le réplica principal de la partition de service avec état spécifiée vers le nœud nommé N0050.

Exemple 2 : Déplacer le réplica principal d’une partition de service avec état vers un nœud aléatoire

PS C:\> Move-ServiceFabricPrimaryReplica -ServiceName fabric:/SampleApp/SampleService -PartitionId 93838f53-f1d9-4b99-8492-b802ee807d03

Cette commande déplace le réplica principal de la partition de service avec état spécifiée vers un nœud aléatoire, car le paramètre NodeName n’est pas spécifié.

Exemple 3 : Déplacer le réplica principal d’une partition de service avec état vers un nœud aléatoire

PS C:\> Move-ServiceFabricPrimaryReplica -ServiceName fabric:/SampleApp1/PersistServ

Cette commande déplace le réplica principal de la partition de service avec état spécifiée vers un nœud aléatoire, car le paramètre NodeName n’est pas spécifié. Une partition aléatoire pour le service spécifié est sélectionnée.

Paramètres

-IgnoreConstraints

Indique si l’applet de commande ignore les contraintes.

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

-NodeName

Spécifie le nom d’un nœud Service Fabric. L’applet de commande déplace le réplica principal vers le nœud que vous spécifiez.

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

-PartitionId

Spécifie l’ID de la partition à déplacer.

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

-PartitionKey

Spécifie la clé de la partition à déplacer.

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

-PartitionKindNamed

Indique que cette applet de commande déplace une partition nommée.

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

-PartitionKindSingleton

Indique que cette applet de commande déplace une partition singleton.

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

-PartitionKindUniformInt64

Indique que cette applet de commande déplace un service partitionné UniformInt64.

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

-ServiceName

Spécifie le nom du service du réplica à déplacer.

Type:Uri
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

Entrées

System.String

System.Boolean

System.Guid

System.Uri

Sorties

System.Object