Get-ServiceFabricNode

  • Référence
Module:
ServiceFabric

Obtient des informations pour tous les nœuds d’un cluster Service Fabric ou pour un nœud spécifique.

Syntaxe

Get-ServiceFabricNode
   [[-NodeName] <String>]
   [-StatusFilter <NodeStatusFilter>]
   [-ContinuationToken <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricNode
   [[-NodeName] <String>]
   [-StatusFilter <NodeStatusFilter>]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

L’applet de commande Get-ServiceFabricNode obtient des informations pour tous les nœuds d’un cluster Service Fabric autonome ou pour un nœud spécifique. Les informations de nœud retournées incluent le nom du nœud, l’état, le type et l’état d’intégrité (voir la section Sorties pour plus d’informations).

N’oubliez pas que, avant d’effectuer une opération sur un cluster Service Fabric, vous devez établir une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster .

Exemples

Exemple 1 : Obtenir des informations pour tous les nœuds du cluster

PS C:\> Get-ServiceFabricNode

Cette commande retourne des informations pour tous les nœuds du cluster Service Fabric.

Exemple 2 : Obtenir des informations pour un nœud spécifique

PS C:\> Get-ServiceFabricNode -NodeName Node1

Cette commande retourne des informations pour le nœud avec le nom Node1.

Paramètres

-ContinuationToken

Spécifie le jeton de continuation qui peut être utilisé pour récupérer la page suivante des résultats de requête.

Si trop de résultats respectent les filtres fournis, ils peuvent ne pas s’adapter à un message. La pagination est utilisée pour tenir compte de ce problème en fractionnant la collection de résultats retournés en pages distinctes. Le jeton de continuation est utilisé pour savoir où la page précédente s’est arrêtée, portant une importance uniquement à la requête elle-même. Cette valeur doit être générée à partir de l’exécution de cette requête et peut être transmise à la requête suivante afin d’obtenir les pages suivantes. Une valeur de jeton de continuation non null est retournée dans le cadre du résultat uniquement s’il existe une page ultérieure. Si cette valeur est fournie sans l’option -GetSinglePage, la requête retourne toutes les pages à partir de la valeur du jeton de continuation.

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

-GetSinglePage

Spécifie si la requête retourne une page de résultats de requête avec une valeur de jeton de continuation ou toutes les pages combinées dans une liste de résultats. Si cette option est sélectionnée, il incombe à l’appelant de la requête de vérifier les pages suivantes.

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

-MaxResults

Spécifie le nombre maximal d’éléments de résultat qui peuvent être retournés par page. Cela définit la limite supérieure du nombre de résultats retournés, pas au minimum. Par exemple, si la page correspond au maximum à 1 000 éléments retournés en fonction des restrictions de taille de message maximale définies dans la configuration et que la valeur MaxResults est définie sur 2000, seuls 1000 résultats sont retournés, même si 2000 éléments de résultat correspondent à la description de la requête. Cette valeur nécessite la sélection de l’indicateur GetSinglePage ; elle sera ignorée sinon.

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

-NodeName

Spécifie le nom du nœud Service Fabric dont les informations sont retournées. Si elle n’est pas spécifiée, l’applet de commande retourne des informations pour tous les nœuds du cluster.

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

-StatusFilter

Spécifie le filtre d’état du nœud en tant qu’objet System.Fabric.Query.NodeStatusFilter .

Seuls les nœuds avec état correspondant à ce filtre sont retournés dans les résultats.

Type:NodeStatusFilter
Valeurs acceptées:Default, Up, Down, Enabling, Disabling, Disabled, Unknown, Removed, All
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

Entrées

System.String

Sorties

System.Object