如何在Azure Bash中创建项目子迭代及更新子迭代日期

前置准备 #

操作前请先确保已在Azure Bash完成Azure DevOps账号登录，命令中--project参数替换为你的实际项目名（本文示例项目为Project A）。

步骤1：获取父迭代完整路径 #

创建子迭代前需要先确认父迭代的完整路径，路径格式为\项目名\Iteration\父迭代层级，比如示例结构中Son Sprint的路径为\Project A\Iteration\Father Sprint\Son Sprint。
如果不清楚父迭代路径，可执行以下命令查询项目下所有迭代的完整结构：

az boards iteration project list --project "Project A" --depth 10

返回结果中可直接复制目标父迭代的path字段值使用。

提示：Linux环境下Azure Bash识别路径报错时，可将单反斜杠\替换为双反斜杠\\。

步骤2：在指定父迭代下创建子迭代 #

调用创建命令时指定--path为上一步拿到的父迭代路径，即可直接在对应层级下生成子迭代，同时支持直接设置起止日期。
示例：在Son Sprint下创建名为Son-Sprint3的子迭代，起止日期为2024-06-01到2024-06-14：

az boards iteration project create \
--name "Son-Sprint3" \
--path "\Project A\Iteration\Father Sprint\Son Sprint" \
--start-date 2024-06-01 \
--finish-date 2024-06-14 \
--project "Project A"

执行成功后返回结果中的id字段即为该子迭代的child-id，可保存用于后续更新操作。

步骤3：更新已有子迭代信息 #

3.1 获取子迭代的child-id #

如果需要修改已存在的子迭代的日期、名称，可先通过列表命令查询对应迭代的id：

az boards iteration project list --project "Project A" --depth 10 --query "[?name=='Son-Sprint1'].{id:id, name:name, path:path}" -o json

返回结果中的id字段即为需要的child-id。

3.2 执行更新操作 #

更新支持两种参数指定方式，任选其一即可：

• 方式1：通过子迭代完整路径更新

az boards iteration project update \
--path "\Project A\Iteration\Father Sprint\Son Sprint\Son-Sprint1" \
--start-date 2024-05-01 \
--finish-date 2024-05-15 \
--project "Project A"

• 方式2：通过child-id更新

az boards iteration project update \
--child-id 替换为你查询到的子迭代数字ID \
--start-date 2024-05-01 \
--finish-date 2024-05-15 \
--project "Project A"

内容的提问来源于stack exchange，提问作者Shanks