AzurePowerShell@2 - Azure PowerShell v2 任务

使用此任务在 Azure 环境中运行 PowerShell 脚本。 Azure 上下文使用提供的 Azure 资源管理器服务连接进行身份验证。

语法

# Azure PowerShell v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    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. 
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.

输入

azureConnectionType - Azure 连接类型
输入别名: ConnectedServiceNameSelectorstring. 允许的值: ConnectedServiceName (Azure 经典) , ConnectedServiceNameARM (Azure 资源管理器) 。 默认值:ConnectedServiceNameARM


azureClassicSubscription - Azure 经典订阅
输入别名: ConnectedServiceNamestring. 当 ConnectedServiceNameSelector = ConnectedServiceName 时,需要此选项。

运行 PowerShell 之前要配置的 Azure 经典订阅。


azureSubscription - Azure 订阅
输入别名: ConnectedServiceNameARMstring. 当 ConnectedServiceNameSelector = ConnectedServiceNameARM 时,需要此选项。

Azure 资源管理器运行 PowerShell 之前要配置的订阅。


ScriptType - 脚本类型
string. 必需。 允许的值: FilePath (脚本文件路径) , InlineScript (内联脚本) 。 默认值:FilePath

脚本的类型:文件路径或内联。


ScriptPath - 脚本路径
string. 可选。 在 时 ScriptType = FilePath使用 。

脚本的路径。 这应该是一个完全限定的路径或相对于默认工作目录的路径。


Inline - 内联脚本
string. 可选。 在 时 ScriptType = InlineScript使用 。 默认值:# You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments

指定要执行的脚本。 支持的最大内联脚本长度为 5000 个字符。 如果要使用较长的脚本,请使用文件中的脚本。


ScriptArguments - 脚本参数
string.

要传递给 PowerShell 的其他参数。 这些参数可以是序号参数,也可以是命名参数。


azurePowerShellVersion - Azure PowerShell 版本
输入别名: TargetAzurePsstring. 允许的值: LatestVersion (最新版本) , OtherVersion (指定其他版本) 。 默认值:OtherVersion

对于托管代理,支持的Azure PowerShell版本为 2.1.03.8.04.2.15.1.16.7.0。 若要选择代理上可用的最新版本,请选择 LatestVersion “ (最新安装版本) ”。

对于专用代理,可以使用 (指定其他版本) OtherVersion 指定首选版本的 Azure PowerShell。


preferredAzurePowerShellVersion - 首选Azure PowerShell版本
输入别名: CustomTargetAzurePsstring. 当 TargetAzurePs = OtherVersion 时,需要此选项。

首选Azure PowerShell版本需要是适当的语义版本,例如。 1.2.3.. 不支持等 2.\*,2.3.\* 正则表达式。 托管代理当前支持 Azure 模块版本 2.1.03.8.04.2.15.1.1 和 AzureRM 模块版本 2.1.03.8.0、、4.2.15.1.16.7.0


任务控制选项

除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

要求

要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求 自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业:azureps
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 1.95.0 或更高版本
任务类别 部署