ServiceFabricPowerShell@1 - Service Fabric PowerShell v1 task

Use this task to run a PowerShell script within the context of an Azure Service Fabric cluster connection. Runs any PowerShell command or script in a PowerShell session that has a Service Fabric cluster connection initialized.

Syntax

# Service Fabric PowerShell v1
# Run a PowerShell script in the context of an Azure Service Fabric cluster connection.
- task: ServiceFabricPowerShell@1
  inputs:
    clusterConnection: # string. Alias: serviceConnectionName. Required. Cluster Service Connection. 
    ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Required. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Script Arguments.
# Service Fabric PowerShell v1
# Run a PowerShell script within the context of an Azure Service Fabric cluster connection.
- task: ServiceFabricPowerShell@1
  inputs:
    clusterConnection: # string. Alias: serviceConnectionName. Required. Cluster Service Connection. 
    ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Required. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Script Arguments.

Inputs

clusterConnection - Cluster Service Connection
Input alias: serviceConnectionName. string. Required.

Specifies the Azure Service Fabric cluster which will have an established service connection when the specified PowerShell script is executed.


ScriptType - Script Type
string. Required. Allowed values: FilePath (Script File Path), InlineScript (Inline Script). Default value: FilePath.

Specifies whether the script is provided as a file or inline in the task.


ScriptPath - Script Path
string. Optional. Use when ScriptType = FilePath.

Specifies the path to the PowerShell script to run. Can include wildcards and variables. Example: $(system.defaultworkingdirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Note

Combining Compose files is not supported as part of this task.


Inline - Inline Script
string. Optional. Use when ScriptType = InlineScript. Default value: # You can write your PowerShell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Specifies the PowerShell commands to run on the build agent. Learn more about PowerShell tasks.


ScriptArguments - Script Arguments
string.

Specifies the additional parameters to pass to PowerShell. Can be either ordinal or named parameters.


Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

None.

Remarks

Use this task to run a PowerShell script within the context of an Azure Service Fabric cluster connection. Runs any PowerShell command or script in a PowerShell session that has a Service Fabric cluster connection initialized.

Service Fabric

  • This task uses a Service Fabric installation to connect and deploy to a Service Fabric cluster.
  • Azure Service Fabric Core SDK on the build agent.

Requirements

Requirement Description
Pipeline types YAML, Classic build, Classic release
Runs on Agent, DeploymentGroup
Demands Self-hosted agents must have capabilities that match the following demands to run jobs that use this task: Cmd
Capabilities This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions Any
Settable variables Any
Agent version 1.95.0 or greater
Task category Utility