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 はタスクを終了し、0 以外の終了コードを返します。 タスクも失敗としてマークされます。

errorActionPreference: stop | continue | silentlyContinue

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

最後の終了コードを無視する

スクリプトから返された最後の終了コードは、既定でチェックされます。 0 以外のコードは、ステップの失敗を示します。この場合、システムはスクリプトを次のコードで追加します。

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 タスク の
• 条件の と タイムアウトの詳細