如何将项目下所有迭代批量添加至该项目的全部团队？

要实现将指定层级的迭代批量添加到项目所有团队，你可以通过Shell脚本结合Azure CLI的循环逻辑完成，具体操作如下：

1. 前置准备 #

确保你已完成：

• 通过 az login 登录Azure CLI
• 明确目标项目名称，或执行 az devops configure --defaults project=你的项目名 设置默认项目

2. 批量操作脚本 #

将以下代码保存为Shell脚本（例如batch-add-iterations.sh），替换PROJECT_NAME为你的项目名称后执行：

#!/bin/bash
# 设置目标项目名称
PROJECT_NAME="你的项目名称"

# 获取depth=2层级下的所有迭代ID
ITERATIONS=$(az boards iteration project list --depth 2 --query "children[*].children[*].identifier" --output tsv --project $PROJECT_NAME)

# 获取项目下所有团队ID
TEAMS=$(az devops team list --query "[].id" --output tsv --project $PROJECT_NAME)

# 嵌套循环批量添加迭代到每个团队
for TEAM_ID in $TEAMS; do
    echo "开始处理团队：$TEAM_ID"
    for ITERATION_ID in $ITERATIONS; do
        echo "添加迭代 $ITERATION_ID 至团队 $TEAM_ID..."
        az boards iteration team add --id $ITERATION_ID --team $TEAM_ID --project $PROJECT_NAME || echo "迭代 $ITERATION_ID 已存在于该团队，跳过"
    done
done

echo "批量添加操作完成"

关键命令说明 #

• 提取迭代ID：az boards iteration project list --depth 2 --query "children[*].children[*].identifier" --output tsv

  • --output tsv将JSON数组转换为每行一个ID的格式，便于循环遍历
  • --depth 2指定获取到第三层级的迭代（根节点→一级节点→二级节点）

• 提取团队ID：az devops team list --query "[].id" --output tsv

  • 仅提取团队ID字段并以TSV格式输出，简化循环处理

• 批量添加逻辑：通过两层循环遍历所有团队和迭代，执行添加命令；|| echo "..."用于捕获重复添加的报错，避免脚本中断

注意事项 #

• 执行脚本前需赋予执行权限：chmod +x batch-add-iterations.sh
• 若无需处理重复添加的提示，可移除命令末尾的|| echo "..."部分
• 确保当前账号拥有团队迭代管理的权限，否则会触发权限不足的错误

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