az repos pr work-item

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). 该扩展会在首次运行 az repos pr work-item 命令时自动安装。 Learn more about extensions.

管理与拉取请求关联的工作项。

命令

名称	说明	类型	Status
az repos pr work-item add	将一个或多个工作项链接到拉取请求。	Extension	GA
az repos pr work-item list	列出拉取请求的链接工作项。	Extension	GA
az repos pr work-item remove	从拉取请求取消链接一个或多个工作项。	Extension	GA

az repos pr work-item add

将一个或多个工作项链接到拉取请求。

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org --organization]

必需参数

--id

拉取请求的 ID。

--work-items

要链接的工作项的 ID。 Space separated.

可选参数

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

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 pr work-item list

列出拉取请求的链接工作项。

az repos pr work-item list --id
                           [--detect {false, true}]
                           [--org --organization]

必需参数

--id

拉取请求的 ID。

可选参数

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

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 pr work-item remove

从拉取请求取消链接一个或多个工作项。

az repos pr work-item remove --id
                             --work-items
                             [--detect {false, true}]
                             [--org --organization]

必需参数

--id

拉取请求的 ID。

--work-items

要取消链接的工作项的 ID。 Space separated.

可选参数

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

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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