TFS 2018 XAML构建迁移：PowerShell脚本获取构建号报错求助

首先看你贴的脚本，第一眼就发现一个语法错误：在加载Microsoft.TeamFoundation.Client程序集的那行，你写的是[void[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.TeamFoundation.Client")——这里少了一个闭合的方括号，正确应该是[void][System.Reflection.Assembly]::LoadWithPartialName(...)。这个语法问题肯定会导致脚本执行到这一行时抛出异常，这是最优先要修复的点。

除了这个明显的语法错误，结合你是从XAML构建升级到新系统的背景，还有这些可能的原因和排查方向：

可能的报错原因及排查步骤 #

1. 环境变量未正确设置或存在变更 #

新构建系统（比如Azure DevOps Server/Azure DevOps Services）的环境变量可能和旧XAML构建有差异：

• 在脚本开头添加调试输出，确认变量值：

  Write-Host "SYSTEM_TEAMFOUNDATIONCOLLECTIONURI: $env:SYSTEM_TEAMFOUNDATIONCOLLECTIONURI"
  Write-Host "BUILD_BUILDURI: $env:BUILD_BUILDURI"
  

  执行构建后查看日志，确认这两个变量是否存在、格式是否正确（比如集合URI应该是类似https://dev.azure.com/YourOrg/或http://tfs-server:8080/tfs/CollectionName/的格式）。
• 有些新系统中，部分变量名可能调整，注意检查是否误写了变量名（PowerShell环境变量大小写不敏感，但尽量和官方定义保持一致）。

2. TFS客户端程序集加载失败 #

LoadWithPartialName是已过时的API，在新的Windows环境或构建代理上，可能无法正确定位到旧的TFS客户端程序集：

• 尝试替换为Add-Type命令加载程序集，更可靠：

  Add-Type -AssemblyName "Microsoft.TeamFoundation.Client"
  Add-Type -AssemblyName "Microsoft.TeamFoundation.Build.Client"
  Add-Type -AssemblyName "Microsoft.TeamFoundation.VersionControl.Client"
  

• 确认构建代理上是否安装了Team Foundation Server 客户端工具或对应的NuGet包（比如Microsoft.TeamFoundationServer.Client），如果没有，需要安装这些组件才能让PowerShell找到相关程序集。
• 考虑使用更现代的Azure DevOps PowerShell模块（比如Az.DevOps或TfsCmdlets）替代旧的客户端程序集调用，这些模块专门为新构建系统设计，兼容性更好。

3. 构建服务账号权限不足 #

TfsTeamProjectCollectionFactory.GetTeamProjectCollection需要构建服务账号具备访问对应团队项目集合的权限：

• 用构建服务账号登录到你的TFS/ADO实例，尝试访问对应的团队项目集合和构建详情页面，确认账号有读取构建的权限。
• 在项目集合的权限设置中，检查构建服务账号是否被添加到合适的组（比如“项目集合参与者”或自定义的权限组），确保拥有必要的权限。

4. URL格式或网络问题 #

• 确认$CollectionUrl和$BuildUrl的格式是否正确：集合URI是否包含正确的端口、集合名称，构建URI是否指向有效的构建实例。可以把这两个URL复制到浏览器中，看是否能正常打开对应的页面。
• 检查构建代理是否能正常访问TFS/ADO服务器：比如是否有防火墙阻止了代理和服务器之间的通信，或者是否需要配置代理服务器才能访问。

5. .NET版本兼容性问题 #

旧的TFS客户端程序集可能依赖特定版本的.NET Framework，而新构建代理上的默认.NET版本可能不兼容：

• 在脚本开头指定使用的.NET版本，比如：

  $env:DOTNET_FRAMEWORK_VERSION = "v4.0.30319"
  

• 确认构建代理上安装了兼容的.NET Framework版本（比如.NET Framework 4.5及以上，旧TFS组件通常需要这个版本）。

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