Invoke-​Service​Fabric​Infrastructure​Command

Invokes an administrative command on an infrastructure service.

Syntax

Invoke-ServiceFabricInfrastructureCommand
      [-Command] <String>
      [[-ServiceName] <Uri>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Description

The Invoke-ServiceFabricInfrastructureCommand cmdlet invokes an administrative command on an infrastructure service. The infrastructure service accepts infrastructure-specific commands to allow you to interact directly with the underlying infrastructure by using the Service Fabric API. To run this cmdlet, at least one instance of the infrastructure service must be enabled in the cluster configuration. Currently, this cmdlet is supported only on specially-configured Azure Cloud Services.

This cmdlet supports the Service Fabric platform. Do not run this cmdlet directly.

This cmdlet requires that you connect to the cluster with credentials that are granted administrator access to the cluster. Before you perform any operation on a Service Fabric cluster, establish a connection to the cluster by using the Connect-ServiceFabricCluster cmdlet.

Examples

1:

Required Parameters

-Command

Specifies the infrastructure-specific command string to send to the infrastructure service. The format of supported commands depends on the infrastructure on which the cluster runs.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-ServiceName

Specifies the Uniform Resource Identifier (URI) of a Service Fabric infrastructure service. This cmdlet sends the command to the service that this parameter specifies. The default value is fabric:/System/InfrastructureService.

Type:Uri
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-TimeoutSec

Specifies the time-out period, in seconds, for the operation.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

This cmdlet accepts object that contains a ServiceName property that identifies the infrastructure service instance to which to send a command.

Outputs

This cmdlet returns a value that depends on the value of the Command parameter, and is determined by the infrastructure.