steps.script の定義

script 手順では、Windows 上の cmd.exe と他のプラットフォームの Bash を使用してスクリプトを実行します。

steps:
- script: string # Required as first property. An inline script.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  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.

この定義を参照する定義: 手順

プロパティ

script 文字列。 最初のプロパティとして必要です。
インライン スクリプト。

failOnStderr 文字列。
出力が Stderr に送信された場合、タスクが失敗しますか?

workingDirectory 文字列。
この作業ディレクトリでスクリプトを開始します。 値を指定しなければ、このステップは $(Build.SourcesDirectory)から始まります。

condition 文字列。
この条件式を評価して、このタスクを実行するかどうかを決定します。

ブールを します。
障害が発生しても実行を続行しますか?

displayName 文字列。
タスクの人間が判読できる名前を します。

ターゲットを targetします。
このタスクを実行する環境です。

ブールを します。
ジョブの実行時にこのタスクを実行しますか?

文字列ディクショナリ env します。
変数を使用して、プロセスの環境にマップします。

name 文字列。
ステップの ID。 使用できる値: [-_A-Za-z0-9]*。

timeoutInMinutes 文字列。
このタスクが完了するまで待機してから、サーバーによって強制終了されるまでの時間を指定します。

注

パイプラインは、ジョブ レベルのタイムアウトで構成できます。 ステップが完了する前にジョブ レベルのタイムアウト間隔が経過すると、ステップが長い timeoutInMinutes 間隔で構成されている場合でも、実行中のジョブ (ステップを含む) が終了します。 詳細については、「タイムアウト」を参照してください。

retryCountOnTaskFailure 文字列。
タスクが失敗した場合の再試行回数。

注釈

script キーワードは、コマンド ライン タスクのショートカットです。 タスクは、Windows 上の cmd.exe と他のプラットフォームの Bash を使用してスクリプトを実行します。

workingDirectoryを設定しなければ、スクリプトは$(Build.SourcesDirectory)から実行されます。はジョブのチェックアウト済みリポジトリのルートです。 スクリプトが別のフォルダ、例えばビルドスクリプトやプロジェクトファイルを含むサブディレクトリで起動する必要がある時は、 workingDirectory 設定してください。

条件の、タイムアウト、およびステップ ターゲット 詳細について説明します。

例示

コマンド モードを指定しない場合は、target 構造を次のように短縮できます。

- script:
  target: string  # container name or the word 'host'
steps:
- script: echo Hello world!
  displayName: Say hello

以下の例は、 workingDirectory が指定されていない場合のデフォルトの作業ディレクトリを示しています:

steps:
- script: |
    echo "Default working directory:"
    pwd
  displayName: Show default working directory

こちらもご覧ください

  • コマンド ライン タスク を する