如何向PowerShell脚本传递包含左括号“(”的字符串参数？

该报错本质是PowerShell命令行参数解析机制导致的：未被正确标识为字符串字面量的参数值中，(属于PowerShell语法元字符，会被解析器识别为表达式的起始标记，当(出现在值末尾时，解析器找不到后续预期的表达式内容，就会抛出An expression was expected after '('错误。

• 优先使用变量传参（最适配Jenkins场景）
  不要直接在命令行拼接明文密码值，先把Jenkins外部传入的密码值赋值给PowerShell的字符串类型变量，再通过变量给脚本传参。这种方式下参数值是内存中的字符串对象，不会经过命令行字面量解析流程，无论密码包含括号、$、空格、引号等任何特殊字符，都能被完整识别。示例代码：

  # 从Jenkins注入的环境变量读取密码，赋值给字符串变量
  $securePassword = $env:GENERATED_PASSWORD
  # 传变量给脚本，无需额外转义
  .\your_script.ps1 -password $securePassword -otherMandatoryParam1 value1 -otherMandatoryParam2 value2
  

• 直接命令行传参时用单引号包裹密码值
  如果必须直接拼接命令行传参，给密码值整体包裹英文单引号。PowerShell会将单引号包裹的内容识别为纯字面量字符串，内部所有特殊字符都不会做语法解析。注意不要用双引号包裹，双引号内部的$、反引号等字符仍会被解析为变量或转义标记，可能导致密码值被篡改。示例：

  # 密码值为xxx(，用单引号包裹即可正常识别
  .\your_script.ps1 -password 'xxx('
  

  Jenkins中拼接命令时，直接将密码变量放在单引号对内即可，Jenkins会在执行命令前完成变量替换，最终传给PowerShell的是符合格式的带单引号包裹的参数值。
• 极端场景使用停止解析参数
  如果密码同时包含单引号、括号、$等大量特殊字符，可在密码参数前加--%标记，该标记会告诉PowerShell停止对后续所有内容做语法解析，全部按原始字面量处理。示例：

  # --% 之后的所有内容都不会做语法解析，任意特殊字符都能正常传递
  .\your_script.ps1 --% -password (xX'abc$123(
  

  注意--%必须放在需要停止解析的参数之前，且标记后不能再使用PowerShell变量，仅适合传递固定字面量值的场景。
• 脚本侧加兜底约束
  在脚本的param块中，明确给password参数添加[string]强类型约束，避免解析器把特殊字符识别成其他类型对象：

  param(
      [Parameter(Mandatory = $true)]
      [string]$password,
      # 其余强制参数按实际需求定义
      [Parameter(Mandatory = $true)]
      [string]$otherParam1
  )
  

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