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

az pipelines runs

注意

此参考是 Azure CLI（版本 2.30.0 或更高版本）的 azure-devops 扩展的一部分。 该扩展将在首次运行 az pipelines run 命令时自动安装。 详细了解扩展。

管理管道运行。

命令

名称	说明	类型	状态
az pipelines runs artifact	管理管道运行工件。	扩展	GA
az pipelines runs artifact download	下载管道项目。	扩展	GA
az pipelines runs artifact list	列出与运行关联的项目。	扩展	GA
az pipelines runs artifact upload	上传管道项目。	扩展	GA
az pipelines runs list	列出项目中的管道运行。	扩展	GA
az pipelines runs show	显示管道运行的详细信息。	分机	GA
az pipelines runs tag	管理管道运行标记。	分机	GA
az pipelines runs tag add	为管道运行添加标记（s）。	分机	GA
az pipelines runs tag delete	删除管道运行标记。	分机	GA
az pipelines runs tag list	获取管道运行的标记。	分机	GA

az pipelines runs list

列出项目中的管道运行。

az pipelines runs list [--branch]
                       [--detect {false, true}]
                       [--org]
                       [--pipeline-ids]
                       [--project]
                       [--query-order {FinishTimeAsc, FinishTimeDesc, QueueTimeAsc, QueueTimeDesc, StartTimeAsc, StartTimeDesc}]
                       [--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

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

--detect

自动检测组织。

接受的值: false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--pipeline-ids

要列出其内部版本的定义的 ID（空格分隔）。 对于多个管道 ID：--pipeline-ids 1 2。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

--query-order

管道运行的顺序。

接受的值: FinishTimeAsc, FinishTimeDesc, QueueTimeAsc, QueueTimeDesc, StartTimeAsc, StartTimeDesc

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

输出格式。

接受的值: 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 pipelines runs show

显示管道运行的详细信息。

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

必需参数

--id

管道运行的 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true

--open

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

默认值: False

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

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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