Azure DevOps流水线：如何通过JSON向PowerShell传参并配置YAML

问题分析 #

之前通过scriptArguments传参未生效，核心原因有两点：

1. PowerShell脚本未定义参数接收块，无法捕获命令行传入的参数
2. 未从JSON文件中提取参数值并传递给脚本

下面提供两种可行的解决方式：

方式一：YAML读取JSON并传递参数给脚本 #

1. 修改PowerShell脚本（test.ps1） #

添加param块定义接收的参数，并将参数赋值到$Parameters哈希表：

param(
    [string]$storageAccountName,
    [string]$location,
    [string]$storageSKU
)

$Parameters = @{ 
   storageAccountName = $storageAccountName
   location = $location  
   storageSKU = $storageSKU 
}

# 可选：验证参数是否正确接收
Write-Host "已获取参数："
Write-Host "- 存储账户名：$($Parameters.storageAccountName)"
Write-Host "- 区域：$($Parameters.location)"
Write-Host "- SKU：$($Parameters.storageSKU)"

2. 修改Azure DevOps YAML流水线（test.yaml） #

新增步骤读取JSON文件，提取参数并设置为流水线变量，再将变量作为参数传给PowerShell任务：

trigger:
- master

pool:
  vmImage: ubuntu-latest

steps:
# 步骤1：读取JSON文件，提取参数并设置为流水线变量
- task: PowerShell@2
  name: ReadJsonParams
  inputs:
    targetType: 'inline'
    script: |
      # 读取并解析JSON文件
      $jsonContent = Get-Content -Path 'test.json' -Raw | ConvertFrom-Json
      # 设置流水线变量，供后续任务使用
      Write-Host "##vso[task.setvariable variable=storageAccountName]$($jsonContent.storageAccountName)"
      Write-Host "##vso[task.setvariable variable=location]$($jsonContent.location)"
      Write-Host "##vso[task.setvariable variable=storageSKU]$($jsonContent.storageSKU)"

# 步骤2：调用Azure PowerShell脚本，传递提取的参数
- task: AzurePowerShell@5
  inputs:
    azureSubscription: 'xxxx'
    ScriptType: 'FilePath'
    ScriptPath: 'test.ps1'
    # 使用流水线变量作为脚本参数
    scriptArguments: "-storageAccountName $(storageAccountName) -location $(location) -storageSKU $(storageSKU)"
    azurePowerShellVersion: Latest
    # 启用PowerShell Core（原Versionpwsh参数已废弃，改用pwsh）
    pwsh: true

方式二：PowerShell脚本直接读取JSON文件 #

如果JSON文件与脚本在同一目录，可让脚本自行读取解析，无需YAML传参，更简洁：

修改test.ps1： #

# 读取并解析同目录下的test.json
$jsonContent = Get-Content -Path "$PSScriptRoot/test.json" -Raw | ConvertFrom-Json

$Parameters = @{ 
   storageAccountName = $jsonContent.storageAccountName
   location = $jsonContent.location  
   storageSKU = $jsonContent.storageSKU 
}

# 验证参数
Write-Host "已从JSON获取参数："
Write-Host "- 存储账户名：$($Parameters.storageAccountName)"
Write-Host "- 区域：$($Parameters.location)"
Write-Host "- SKU：$($Parameters.storageSKU)"

修改test.yaml： #

无需额外传参，直接调用脚本即可：

trigger:
- master

pool:
  vmImage: ubuntu-latest

steps:
- task: AzurePowerShell@5
  inputs:
    azureSubscription: 'xxxx'
    ScriptType: 'FilePath'
    ScriptPath: 'test.ps1'
    azurePowerShellVersion: Latest
    pwsh: true

关键注意事项 #

• 确保JSON文件路径正确：流水线运行时，文件路径相对于仓库根目录
• AzurePowerShell@5任务中，Versionpwsh参数已废弃，需改用pwsh: true启用PowerShell Core
• 若使用流水线变量，变量名需避免特殊字符，且在后续任务中通过$(变量名)引用

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