YAML CI流水线执行PowerShell脚本报命令未识别错误

该报错的核心触发逻辑是：PowerShell解析执行流时，将分支值refs/heads/feature/nuget识别为独立的待执行命令，而非传入脚本的参数值，常见诱因有三类：

• CI YAML中传参格式不规范，裸用流水线变量未做包裹，变量展开后出现位置错位。若脚本调用时未明确指定参数名、未给变量值加引号，变量展开后存在换行、空格分隔时，PowerShell会将分支值判定为新的命令入口。
• PowerShell脚本参数定义缺失或错误，比如脚本开头未写param()块、参数属性配置错误，导致传入的分支值无法被绑定到预设参数变量中，直接流入执行管道被当作命令解析。
• 内联PowerShell脚本中直接将流水线变量插值到赋值语句中未加引号，变量展开后变成裸字符串，被PowerShell识别为命令。

按优先级逐一排查调整即可：

1. 规范YAML侧的传参格式，明确指定参数名，所有流水线变量用双引号包裹，禁止裸传位置参数
   错误写法示例：

   - task: PowerShell@2
     inputs:
       filePath: './scripts/deploy.ps1'
       arguments: $(Build.SourceBranch)
   

   正确写法示例：

   - task: PowerShell@2
     inputs:
       filePath: './scripts/deploy.ps1'
       arguments: '-SourceBranch "$(Build.SourceBranch)"'
   

2. 校验PowerShell脚本的参数块定义，确保入参可被正确捕获，脚本开头必须添加标准参数声明：

   param(
       [Parameter(Mandatory = $true)]
       [string]$SourceBranch
   )
   # 调试阶段可加日志确认参数取值
   Write-Host "接收到的源分支参数：$SourceBranch"
   

3. 若使用内联PowerShell模式，所有流水线变量插值时必须包裹在引号中，禁止裸写插值
   错误写法示例：

   - task: PowerShell@2
     inputs:
       inline: |
         $sourceBranch = $(Build.SourceBranch)
   

   正确写法示例：

   - task: PowerShell@2
     inputs:
       inline: |
         $sourceBranch = "$(Build.SourceBranch)"
         Write-Host "当前源分支：$sourceBranch"
   

调试技巧：可在脚本首行添加$args | ForEach-Object { Write-Host "未绑定参数：$_" }，如果日志中打印出refs/heads/feature/nuget，即可确认是参数绑定失败导致的解析错误。

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