CmdLine@2 - コマンド ライン v2 タスク
このタスクを使用して、Bash on Linux、macOS、および Windows 上の cmd.exe を使用してコマンド ライン スクリプトを実行します。
構文
# 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
.
実行するスクリプトの内容。
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
コマンドを使用する必要があります。それ以外の場合は、最初のバッチ ファイルが終了します。
その結果、Azure Pipelines により、指定したスクリプトは 1 つ目のバッチ ファイルの前まで実行され、そのバッチ ファイルが実行されてから、ステップは終了します。
1 つ目のスクリプトのその他の行は実行されません。
Azure Pipelines スクリプト ステップでバッチ ファイルを実行する前に、常に call
の先頭に追加する必要があります。
重要
バッチ ファイルを実行していることを認識できない場合があります。
たとえば、Windows 上の npm
と、npm install -g
を使用してインストールするツールは、実際にはバッチ ファイルです。
windows のコマンド ライン タスクで NPM コマンドを実行するには、常に call npm <command>
を使用します。
例示
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 |
の需要 | なし |
機能の | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
コマンドの制限 | どれでも |
設定可能な変数 | どれでも |
エージェントのバージョン | サポートされているすべてのエージェント バージョン。 |
タスク カテゴリ | 効用 |
こちらもご覧ください
- 詳細ログ を使用して、のトラブルシューティングする方法について説明します。