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 |