如何在PowerShell 5.1中传递含特殊字符的字符串参数给Python脚本

针对PowerShell 5.1环境下，通过Ansible win_shell模块传递包含反引号（`）、单引号（'）、双引号（"）的参数时出现的参数解析错误，以下是两种通用解决方案：

方法一：使用PowerShell Here-String包裹命令 #

PowerShell的Here-String可以完整保留字符串内的特殊字符，避免被提前解析拆分。在Ansible任务中直接用Here-String包裹整个Python执行命令：

- name: 执行带特殊字符参数的Python脚本
  win_shell: |
    @"
    python.exe script.py --special_string "the\"str`in'g" --otherparam value
    "@

• 说明：Here-String以@"开头、"@结尾，内部双引号用\转义，反引号和单引号直接保留即可，PowerShell会将整个内容作为完整命令执行，不会拆分参数。

方法二：利用Ansible变量+quote过滤器 #

将特殊字符参数定义为Ansible变量，通过quote过滤器自动适配PowerShell的转义规则，确保参数被正确识别：

- name: 定义带特殊字符的参数变量
  set_fact:
    special_param: 'the"str`in'g'

- name: 执行Python脚本
  win_shell: python.exe script.py --special_string '{{ special_param | quote }}' --otherparam value

• 说明：quote过滤器会根据PowerShell的语法自动转义变量中的特殊字符，无需手动处理，是适配任意特殊字符的通用方案。

问题根源 #

直接在win_shell中书写命令时，PowerShell会优先解析字符串中的反引号（作为转义符）和双引号（作为字符串边界），导致--special_string的参数被截断，后续的--otherparam被错误解析为前一个参数的一部分，最终触发缺失参数的报错。

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