你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az repos policy build

注意

此参考是 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 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--path-filter

对其应用策略的筛选路径。。 支持由“;”分隔的绝对路径、wild卡和多个路径。 示例：/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 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--path-filter

对其应用策略的筛选路径。。 支持由“;”分隔的绝对路径、wild卡和多个路径。 示例：/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 获取完整的调试日志。