如何使用Azure DevOps CLI将指定用户分配至组织全部项目

算力阿峰

2026-7-2

使用Azure DevOps CLI批量给组织所有项目分配用户权限

前提准备

确保已安装Azure DevOps CLI，未安装可执行：az extension add --name azure-devops

登录并配置默认组织：

az login
az devops configure --defaults organization=https://dev.azure.com/你的组织名称

步骤1：获取组织内所有项目ID

根据终端类型选择对应命令：

Bash/Zsh：
```
PROJECT_IDS=$(az devops project list --output json | jq -r '.[].id')
```
（未安装jq可通过包管理器安装，比如apt install jq或brew install jq）

Windows PowerShell：

$projectIds = (az devops project list --output json | ConvertFrom-Json).id

步骤2：批量添加用户到所有项目

替换命令中的目标用户邮箱和权限角色（如Contributor、Reader、Project Administrator）为实际值，执行循环：

Bash/Zsh：

USER_EMAIL="user@domain.com"
ROLE="Contributor"

for project_id in $PROJECT_IDS; do
    az devops user add --email $USER_EMAIL --project $project_id --role $ROLE
    echo "已完成项目ID: $project_id 的用户添加"
done

Windows PowerShell：

$userEmail = "user@domain.com"
$role = "Contributor"

foreach ($projectId in $projectIds) {
    az devops user add --email $userEmail --project $projectId --role $role
    Write-Host "已完成项目ID: $projectId 的用户添加"
}