steps.powershell 定义

powershell 步骤使用 Windows PowerShell（在 Windows 上）或 pwsh（Linux 和 macOS）运行脚本。

steps:
- powershell: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

引用此定义的定义：步骤

性能

powershell 字符串。 必需为第一个属性。
内联 PowerShell 脚本。

errorActionPreference 字符串。
除非另有指定，否则错误作首选项默认为值停止。 有关详细信息，请参阅以下部分。

failOnStderr 字符串。
如果输出发送到 Stderr，任务失败？

ignoreLASTEXITCODE 字符串。
检查脚本的最终退出代码以确定步骤是否成功？

workingDirectory 字符串。
使用此工作目录启动脚本。

condition 字符串。
计算此条件表达式以确定是否运行此任务。

continueOnError 布尔。
即使在失败时继续运行？

displayName 字符串。
任务的人可读名称。

target 目标。
运行此任务的环境。

enabled 布尔。
作业运行时运行此任务？

env 字符串字典。
变量以映射到进程的环境。

name 字符串。
步骤的 ID。 可接受的值：[-_A-Za-z0-9]*。

timeoutInMinutes 字符串。
等待此任务在服务器终止之前完成的时间。

注释

管道可配置为作业级别超时。 如果作业级别超时间隔在步骤完成之前已过，则运行作业（包括步骤）将终止，即使该步骤配置了更长的 timeoutInMinutes 间隔。 有关详细信息，请参阅 超时。

retryCountOnTaskFailure 字符串。
如果任务失败， 重试次数。

注解

powershell 关键字是 PowerShell 任务的快捷方式。 该任务使用 Windows PowerShell（在 Windows 上）或 pwsh（Linux 和 macOS）运行脚本。

每个 PowerShell 会话仅在运行作业的持续时间内持续。 依赖于已启动的任务必须与启动作业位于同一个作业中。

详细了解 条件 和 超时。

错误作首选项

除非另有指定，否则错误作首选项默认为值 stop，并且将行 $ErrorActionPreference = 'stop' 追加到脚本顶部。

当错误作首选项设置为停止时，错误会导致 PowerShell 终止任务并返回非零退出代码。 该任务也标记为“失败”。

errorActionPreference: stop | continue | silentlyContinue

steps:
- powershell: |
    Write-Error 'Uh oh, an error occurred'
    Write-Host 'Trying again...'
  displayName: Error action preference
  errorActionPreference: continue

忽略最后一个退出代码

默认情况下会检查从脚本返回的最后一个退出代码。 非零代码指示步骤失败，在这种情况下，系统将脚本追加到：

if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE }

如果不希望此行为，请指定 ignoreLASTEXITCODE: true。

ignoreLASTEXITCODE: boolean

steps:
- powershell: git nosuchcommand
  displayName: Ignore last exit code
  ignoreLASTEXITCODE: true

详细了解 条件 和 超时。

例子

steps:
- powershell: Write-Host Hello $Env:name
  displayName: Say hello
  name: firstStep
  workingDirectory: $(build.sourcesDirectory)
  failOnStderr: true
  env:
    name: Microsoft

另请参阅

• PowerShell 任务
• 详细了解 条件 和 超时