ServiceFabricPowerShell@1 - Service Fabric PowerShell v1 task

Artikkel
07/02/2024

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

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

Del via