Test-ServiceFabricConfiguration
Validates cluster configuration and tests whether standalone deployment can succeed.
Syntax
Default (Default)
Test-ServiceFabricConfiguration
[-ClusterConfigurationFilePath] <String>
[-OldClusterConfigurationFilePath <String>]
[-FabricRuntimePackagePath <String>]
[-FabricIsPreInstalled]
[-MaxPercentFailedNodes <Int32>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
The Test-ServiceFabricConfiguration cmdlet validates the cluster configuration and tests whether standalone deployment can succeed for the target computers in the configuration from the controller.
Specify the configuration file in JavaScript Object Notation (JSON) format.
Examples
Example 1: Validate deployment
PS C:\> Test-ServiceFabricConfiguration -ClusterConfigurationFilePath "D:\standalone\ClusterConfig.Unsecure.DevCluster.json"
This command validates that the cluster deploys from the current computer by using the specified configuration.
Example 2: Validate deployment and runtime CAB file
PS C:\> Test-ServiceFabricConfiguration -ClusterConfigurationFilePath "D:\standalone\ClusterConfig.Unsecure.DevCluster.json" -FabricRuntimePackagePath "D:\deployanywhere\MicrosoftAzureServiceFabric.cab"
This command validates that the cluster deploys from the current computer by using this configuration. The command also validates whether the runtime CAB can be used to deploy the cluster.
Parameters
-ClusterConfigurationFilePath
Specifies the path of the JSON cluster configuration file.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-FabricIsPreInstalled
Bypasses Service Fabric runtime installation and clean runtime validation, such that only the node is configured.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-FabricRuntimePackagePath
Specifies the path of the Service Fabric runtime package CAB file.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MaxPercentFailedNodes
{{Fill MaxPercentFailedNodes Description}}
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-OldClusterConfigurationFilePath
{{Fill OldClusterConfigurationFilePath Description}}
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TimeoutSec
Specifies the time-out period, in seconds, for the operation.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.