az repos policy build

  • リファレンス

Note

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

ビルド ポリシーを管理します。

コマンド

名前 説明 型 Status
az repos policy build create

ビルド ポリシーを作成します。

 拡張 GA
az repos policy build update

ビルド ポリシーを更新します。

 拡張 GA

az repos policy build create

ビルド ポリシーを作成します。

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]

必須のパラメーター

--blocking

ポリシーをブロックする必要があるかどうか。

承認された値: false, true
--branch

このポリシーを適用するブランチ。 例: master。

--build-definition-id

ビルド定義 ID。

--display-name

ポリシーを識別するための、このビルド ポリシーの表示名。 たとえば、"手動キュー ポリシー" です。

--enabled

ポリシーが有効かどうか。

承認された値: false, true
--manual-queue-only

ビルドの手動キューのみを許可するかどうか。

承認された値: false, true
--queue-on-source-update-only

ソースの更新時にのみキューに入れます。

承認された値: false, true
--repository-id

ポリシーを適用するリポジトリの ID。

--valid-duration

ポリシーの有効期間 (分単位)。

省略可能のパラメーター

--branch-match-type

分岐引数を使用してポリシーを適用する方法を決定します。 値が "exact" の場合、--branch 引数と完全に一致するブランチにポリシーが適用されます。 値が 'prefix' の場合、--branch 引数によって提供されるプレフィックスと一致するすべてのブランチ フォルダーにポリシーが適用されます。

承認された値: exact, prefix
既定値: exact
--detect

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

承認された値: false, true
--org --organization

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

--path-filter

ポリシーが適用されるパスをフィルター処理します。 絶対パス、野生カード、および複数のパスを ';' で区切ってサポートします。 例: /WebApp/Models/Data.cs、/WebApp/* または *.cs,/WebApp/Models/Data.cs;ClientApp/Models/Data.cs。

--project -p

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az repos policy build update

ビルド ポリシーを更新します。

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

必須のパラメーター

--id --policy-id

ポリシーの ID。

省略可能のパラメーター

--blocking

ポリシーをブロックする必要があるかどうか。

承認された値: false, true
--branch

このポリシーを適用するブランチ。 例: master。

--branch-match-type

分岐引数を使用してポリシーを適用する方法を決定します。 値が "exact" の場合、--branch 引数と完全に一致するブランチにポリシーが適用されます。 値が 'prefix' の場合、--branch 引数によって提供されるプレフィックスと一致するすべてのブランチ フォルダーにポリシーが適用されます。

承認された値: exact, prefix
--build-definition-id

ビルド定義 ID。

--detect

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

承認された値: false, true
--display-name

ポリシーを識別するための、このビルド ポリシーの表示名。 たとえば、"手動キュー ポリシー" です。

--enabled

ポリシーが有効かどうか。

承認された値: false, true
--manual-queue-only

ビルドの手動キューのみを許可するかどうか。

承認された値: false, true
--org --organization

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

--path-filter

ポリシーが適用されるパスをフィルター処理します。 絶対パス、野生カード、および複数のパスを ';' で区切ってサポートします。 例: /WebApp/Models/Data.cs、/WebApp/* または *.cs,/WebApp/Models/Data.cs;ClientApp/Models/Data.cs。

--project -p

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

--queue-on-source-update-only

ソースの更新時にのみキューに入れます。

承認された値: false, true
--repository-id

ポリシーを適用するリポジトリの ID。

--valid-duration

ポリシーの有効期間 (分単位)。

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。