Azure YAML Pipeline中PowerShell转YAML到JSON失败问题排查

核心问题分析 #

1. PowerShell脚本参数传递错误：Azure Pipeline中给脚本传参的格式完全错误，额外添加了| ConvertFrom-Yaml（脚本内部已处理该逻辑），且参数赋值的格式不符合PowerShell规范（-参数名 = 值的写法会被解析错误）。
2. 输出目录不存在：Azure Pipeline代理环境中，$(System.DefaultWorkingDirectory)/test/output目录可能未提前创建，Set-Content命令无法自动创建不存在的父目录，导致“找不到路径的一部分”错误；本地环境中该目录可能已存在，所以无此问题。
3. 发布任务路径不匹配：发布任务指定的目标路径与脚本输出路径不一致，即使转换成功也无法正确发布产物。

修正步骤 #

1. 修复Azure Pipeline的PowerShell任务参数 #

将原Pipeline中的PowerShell任务arguments部分修正为正确的参数传递格式，移除多余的| ConvertFrom-Yaml，并修正参数赋值语法：

- task: PowerShell@2
  displayName: Convert yaml to json
  inputs:
    targetType: 'filePath'
    filePath: $(System.DefaultWorkingDirectory)/_scripts/_powershell/convert-yaml-to-json.ps1
    arguments: >
      -InputFile "$(System.DefaultWorkingDirectory)/test/input/myYaml.yaml"
      -OutputFile "$(System.DefaultWorkingDirectory)/test/output/MyJson.json"

2. 在脚本中添加目录检查与创建逻辑 #

修改PowerShell脚本，确保输出文件的父目录存在，避免因目录缺失导致的错误：

param(
  [string]$InputFile,
  [string]$OutputFile
)

# 检查输出目录是否存在，不存在则创建
$outputDir = Split-Path -Path $OutputFile -Parent
if (-not (Test-Path -Path $outputDir)) {
    New-Item -ItemType Directory -Path $outputDir | Out-Null
}

$yaml = Get-Content $InputFile | ConvertFrom-Yaml
$json = $yaml | ConvertTo-Json
Set-Content -Path $OutputFile -Value $json

3. 修正发布任务的目标路径 #

将PublishBuildArtifacts任务的targetPath改为脚本实际输出的文件路径：

- task: PublishBuildArtifacts@1
  displayName: "Publish converted JSON"
  inputs:
    targetPath: '$(System.DefaultWorkingDirectory)/test/output/MyJson.json'
    ArtifactName: DFXMainJSON

验证要点 #

• 确认ConvertFrom-Yaml模块已在Azure Pipeline代理环境中安装（若使用的是自定义模块，需在Pipeline中提前安装，比如通过Install-Module -Name powershell-yaml -Force命令）。
• 检查输入YAML文件的路径是否正确，确保文件存在于Pipeline工作目录中。

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