Windows 10客户端PowerShell调用tfpt报错，求排查解决方法

首先，tfpt是TFS Power Tools提供的命令行工具，你遇到的核心问题是PowerShell找不到这个可执行文件，进而导致$WorkItemResults没有赋值，引发后续一系列异常。下面是针对性的解决步骤：

1. 确认tfpt.exe路径已加入系统PATH #

• 先找到你安装的TFS Power Tools对应的tfpt.exe位置，通常路径类似：
  • 2012版：C:\Program Files (x86)\Microsoft Team Foundation Server 2012 Power Tools
  • 2013/2015版对应替换版本号即可
• 打开系统属性 -> 高级 -> 环境变量，在系统变量的Path中添加上述路径
• 重启PowerShell ISE或新的PowerShell会话，让PATH变更生效

2. 直接使用完整路径调用tfpt（无需修改PATH） #

如果暂时不想修改系统PATH，可以在脚本里直接指定tfpt.exe的完整路径调用，注意要用&来执行外部程序：

# 替换为你实际的tfpt.exe路径
$tfptExe = "C:\Program Files (x86)\Microsoft Team Foundation Server 2012 Power Tools\tfpt.exe"
$WorkItemResults = & $tfptExe query /format:tsv /collection:$TfsServer /wiql:$query

3. 验证TFS PowerShell Snap-In加载正确性 #

你提到已注册相关Snap-In，但还是要确保核心的TFS Snap-In正常加载：

• 运行Get-PSSnapin -Registered，确认Microsoft.TeamFoundation.PowerShell在列表中
• 修改脚本里的加载逻辑，加上错误终止以便排查：

  if (-not (Get-PSSnapin -Name Microsoft.TeamFoundation.PowerShell -ErrorAction SilentlyContinue)) {
      Add-PSSnapin Microsoft.TeamFoundation.PowerShell -ErrorAction Stop
  }
  

  （注：TfsBPAPowerShellSnapIn是业务流程分析工具的Snap-In，和tfpt无关，不用依赖它）

4. 更优替代：使用原生TFS PowerShell命令 #

既然已经加载了TFS PowerShell Snap-In，完全可以抛弃tfpt命令，直接用PowerShell原生命令查询工作项，这样更可靠且无需处理TSV格式：

# Enforce coding rules
Set-StrictMode -version 2.0
# Loads Windows PowerShell snap-in if not already loaded
if (-not (Get-PSSnapin -Name Microsoft.TeamFoundation.PowerShell -ErrorAction SilentlyContinue)) {
    Add-PSSnapin Microsoft.TeamFoundation.PowerShell -ErrorAction Stop
}
$PbiParm = 89306
$TfsServer = "http://***tfs01:8080/tfs/Project"

# 用原生命令查询工作项
$tfsCollection = New-TfsTeamProjectCollection -Uri $TfsServer
$workItem = Get-TfsWorkItem -Collection $tfsCollection -Id $PbiParm

# 直接获取所需属性
$SprintName = $workItem.IterationPath
$PbiTitle = $workItem.Title

# 验证输出
Write-Host "Sprint Name: $SprintName"
Write-Host "PBI Title: $PbiTitle"

这种方式避免了字符串分割、替换等容易出错的步骤，代码更简洁健壮。

只要解决了tfpt的识别问题，后续$WorkItemResults未赋值的异常自然就消失了。

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