如何从Ansible调用远程Windows主机上的指定PowerShell函数

别担心，新手遇到这种问题太正常了！我之前在处理Windows服务器的Ansible任务时也踩过类似的坑，给你分享几个靠谱的解决方法：

方法一：用win_shell模块点源脚本后调用函数 #

这是最直接的方式，先把脚本加载到当前PowerShell会话，再调用目标函数。示例Playbook代码如下：

- name: 远程调用exchange.ps1中的fn_b函数
  hosts: your_windows_host
  tasks:
    - name: 执行fn_b并传入参数
      win_shell: |
        # 先点源脚本加载所有函数
        . C:\full\path\to\exchange.ps1
        # 调用fn_b并传递参数
        fn_b -ParamName1 "参数值1" -ParamName2 "参数值2"
      args:
        executable: powershell.exe

关键注意点： #

• 一定要用绝对路径指向exchange.ps1，因为Ansible的WinRM会话默认工作目录可能不是脚本所在位置，相对路径容易报错
• 如果你的函数需要特定的PowerShell环境（比如Exchange管理模块），可以在脚本开头加上加载模块的命令，或者在win_shell的代码块里先加载模块

方法二：用win_powershell模块更优雅地传递变量 #

如果你使用的Ansible版本比较新（2.8+），推荐用win_powershell模块，它能更方便地在Ansible和PowerShell会话之间传递变量，避免手动拼接字符串的麻烦：

- name: 用win_powershell调用fn_b函数
  hosts: your_windows_host
  vars:
    script_full_path: "C:\\full\\path\\to\\exchange.ps1"
    fn_param1: "你的第一个参数值"
    fn_param2: "你的第二个参数值"
  tasks:
    - name: 执行目标函数
      win_powershell:
        script: |
          . $using:script_full_path
          fn_b -ParamName1 $using:fn_param1 -ParamName2 $using:fn_param2

这里的$using:语法是PowerShell用来引用外部会话变量的方式，能安全地把Ansible定义的变量传递到远程PowerShell会话中，避免特殊字符转义的问题。

排障小技巧 #

如果还是调用失败，可以先在远程Windows服务器上手动打开PowerShell，执行以下命令测试：

. C:\full\path\to\exchange.ps1
fn_b -ParamName1 "测试值" -ParamName2 "测试值"

如果手动执行也报错，那问题大概率出在脚本本身（比如函数定义错误、参数不匹配），先解决脚本的问题再回到Ansible中。

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