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

az pipelines build

管理生成。

命令

az pipelines build definition	管理生成定义。
az pipelines build definition list	列出生成定义。
az pipelines build definition show	获取生成定义的详细信息。
az pipelines build list	列出生成结果。
az pipelines build queue	) 生成请求 (队列。
az pipelines build show	获取生成的详细信息。
az pipelines build tag	管理生成标记。
az pipelines build tag add	为生成添加标记 () 。
az pipelines build tag delete	删除生成标记。
az pipelines build tag list	获取生成标记。

az pipelines build list

列出生成结果。

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org]
                        [--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]

可选参数

--branch

按此分支的生成进行筛选。

--definition-ids

ID (分隔) 定义的空间来列出其生成。

--detect

自动检测组织。

接受的值: false, true

--org --organization

Azure DevOps 组织 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 配置进行选取，则为必需。

--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

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az pipelines build queue

) 生成请求 (队列。

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

可选参数

--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 浏览器中打开生成结果页。

--org --organization

Azure DevOps 组织 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 配置进行选取，则为必需。

--queue-id

用于对生成进行排队的池的队列 ID。

--variables

要设置的变量的空间分隔“name=value”对。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az pipelines build show

获取生成的详细信息。

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

必需参数

--id

生成 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true

--open

在 Web 浏览器中打开生成结果页。

--org --organization

Azure DevOps 组织 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 配置进行选取，则为必需。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。