您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az boards work-item

管理工作项。

命令

az boards work-item create

创建工作项。

az boards work-item delete

删除工作项。

az boards work-item relation

管理工作项关系。

az boards work-item relation add

将 () 添加到工作项。

az boards work-item relation list-type

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

az boards work-item relation remove

从 (中删除) 关系。

az boards work-item relation show

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

az boards work-item show

显示工作项的详细信息。

az boards work-item update

更新工作项。

az boards work-item create

创建工作项。

az boards work-item create --title
                           --type
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--detect {false, true}]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--org]
                           [--project]
                           [--reason]
                           [--subscription]

必需参数

--title

工作项的标题。

--type

工作项类型的名称 (例如 Bug) 。

可选参数

--area

将工作项分配到 (例如,演示) 的区域。

--assigned-to

分配工作项的人员的姓名- (如 fabrikam) 。

--description -d

工作项的说明。

--detect

自动检测组织。

接受的值: false, true
--discussion

要添加到工作项中的讨论中的注释。

--fields -f

要设置的自定义字段的空格分隔 "字段 = 值" 对。 https://aka.ms/azure-devops-cli-field-api有关字段的详细信息,请参阅。

--iteration

工作项的迭代路径 (例如 DemosIteration 1) 。

--open

在默认 web 浏览器中打开工作项。

--org --organization

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

--project -p

项目的名称或 ID。 你可以使用 az devops configure = NAME_OR_ID 来配置默认项目。 如果未配置为默认值或通过 git 配置选取,则为必需。

--reason

工作项状态的原因。

--subscription

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

az boards work-item delete

删除工作项。

az boards work-item delete --id
                           [--destroy]
                           [--detect {false, true}]
                           [--org]
                           [--project]
                           [--subscription]
                           [--yes]

必需参数

--id

工作项的唯一 id。

可选参数

--destroy

永久删除此工作项。

--detect

自动检测组织。

接受的值: false, true
--org --organization

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

--project -p

项目的名称或 ID。 你可以使用 az devops configure = NAME_OR_ID 来配置默认项目。 如果未配置为默认值或通过 git 配置选取,则为必需。

--subscription

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

--yes -y

不提示确认。

az boards work-item show

显示工作项的详细信息。

az boards work-item show --id
                         [--as-of]
                         [--detect {false, true}]
                         [--expand {all, fields, links, none, relations}]
                         [--fields]
                         [--open]
                         [--org]
                         [--query-examples]
                         [--subscription]

必需参数

--id

工作项的 ID。

可选参数

--as-of

特定日期和时间的工作项详细信息。 提供日期或日期时间字符串。 假定为本地时区。 示例: "2019-01-20","2019-01-20 00:20:00"。 对于 UTC,将 "UTC" 追加到日期时间字符串 "2019-01-20 00:20:00 UTC"。

--detect

自动检测组织。

接受的值: false, true
--expand

工作项属性的展开参数。

接受的值: all, fields, links, none, relations
默认值: all
--fields -f

请求字段的逗号分隔列表。 例如: System.areapath。 https://aka.ms/azure-devops-cli-field-api有关字段的详细信息,请参阅。

--open

在默认 web 浏览器中打开工作项。

--org --organization

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

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--subscription

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

az boards work-item update

更新工作项。

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--detect {false, true}]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--org]
                           [--reason]
                           [--state]
                           [--subscription]
                           [--title]

必需参数

--id

要更新的工作项的 id。

可选参数

--area

将工作项分配到 (例如,演示) 的区域。

--assigned-to

分配工作项的人员的姓名- (如 fabrikam) 。

--description -d

工作项的说明。

--detect

自动检测组织。

接受的值: false, true
--discussion

要添加到工作项中的讨论中的注释。

--fields -f

要设置的自定义字段的空格分隔 "字段 = 值" 对。 https://aka.ms/azure-devops-cli-field-api有关字段的详细信息,请参阅。

--iteration

工作项的迭代路径 (例如 DemosIteration 1) 。

--open

在默认 web 浏览器中打开工作项。

--org --organization

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

--reason

工作项状态的原因。

--state

工作项 (状态,例如活动) 。

--subscription

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

--title

工作项的标题。