steps.pwsh 定義

  • 發行項

此步驟 pwsh 會在 Windows、macOS 和 Linux 上的 PowerShell Core 中執行腳本。

steps:
- pwsh: 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.

steps:
- pwsh: 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.

steps:
- pwsh: 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.
  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.

參考此定義的定義： 步驟

屬性

pwsh 字串。 做為第一個屬性的必要專案。
內嵌 PowerShell 腳本。

errorActionPreference 字串。
除非另有指定，否則錯誤動作喜好設定預設為停止值。 如需詳細資訊，請參閱下一節。

failOnStderr 字串。
如果輸出傳送至 Stderr，工作會失敗？

ignoreLASTEXITCODE 字串。
檢查文本的最終結束代碼，以判斷步驟是否成功？

workingDirectory 字串。
使用此工作目錄啟動文稿。

condition 字串。
評估此條件表達式，以判斷是否要執行這項工作。

continueOnError布爾值。
即使在失敗時仍繼續執行？

displayName 字串。
工作的人類可讀取名稱。

targettarget。
執行這項工作的環境。

enabled布爾值。
當作業執行時，請執行這項工作？

env 字串字典。
要對應至進程環境的變數。

name 字串。
步驟的標識碼。 可接受的值：[-_A-Za-z0-9]*。

timeoutInMinutes 字串。
等候此工作在伺服器終止之前完成的時間。

注意

管線可以設定為作業層級逾時。 如果作業層級逾時間隔在步驟完成之前經過，執行中的作業 (包括步驟) 終止，即使步驟設定了較長 timeoutInMinutes 的間隔也一樣。 如需詳細資訊，請參閱 逾時。

retryCountOnTaskFailure 字串。
如果工作失敗，重試次數。

備註

關鍵詞pwsh是當該工作的 pwsh 值設定為 true 時，PowerShell 工作的快捷方式。 工作會在 Windows、macOS 和 Linux 上的 PowerShell Core 中執行腳本。

深入了解 條件 和 逾時。

每個 PowerShell 會話只會在執行作業的持續時間內持續。 取決於啟動程式的工作必須位於與啟動程式相同的作業中。

範例

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

另請參閱