AzurePowerShell@3 - Azure PowerShell v3 任务
使用此任务在 Azure 环境中运行 PowerShell 脚本。 Azure 上下文使用提供的 Azure 资源管理器 服务连接进行身份验证。
语法
# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
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'. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments.
#errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
#FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure PowerShell version options
#azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.
# Advanced
#validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
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'. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments.
#errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
#FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure PowerShell version options
#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 连接类型
输入别名： ConnectedServiceNameSelector。 string. 允许的值： ConnectedServiceName (Azure 经典) 、 ConnectedServiceNameARM (Azure 资源管理器) 。 默认值：ConnectedServiceNameARM。
azureClassicSubscription - Azure 经典订阅
输入别名： ConnectedServiceName。 string. 当 ConnectedServiceNameSelector = ConnectedServiceName 时，需要此选项。
运行 PowerShell 之前要配置的 Azure 经典订阅。
azureSubscription - Azure 订阅
输入别名： ConnectedServiceNameARM。 string. 当 ConnectedServiceNameSelector = ConnectedServiceNameARM 时，需要此选项。
运行 PowerShell 之前要配置的 Azure 资源管理器订阅。
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. 可选。 在 时 ScriptType = FilePath使用 。
要传递给 PowerShell 的其他参数。 这些参数可以是序号参数，也可以是命名参数。
errorActionPreference - ErrorActionPreference
string. 允许的值：stop、continue、silentlyContinue。 默认值：stop。
选择用于执行脚本的 ErrorActionPreference 变量的值。
FailOnStandardError - 标准错误失败
boolean. 默认值：false。
如果为 true，则如果有任何错误写入错误管道或将任何数据写入标准错误流，则此任务将失败。
azurePowerShellVersion - Azure PowerShell版本
输入别名： TargetAzurePs。 string. 允许的值： LatestVersion (最新版本) ， OtherVersion (指定其他版本) 。 默认值：OtherVersion。
对于托管代理，支持的Azure PowerShell版本为 2.1.0、3.8.0、 4.2.15.1.1 和 6.7.0。
若要选择代理上可用的最新版本，请选择“ LatestVersion (最新安装的版本) 。
对于专用代理，可以使用 (指定其他版本) OtherVersion 指定首选版本的 Azure PowerShell。
preferredAzurePowerShellVersion - 首选Azure PowerShell版本
输入别名： CustomTargetAzurePs。 string. 当 TargetAzurePs = OtherVersion 时，需要此选项。
首选Azure PowerShell版本需要是适当的语义版本，例如 1.2.3.. 不支持等 2.\*,2.3.\* 正则表达式。 托管代理目前支持 Azure 模块版本 2.1.0、、、 4.2.15.1.1 和 AzureRM 模块版本 2.1.0、3.8.0、、4.2.15.1.1、 。 6.7.03.8.0
validateScriptSignature - 验证脚本签名
boolean. 可选。 在 时 ScriptType = FilePath使用 。 默认值：false。
如果为 true，则任务将首先检查，以确保指定的脚本在执行之前已签名且有效。
任务控制选项
除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。
输出变量
无。
备注
添加了对标准错误失败和 ErrorActionPreference 的支持。