CmdLine@2 - コマンド ライン v2 タスク

  • [アーティクル]

このタスクを使用して、Windows 上の Linux、macOS、cmd.exe の Bash を使用してコマンド ライン スクリプトを実行します。

構文

# Command Line v2
# Run a command line script using Bash on Linux and macOS and cmd.exe on Windows.
- task: CmdLine@2
  inputs:
    script: # string. Required. Script. 
  # Advanced
    #workingDirectory: # string. Working Directory. 
    #failOnStderr: false # boolean. Fail on Standard Error. Default: false.

入力

script - スクリプト
string. 必須です。 既定値: echo Write your commands here\n\necho Hello world。

実行するスクリプトの内容。


script - スクリプト
string. 必須です。 既定値: echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script。

実行するスクリプトの内容。


workingDirectory - 作業ディレクトリ
string.

コマンドを実行する作業ディレクトリを指定します。 空のままにすると、作業ディレクトリは $(Build.SourcesDirectory) になります。


failOnStderr - 標準エラーで失敗する
boolean. 既定値: false。

値を true に設定した場合、標準エラー ストリームに何らかのエラーが書き込まれるとタスクは失敗します。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

コマンド ラインには、YAML のショートカットがあります: steps.script。

- script: # inline script
  workingDirectory: #
  displayName: #
  failOnStderr: #
  env: { string: string } # mapping of environment variables to add

バッチ ファイルと .CMD ファイルの実行

インライン スクリプトの内容は、実行するために Azure Pipelines によって一時的なバッチ ファイル (.cmd) に格納されます。 Windows CMD で、あるバッチ ファイルを別のバッチ ファイルから実行する場合、call コマンドを使う必要があります。そうしないと、1 つ目のバッチ ファイルは終了されます。 その結果、Azure Pipelines により、指定したスクリプトは 1 つ目のバッチ ファイルの前まで実行され、そのバッチ ファイルが実行されてから、ステップは終了します。 1 つ目のスクリプトのその他の行は実行されません。 必ず Azure Pipelines スクリプト ステップでバッチ ファイルを実行する前に call を配置する必要があります。

重要

バッチ ファイルを実行していることに気付かない場合があります。 たとえば、Windows の npm は、npm install -g を使用してインストールするすべてのツールと共に、実際にはバッチ ファイルです。 Windows のコマンド ライン タスクでは常に call npm <command> を使用して NPM コマンドを実行します。

例

steps:
- script: date /t
  displayName: Get the date
- script: dir
  workingDirectory: $(Agent.BuildDirectory)
  displayName: List contents of a folder
- script: |
    set MYVAR=foo
    set
  displayName: Set a variable and then display all
  env:
    aVarFromYaml: someValue

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
上で実行 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン サポートされているすべてのエージェント バージョン。
タスクのカテゴリ ユーティリティ

こちらもご覧ください