如何通过TFS API或Web UI批量授予用户多项目构建定义权限？

当然可以！不用逐个项目手动点来点去设置权限，不管是通过Web UI还是API/PowerShell，都有批量搞定的方案，下面给你详细说明：

通过Web UI批量设置 #

这种方法适合喜欢可视化操作的场景，前提是你拥有TFS服务器或项目集合级别的管理员权限：

• 第一步，创建/配置权限模板：
  打开TFS的服务器管理页面（一般是http://<你的TFS服务器地址>:8080/tfs/_admin），依次点击「权限」→「权限模板」。你可以新建一个模板，或者编辑现有模板，在模板里找到「创建构建定义（Create build definitions）」权限，将其设置为「允许」。
• 第二步，批量应用模板到所有项目：
  回到服务器管理页面的「项目集合」板块，按住Ctrl键选中所有需要授权的团队项目（或者直接全选），右键点击选中的项目，选择「应用权限模板」，然后选择你刚才配置好的模板即可。这样就能一次性把权限同步到所有选中的项目里。

通过API/PowerShell批量设置 #

如果需要自动化或者更灵活的批量操作，推荐用PowerShell结合TFS的REST API来实现：

PowerShell 示例（使用VSTS模块） #

1. 先安装并导入适配TFS2018的PowerShell模块：

# 安装VSTS模块（适配TFS2018的版本）
Install-Module -Name VSTS -Scope CurrentUser -Force
Import-Module VSTS

2. 连接到你的TFS服务器：

$tfsServerUrl = "http://<你的TFS服务器地址>:8080/tfs"
$collectionName = "<你的项目集合名称，比如DefaultCollection>"
$targetUser = "<需要授权的用户账号，格式为DOMAIN\username>"

# 建立连接
Connect-VstsAccount -Account $tfsServerUrl -CollectionName $collectionName

3. 获取所有团队项目并批量授予权限：

# 获取当前集合下的所有项目
$allProjects = Get-VstsProject

# 构建权限对应的命名空间和权限位（TFS2018中创建构建定义的权限位是256）
$buildPermissionNamespace = "Build"
$createBuildDefPermissionBit = 256

# 遍历每个项目添加权限
foreach ($project in $allProjects) {
    $securityToken = "project:$($project.Id),$($project.Name)"
    # 给目标用户添加允许权限
    Add-VstsPermission -NamespaceId $buildPermissionNamespace -Token $securityToken -PrincipalName $targetUser -Allow $createBuildDefPermissionBit
    Write-Host "已为项目 $($project.Name) 授予权限"
}

REST API 示例 #

如果更倾向于直接调用API，步骤如下：

1. 获取所有团队项目：
   发送GET请求：

   GET http://<你的TFS服务器>:8080/tfs/<集合名称>/_apis/projects?api-version=4.1
   

   响应里会返回所有项目的ID和名称。

2. 批量添加权限：
   对每个项目，发送POST请求到权限API：

   POST http://<你的TFS服务器>:8080/tfs/<集合名称>/_apis/security/acltokens?api-version=4.1
   

   请求体（JSON格式）示例：

   {
       "namespaceId": "2e9eb7ed-3c0a-47d4-87c1-0ffdd275fd87", // Build命名空间的固定ID
       "token": "project:<项目ID>,<项目名称>",
       "acesDictionary": {
           "<用户的SID或账号>": {
               "allow": 256,
               "deny": 0,
               "extendedInfo": {}
           }
       }
   }
   

注意事项 #

• 执行操作的账号必须拥有足够的权限：需要服务器或项目集合级的管理员权限，否则无法修改其他项目的权限设置。
• 权限位的值要确认准确：TFS2018中「创建构建定义」的权限位是256，如果不确定，可以通过调用GET http://<TFS服务器>:8080/tfs/<集合名称>/_apis/security/namespaces/2e9eb7ed-3c0a-47d4-87c1-0ffdd275fd87?api-version=4.1查看完整的权限位定义。

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