如何从YAML模板向PowerShell脚本传递字符串数组并解决转换报错？

问题原因 #

当你在YAML模板中直接将数组参数${{parameters.PoolNames}}传入ScriptArguments时，Azure DevOps会把数组展开为空格分隔的字符串（例如pool1 pool2），但你的PowerShell脚本期望接收[string[]]类型的参数，这种格式无法被正确解析，从而触发"unable to convert Array to String"错误。

解决方案 #

在模板中通过Azure DevOps表达式将数组转换为PowerShell可识别的数组字面量格式（@('item1','item2')），具体修改templatePool.yml中的ScriptArguments配置：

parameters:
  Action: ''
  MachineDeploiement: ''
  ScriptsRemoteFolder: ''
  PoolNames: []

steps:
  - task: PowerShellOnTargetMachines@3
    displayName: 'exec script'
    inputs:
      Machines: '${{parameters.MachineDeploiement}}'
      UserName: '$(User)'
      UserPassword: '$(Pwd)'
      ScriptType: FilePath
      ScriptPath: '${{parameters.ScriptsRemoteFolder}}\AppPool.ps1'
      ScriptArguments: '-AppPoolNames @(''${{ join(''',''', parameters.PoolNames) }}'') -Action ${{parameters.Action}}'

说明 #

• join(''',''', parameters.PoolNames)：将数组元素用','连接，生成'pool1','pool2'格式的字符串
• 外层包裹@('...')：构造PowerShell数组字面量，确保脚本能正确解析为[string[]]类型参数
• YAML中使用两个单引号''表示转义的单引号，避免语法冲突

修改后，流水线传递的参数格式与你本地调用脚本时的@('pool1','pool2')完全一致，即可正常执行脚本。

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