Add-ServiceFabricNode
Adds a Service Fabric node to a cluster.
Syntax
Add-ServiceFabricNode
[-NodeName] <String>
-NodeType <String>
-IpAddressOrFQDN <String>
-UpgradeDomain <String>
-FaultDomain <String>
-FabricRuntimePackagePath <String>
[-NoCleanupOnFailure]
[-Force]
[-BypassUpgradeStateValidation]
[-FabricIsPreInstalled]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Please see Add or remove nodes to a standalone Service Fabric cluster for the recommended way of adding nodes to standalone clusters.
The Add-ServiceFabricNode adds a Service Fabric node to a cluster.
You must run this cmdlet on the machine that you want to add. Before you perform this operation, establish a connection to the cluster by using the Connect-ServiceFabricCluster cmdlet.
Examples
Example 1: Add a node to a cluster
PS C:\> Add-ServiceFabricNode -NodeName "N011" -NodeType "NodeType0" -IpAddressOrFQDN "10.10.100.100" -UpgradeDomain "ud5" -FaultDomain "fd:/dc5/r0" -FabricRuntimePackagePath "D:\deployanywhere\MicrosoftAzureServiceFabric.cab"This command adds the specified node to a cluster with the given NodeName, NodeType, IpAddressOrFQDN, UpgradeDomain, and FaultDomain. The NodeType parameter should already exist in the deployed JSON config. FabricRuntimePackagePath points to the current runtime package on which the cluster is deployed.
Parameters
-BypassUpgradeStateValidation
Used when node addition is blocked by upgrade state validation, such as after partially failed cluster setup or data loss in ClusterManager.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FabricIsPreInstalled
Bypasses Service Fabric runtime installation and clean runtime validation, such that only the node is configured.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FabricRuntimePackagePath
Specifies the path to the service fabric runtime package.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FaultDomain
Specifies the fault domain of the node.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Forces deletion of Service Fabric data root from previous installations, if any.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IpAddressOrFQDN
Specifies the IP address or fully qualified domain name (FQDN) of the node.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoCleanupOnFailure
Indicates that the system should retain Fabric data if the cluster cannot fully come up.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeName
Specifies the name of the node that this cmdlet adds.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeType
Specifies the node type name of the node that this cmdlet adds.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Specifies the time-out period, in seconds, for the operation.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeDomain
Specifies the upgrade domain for the node.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
System.Object