Azure YAML Pipeline中PowerShell任务MissingEndParenthesisInExpression问题排查

这个问题我之前也碰到过，核心原因是你在arguments参数里直接写了PowerShell表达式，而Azure Pipeline的PowerShell@2任务在filePath模式下，会把arguments里的内容原样作为字符串参数传递给你的脚本，并不会解析执行其中的PowerShell语法。

具体来说，当$(appPassword)作为秘密变量被Pipeline自动掩码成***后，原本的表达式变成了(convertTo-SecureString *** -AsPlainText -Force)，这在语法上完全不合法——PowerShell会把***当成普通字符串，但括号的上下文被破坏，直接触发了"Missing closing ')' in expression"的解析错误。

下面是两种可行的解决方案：

方案一：将SecureString转换逻辑移到脚本内部（推荐） #

把密码转换的逻辑放到testscript.ps1里，让脚本接收明文密码参数，再在内部转换为SecureString。这种方式更易维护，也符合PowerShell脚本的最佳实践：

首先修改你的testscript.ps1：

# testscript.ps1
param(
    [string]$parameterFilePath,
    [string]$appPassword,
    [string]$vmPassword
)

# 在脚本内部转换为SecureString
$appSecurePassword = ConvertTo-SecureString $appPassword -AsPlainText -Force
$vmSecurePassword = ConvertTo-SecureString $vmPassword -AsPlainText -Force

# 后续业务逻辑...

然后更新Pipeline中的PowerShell任务配置：

- task: PowerShell@2
  displayName: 'test'
  inputs:
    targetType: filePath
    filePath: '$(Agent.BuildDirectory)\$(artifactName)\testpath\testscript.ps1'
    arguments: '-parameterFilePath $(Agent.BuildDirectory)\$(artifactName)\mainfolder\params.json -appPassword $(appPassword) -vmPassword $(vmPassword)'

不用担心明文密码的安全问题——Pipeline会自动对秘密变量进行掩码保护，不会在日志中泄露。

方案二：改用Inline脚本模式调用脚本 #

如果坚持要在Pipeline层面处理SecureString，可以切换到inline脚本模式，先执行表达式生成SecureString对象，再传递给目标脚本：

- task: PowerShell@2
  displayName: 'test'
  inputs:
    targetType: 'inline'
    script: |
        $appSecurePassword = ConvertTo-SecureString "$(appPassword)" -AsPlainText -Force
        $vmSecurePassword = ConvertTo-SecureString "$(vmPassword)" -AsPlainText -Force
        & "$(Agent.BuildDirectory)\$(artifactName)\testpath\testscript.ps1" `
            -parameterFilePath "$(Agent.BuildDirectory)\$(artifactName)\mainfolder\params.json" `
            -appSecurePassword $appSecurePassword `
            -vmSecurePassword $vmSecurePassword

这种方式下，Pipeline会先执行inline脚本里的表达式，再把生成的SecureString对象传递给你的脚本。

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