Share via

Start-ServiceFabricPartitionQuorumLoss

Module:
ServiceFabric Module

Initiates a fault to put a partition into quorum loss. The various ways to specify or to choose the partition to invoke quorum loss on are below.

Syntax

PartitionId 

Start-ServiceFabricPartitionQuorumLoss
    -OperationId <Guid>
    -QuorumLossMode <QuorumLossMode>
    -QuorumLossDurationInSeconds <Int32>
    -PartitionId <Guid>
    -ServiceName <Uri>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

ServiceNameRandomPartition 

Start-ServiceFabricPartitionQuorumLoss
    -OperationId <Guid>
    -QuorumLossMode <QuorumLossMode>
    -QuorumLossDurationInSeconds <Int32>
    -ServiceName <Uri>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

ServiceNamePartitionSingleton 

Start-ServiceFabricPartitionQuorumLoss
    -OperationId <Guid>
    -QuorumLossMode <QuorumLossMode>
    -QuorumLossDurationInSeconds <Int32>
    -ServiceName <Uri>
    [-PartitionKindSingleton]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

ServiceNamePartitionNamed 

Start-ServiceFabricPartitionQuorumLoss
    -OperationId <Guid>
    -QuorumLossMode <QuorumLossMode>
    -QuorumLossDurationInSeconds <Int32>
    -ServiceName <Uri>
    -PartitionKey <String>
    [-PartitionKindNamed]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

ServiceNamePartitionUniformedInt 

Start-ServiceFabricPartitionQuorumLoss
    -OperationId <Guid>
    -QuorumLossMode <QuorumLossMode>
    -QuorumLossDurationInSeconds <Int32>
    -ServiceName <Uri>
    -PartitionKey <String>
    [-PartitionKindUniformInt64]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

The Start-ServiceFabricPartitionQuorumLoss cmdlet initiates a fault to put a stateful service partition into quorum loss in Azure Service Fabric.

To run this cmdlet, FaultAnalysisService must be enabled.

Warning

Do not use this cmdlet to perform a quorum loss fault operation on system services. Run this cmdlet to perform a quorum loss fault operation only for partitions for stateful services.

You can check the progress of the fault operation by using the Get-ServiceFabricPartitionQuorumLossProgress cmdlet.

Examples

Example 1: Start a quorum loss fault operation for a service by partition ID

PS C:\> Start-ServiceFabricPartitionQuorumLoss -OperationId aeaceca9-320d-4f7b-84e8-3cc13c29a974 -QuorumLossMode QuorumReplicas -QuorumLossDurationInSeconds 10 -PartitionId 20a726d0-3112-4c5a-a22c-2e4b8ee85280 -ServiceName "fabric:/ContosoApp/ContosoService"

This command starts a partition quorum loss fault operation on the service named fabric:/ContosoApp/ContosoService in the partition that has the ID 20a726d0-3112-4c5a-a22c-2e4b8ee85280. The QuorumLossMode parameter has a value of QuorumReplicas, which means that this cmdlet faults a quorum of replicas. Specify a unique GUID for the OperationId parameter. You can use this ID to check the progress of the quorum loss fault operation.

Parameters

-OperationId

Specifies a unique identifier for this operation. Specify a unique value. You can check the progress of the operation by passing this ID into Get-ServiceFabricPartitionQuorumLossProgress.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PartitionId

Specifies the ID of the Service Fabric partition that this cmdlet puts into quorum loss.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

PartitionId
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PartitionKey

Specifies the key of the Service Fabric partition that this cmdlet puts into quorum loss.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ServiceNamePartitionNamed
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
ServiceNamePartitionUniformedInt
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PartitionKindNamed

Indicates that the Service Fabric partition that this cmdlet puts into quorum loss is a Named partition.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ServiceNamePartitionNamed
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PartitionKindSingleton

Indicates that the Service Fabric partition that this cmdlet puts into quorum loss is a singleton partition.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ServiceNamePartitionSingleton
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PartitionKindUniformInt64

Indicates that the Service Fabric partition that this cmdlet puts into quorum loss is a UniformInt64 partition.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ServiceNamePartitionUniformedInt
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-QuorumLossDurationInSeconds

Specifies the duration, in seconds, of the quorum loss.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-QuorumLossMode

Specifies the mode of quorum loss that this cmdlet performs. The acceptable values for this parameter are:

  • FullQuorumLoss. Down all replicas for the target partition.
  • PartialQuorumLoss. Down a quorum of replicas for the target partition.

Parameter properties

Type:QuorumLossMode
Default value:None
Accepted values:Invalid, QuorumReplicas, AllReplicas
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ServiceName

Specifies the Uniform Resource Identifier (URI) of a Service Fabric service.

Parameter properties

Type:Uri
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
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.

Inputs

System.Guid

System.Uri

System.String

Outputs

System.Object