Azure Pipeline中PowerShell脚本报错：'script:'未被识别为有效命令

错误原因 #

1. YAML关键字误用：你在PowerShell脚本块内写入了script:和displayName:，这两个是Azure DevOps流水线的YAML步骤属性，并非PowerShell命令，因此PowerShell无法识别并报错。
2. CMD语法错误：%errorlevel%是CMD环境的错误码变量，PowerShell中应使用$LASTEXITCODE获取外部程序的退出码。
3. 路径错误：C:\C:\location_of_build_agent.exe存在重复的根路径，需修正为C:\location_of_build_agent.exe。
4. 数组传递隐患：直接将数组转为空格分隔的字符串传递，若文件夹名称包含空格，后续split操作会导致数据错误。

修正方案（两种可选） #

方案一：单PowerShell任务内批量执行 #

适合不需要单独查看每个配置项执行状态的场景：

steps:
- checkout: self
  submodules: true
- powershell: |
    # 获取目标文件夹列表并转为JSON格式传递，避免空格分割问题
    $arr = Get-ChildItem '$(Build.SourcesDirectory)\Physical' | Where-Object {$_.PSIsContainer} | Foreach-Object {$_.Name}
    $arrJson = $arr | ConvertTo-Json
    Write-Host "##vso[task.setvariable variable=arrJson;]$arrJson"
  displayName: '获取配置文件夹列表'

- powershell: |
    # 解析JSON数组
    $arr = ConvertFrom-Json "$(arrJson)"
    foreach($item in $arr){
        Write-Host "===== 开始处理配置项：$item ====="
        # 执行构建代理程序，修正路径错误
        & "C:\location_of_build_agent.exe" "$(Build.SourcesDirectory)\file_to_be_build" -c $item -buildMode "Rebuild"
        
        # PowerShell中使用$LASTEXITCODE获取外部程序退出码
        if ($LASTEXITCODE -eq 1) {
            Write-Host "配置项$item执行返回码1，退出0"
            exit 0
        } else {
            Write-Host "配置项$item执行返回码$LASTEXITCODE，退出该码"
            exit $LASTEXITCODE
        }
    }
  displayName: '批量执行Rebuild操作'

方案二：生成独立流水线步骤 #

每个配置项对应一个独立的流水线步骤，便于单独查看执行状态：

steps:
- checkout: self
  submodules: true
- powershell: |
    $arr = Get-ChildItem '$(Build.SourcesDirectory)\Physical' | Where-Object {$_.PSIsContainer} | Foreach-Object {$_.Name}
    $arrJson = $arr | ConvertTo-Json
    # 将变量设为输出变量，供后续步骤引用
    Write-Host "##vso[task.setvariable variable=arrJson;isOutput=true;]$arrJson"
  displayName: '获取配置文件夹列表'
  name: GetConfigList

# 使用流水线each循环生成独立步骤
- ${{ each item in convertFromJson(variables['GetConfigList.arrJson']) }}:
  - powershell: |
      & "C:\location_of_build_agent.exe" "$(Build.SourcesDirectory)\file_to_be_build" -c "${{ item }}" -buildMode "Rebuild"
      
      if ($LASTEXITCODE -eq 1) {
          exit 0
      } else {
          exit $LASTEXITCODE
      }
    displayName: 'Run Build script for ${{ item }}'

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