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

az pipelines build tag

参考

注释

此参考是 Azure CLI（版本 2.30.0 或更高版本）azure-devops 扩展的一部分。该扩展会在首次运行 az pipelines build tag 命令时自动安装。了解更多关于扩展的相关信息。

管理生成标记。

命令

名称	说明	类型	Status
az pipelines build tag add	为生成添加标记（s）。	扩展	GA
az pipelines build tag delete	删除生成标记。	扩展	GA
az pipelines build tag list	获取生成标记。	扩展	GA

az pipelines build tag add

为生成添加标记（s）。

az pipelines build tag add --build-id
                           --tags
                           [--detect {false, true}]
                           [--org --organization]
                           [--project]

必需参数

--build-id

生成的 ID。

--tags

要添加到生成的标记（s）。 [逗号分隔值]。

可选参数

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

全局参数

--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 build tag delete

删除生成标记。

az pipelines build tag delete --build-id
                              --tag
                              [--detect {false, true}]
                              [--org --organization]
                              [--project]

必需参数

--build-id

生成的 ID。

--tag

要从生成中删除的标记。

可选参数

--detect

自动检测组织。

接受的值: false, true

--org --organization

--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 pipelines build tag list --build-id
                            [--detect {false, true}]
                            [--org --organization]
                            [--project]

--build-id

生成的 ID。

--detect

自动检测组织。

接受的值: false, true

--org --organization

--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 获取完整的调试日志。