New-ServiceFabricNodeConfiguration
Configure un nœud pour joindre un cluster Service Fabric. Fonctionne pour les clusters de développement et les clusters Azure.
Syntaxe
New-ServiceFabricNodeConfiguration
[-ClusterManifestPath] <String>
[-InfrastructureManifestPath <String>]
[-FabricDataRoot <String>]
[-FabricLogRoot <String>]
[-FabricHostCredential <PSCredential>]
[-RunFabricHostServiceAsManual]
[-RemoveExistingConfiguration]
[-BootstrapMSIPath <String>]
[-UsingFabricPackage]
[-FabricPackageRoot <String>]
[-MachineName <String>]
[<CommonParameters>] Description
L’applet de commande New-ServiceFabricNodeConfiguration configure un nœud pour pouvoir être ajouté à un cluster Service Fabric. Cela implique l’installation de Service Fabric si nécessaire, puis l’utilisation des informations de configuration provenant du manifeste du cluster, puis crée les paramètres requis pour que le nœud rejoigne le cluster.
Le nœud rejoint le cluster dès que le service hôte Service Fabric est démarré sur l’ordinateur hôte.
Pour gérer les clusters Service Fabric, veillez à démarrer votre session Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.
Cette commande aura différentes utilisations des paramètres en fonction du type de cluster auquel cette opération est appliquée. Dans tous les cas, cette commande est utilisée pour ajouter un nœud à un cluster. Si vous utilisez un cluster autonome, reportez-vous à la commande AddNode.
Exemples
Exemple 1 : Configurer un cluster de développement à cinq nœuds
PS C:\> New-ServiceFabricNodeConfiguration -ClusterManifestPath "<samples>\\ConfigStore\Management\Deployment\ClusterManifest\Server\DevEnv-FiveNodes.xml"Cette commande configure un cluster de développement à l’aide du manifeste DevEnv-FiveNodes.xml à partir des exemples Service Fabric. Ce manifeste configure un cluster Service Fabric de cinq nœuds sur votre ordinateur de développement.
Paramètres
-BootstrapMSIPath
Spécifie le chemin d’accès du fichier .msi d’amorçage. Il s’agit du Kit de développement logiciel (SDK) Service Fabric téléchargé à partir du site web Service Fabric. Si vous utilisez ce paramètre, une mise à niveau auto-base de référence se produit automatiquement quand une mise à niveau est configurée ou que l’infrastructure est mise à niveau. Si -UsingFabricPackage est défini, cela doit pointer vers le fichier CAB Service Fabric plutôt que le fichier .msi. Le fichier CAB Service Fabric est disponible en téléchargement ici.
| 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 |
-ClusterManifestPath
Spécifie le chemin d’accès d’un manifeste de cluster Service Fabric, qui est un fichier XML. Les exemples de ce fichier sont visibles dans les exemples Service Fabric sous « PublishProfiles ». L’applet de commande crée une configuration de cluster basée sur le manifeste spécifié.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-FabricDataRoot
Spécifie le chemin d’accès où le runtime Service Fabric stocke les données internes nécessaires au fonctionnement d’un cluster.
| 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 |
-FabricHostCredential
Spécifie un objet PSCredential pour le service hôte Service Fabric.
Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential.
Pour plus d'informations, voir Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-FabricLogRoot
Spécifie le chemin d’accès pour les journaux de trace 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 |
-FabricPackageRoot
Ce paramètre est réservé à un usage futur.
| 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 |
-InfrastructureManifestPath
Spécifie le chemin d’accès du manifeste d’infrastructure. Ce manifeste est utilisé pour donner à chaque nœud une vue d’ensemble du cluster. Par exemple, la quantité totale de nœuds sur le cluster. Dans Azure, il s’agit du chemin d’accès aux fichiers .csdef et .cscfg.
| 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 |
-MachineName
Spécifie l’ordinateur qui hébergera la configuration. Vous pouvez utiliser le nom de l’ordinateur ou l’adresse IP de l’ordinateur. Par exemple :
-MachineName "192.168.1.1"
| 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 |
-RemoveExistingConfiguration
Indique que cette applet de commande supprime toutes les configurations existantes. Ces configurations se composent de données trouvées dans les dossiers signalés par FabricDataRoot et FabricLogRoot.
| 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 |
-RunFabricHostServiceAsManual
Indique que le service Hôte Fabric doit être démarré manuellement.
| 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 |
-UsingFabricPackage
Indique que les configurations de nœud doivent utiliser le package d’exécution xcopy/CAB. Vous pouvez le télécharger à partir du site web Service Fabric. Cela est utilisé lorsque MSI n’est pas installé et que nous utilisons un package client pour exécuter l’applet de commande. Le chemin d’accès au package xcopy/CAB doit être défini dans le paramètre -BootstrapMSIPath.
| 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 |
Entrées
None
Sorties
System.Object