New-ServiceFabricCluster
Creates a new standalone Service Fabric cluster.
Syntax
New-ServiceFabricCluster
[-ClusterConfigurationFilePath] <String>
-FabricRuntimePackagePath <String>
[-NoCleanupOnFailure]
[-Force]
[-FabricIsPreInstalled]
[-MaxPercentFailedNodes <Int32>]
[-TimeoutInSeconds <UInt32>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
The New-ServiceFabricCluster cmdlet creates a new standalone Service Fabric cluster based on a configuration file in JavaScript Object Notation (JSON) format and a Service Fabric runtime package CAB file.
The cmdlet orchestrates installations from the controller computer.
Examples
Example 1: Create a cluster
PS C:\>New-ServiceFabricCluster -ClusterConfigurationFilePath "D:\standalone\ClusterConfig.Unsecure.DevCluster.json" -FabricRuntimePackagePath "D:\deployanywhere\MicrosoftAzureServiceFabric.cab"This command creates a cluster based on the input cluster configuration path and runtime CAB package.
Example 2: Create a cluster without clean up if failures are encountered
PS C:\>New-ServiceFabricCluster -ClusterConfigurationFilePath "D:\standalone\ClusterConfig.Unsecure.DevCluster.json" -FabricRuntimePackagePath "D:\deployanywhere\MicrosoftAzureServiceFabric.cab" -NoCleanupOnFailureThis command creates a cluster based on the input cluster configuration path and runtime CAB package, and for deployment failure, Fabric resources are not cleaned up on the target computers.
Parameters
-ClusterConfigurationFilePath
Specifies the path of the cluster configuration JSON file.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 of the Service Fabric package CAB file.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
{{Fill Force Description}}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentFailedNodes
Maximum percentage of nodes allowed to fail during cluster creation. If more than this percentage of nodes fail, the cluster creation will fail and roll back. If not specified, any node failures will fail cluster creation.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-TimeoutInSeconds
{{Fill TimeoutInSeconds Description}}
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
Inputs
None
Outputs
System.Object