次の方法で共有

az pipelines build

Note

このリファレンスは、Azure CLI (バージョン 2.30.0 以降) の azure-devops 拡張機能の一部です。 az pipelines build コマンドを初めて実行すると、拡張機能が自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

ビルドを管理します。

コマンド

名前 説明 型 状態
az pipelines build cancel

ビルドが実行されている場合はキャンセルします。

 Extension GA
az pipelines build definition

ビルド定義を管理します。

 Extension GA
az pipelines build definition list

ビルド定義を一覧表示します。

 Extension GA
az pipelines build definition show

ビルド定義の詳細を取得します。

 Extension GA
az pipelines build list

ビルド結果を一覧表示します。

 Extension GA
az pipelines build queue

ビルドを要求 (キュー) します。

 Extension GA
az pipelines build show

ビルドの詳細を取得します。

 Extension GA
az pipelines build tag

ビルド タグを管理します。

 Extension GA
az pipelines build tag add

ビルドのタグを追加します。

 Extension GA
az pipelines build tag delete

ビルド タグを削除します。

 Extension GA
az pipelines build tag list

ビルドのタグを取得します。

 Extension GA

az pipelines build cancel

ビルドが実行されている場合はキャンセルします。

az pipelines build cancel --build-id
                          [--detect {false, true}]
                          [--open]
                          [--org --organization]
                          [--project]

必須のパラメーター

--build-id

ビルドの ID。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--open

Web ブラウザーでビルド結果ページを開きます。

プロパティ 値
規定値: False
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--project -p

プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az pipelines build list

ビルド結果を一覧表示します。

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org --organization]
                        [--project]
                        [--reason {all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset}]
                        [--requested-for]
                        [--result {canceled, failed, none, partiallySucceeded, succeeded}]
                        [--status {all, cancelling, completed, inProgress, none, notStarted, postponed}]
                        [--tags]
                        [--top]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--branch

このブランチのビルドでフィルター処理します。

--definition-ids

ビルドを一覧表示する定義の ID (スペース区切り)。

--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--project -p

プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。

--reason

この理由でビルドに制限します。

プロパティ 値
指定可能な値: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset
--requested-for

このユーザーまたはグループに対して要求されたビルドに制限します。

--result

この結果を使用してビルドに制限します。

プロパティ 値
指定可能な値: canceled, failed, none, partiallySucceeded, succeeded
--status

この状態のビルドに制限します。

プロパティ 値
指定可能な値: all, cancelling, completed, inProgress, none, notStarted, postponed
--tags

指定された各タグを持つビルドに制限します。 スペースを区切ります。

--top

一覧表示するビルドの最大数。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az pipelines build queue

ビルドを要求 (キュー) します。

az pipelines build queue [--branch]
                         [--commit-id]
                         [--definition-id]
                         [--definition-name]
                         [--detect {false, true}]
                         [--open]
                         [--org --organization]
                         [--project]
                         [--queue-id]
                         [--variables]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--branch

ビルドするブランチ。 定義に既定のブランチが設定されていない場合は必須です。 例: refs/heads/master、master、refs/pull/1/merge、refs/tags/tag。

--commit-id

ビルドするブランチのコミット ID。

--definition-id

キューに登録する定義の ID。 --name が指定されていない場合は必須です。

--definition-name

キューに格納する定義の名前。 --id が指定されている場合は無視されます。

--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--open

Web ブラウザーでビルド結果ページを開きます。

プロパティ 値
規定値: False
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--project -p

プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。

--queue-id

ビルドのキューに使用されるプールのキュー ID。

--variables

設定する変数のスペース区切りの "name=value" ペア。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az pipelines build show

ビルドの詳細を取得します。

az pipelines build show --id
                        [--detect {false, true}]
                        [--open]
                        [--org --organization]
                        [--project]

必須のパラメーター

--id

ビルドの ID。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--detect

組織を自動的に検出します。

プロパティ 値
指定可能な値: false, true
--open

Web ブラウザーでビルド結果ページを開きます。

プロパティ 値
規定値: False
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--project -p

プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False