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" -NoCleanupOnFailure

This 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