次の方法で共有

az repos policy build

Note

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

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

コマンド

名前 説明 型 状態
az repos policy build create

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

 Extension GA
az repos policy build update

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

 Extension 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 --organization]
                             [--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

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

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch-match-type

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

プロパティ 値
規定値: exact
指定可能な値: exact, prefix
--detect

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

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

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: 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 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 repos policy build update

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

az repos policy build update --id --policy-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 --organization]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

必須のパラメーター

--id --policy-id

ポリシーの ID。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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 organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: 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 config を使って取得されていない場合は必須です。

--queue-on-source-update-only

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

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

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

--valid-duration

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

グローバル パラメーター
--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