TFS服务器构建步骤中PowerShell脚本无法读取系统环境变量

这个问题我碰到过好多次，核心原因在于环境变量的作用域和TFS构建服务运行的账户上下文完全不一样，具体拆解成这几个点：

• 你设置的是用户级环境变量，而非系统级
  当你通过RDP登录服务器后手动添加环境变量时，默认是加到当前管理员账户的「用户变量」里的——这属于你个人登录会话的私有变量。而TFS构建服务是用本地服务账户（比如NT AUTHORITY\NETWORK SERVICE或专门的构建账户）运行的，它的会话和你的登录账户完全独立，根本看不到其他用户的私有变量。哪怕你是管理员，服务账户的环境上下文也和你登录时不一样。

• 系统环境变量需要重启服务才能生效
  如果你确实设置的是系统级环境变量，但没重启TFS构建服务的话，服务进程不会自动刷新环境变量。Windows服务在启动时会一次性加载当时的系统环境变量，之后就算你修改了变量，运行中的服务也不会重新读取，必须重启服务才能生效。

• 构建步骤的PowerShell是「非交互式会话」
  RDP登录后的PowerShell是交互式会话，会完整加载用户配置文件和所有环境变量；但TFS构建里的PowerShell是后台运行的非交互式会话，它的环境集合更精简——尤其是如果你的变量是通过用户配置脚本（比如profile.ps1）加载的，非交互式会话根本不会执行这些脚本，自然拿不到变量。

对应的解决办法 #

• 确认并调整环境变量作用域：打开「系统属性→高级→环境变量」，检查你的变量在「用户变量」还是「系统变量」里。如果是前者，把它复制到「系统变量」区域，这样所有账户（包括服务账户）都能访问到。
• 重启TFS构建服务：打开服务管理器，找到「Visual Studio Team Foundation Build Service」（或对应版本的TFS构建服务名称），重启它，让服务加载新的系统环境变量。
• 临时脚本兜底方案：如果不想重启服务，可以在PowerShell脚本里直接读取注册表获取系统变量，比如：

  $targetVar = "你的环境变量名"
  $varValue = Get-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment' -Name $targetVar | Select-Object -ExpandProperty $targetVar
  

• 检查构建服务运行账户：确认TFS构建服务的运行账户（可以在服务属性里看），如果是自定义域账户，确保它有读取系统环境变量的权限（不过系统变量默认是所有账户可读的，这一步大概率没问题）。

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