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

az boards work-item relation

Note

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

管理工作项关系。

命令

名称	说明	类型	Status
az boards work-item relation add	将 relation（s）添加到工作项。	Extension	GA
az boards work-item relation list-type	列出组织中支持的工作项关系。	Extension	GA
az boards work-item relation remove	从工作项中删除关系。	Extension	GA
az boards work-item relation show	获取工作项，用友好名称填充关系。	Extension	GA

az boards work-item relation add

将 relation（s）添加到工作项。

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org --organization]
                                 [--target-id]
                                 [--target-url]

必需参数

--id

工作项的 ID。

--relation-type

要创建的关系类型。示例：父级、子级。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

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

--target-id

要与之创建关系的工作项的 ID（s）。可以用逗号分隔传递多个值。示例：1,2。

--target-url

要与之创建关系的工作项的 URL（s）。可以用逗号分隔传递多个值。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

列出组织中支持的工作项关系。

az boards work-item relation list-type [--detect {false, true}]
                                       [--org --organization]

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

从工作项中删除关系。

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org --organization]
                                    [--yes]

必需参数

--id

工作项的 ID。

--relation-type

要移除的关系类型。示例：父级、子级。

--target-id

要从中删除关系的工作项的 ID（s）。可以用逗号分隔传递多个值。示例：1,2。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

--yes -y

不要提示确认。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	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 boards work-item relation show

获取工作项，用友好名称填充关系。

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org --organization]

必需参数

--id

工作项的 ID。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

反馈

此页面是否有帮助？