New-ServiceFabricNodeConfiguration
Configure un nœud pour joindre un cluster Service Fabric. Fonctionne pour les clusters de développement et les clusters Azure.
Syntax
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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FabricLogRoot
Spécifie le chemin d’accès pour les journaux de trace Service Fabric.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FabricPackageRoot
Ce paramètre est réservé à un usage futur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFabricHostServiceAsManual
Indique que le service Hôte Fabric doit être démarré manuellement.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
None
Sorties
System.Object