Azure DevOps中AzurePowerShell@5任务无法调用自定义PowerShell函数

核心问题 #

你的脚本执行顺序错误：调用函数Function-A的代码写在了函数定义之前。PowerShell执行脚本是从上到下逐行运行的，当执行到调用语句时，Function-A还未被定义，因此触发报错。

本地运行正常大概率是因为你的本地PowerShell会话之前已经加载过这个函数（比如手动定义过、之前运行过脚本），或者使用的PowerShell ISE在“运行整个脚本”时会预解析所有函数定义，但Azure DevOps的PowerShell任务是在全新会话中执行脚本，严格按顺序执行，因此暴露了这个问题。

最简修复方法 #

直接调整脚本代码的顺序，把Function-A的定义移到调用语句之前：

# 先定义函数
Function-A{
    param(
        [string] $var1, 
        [string] $var2
    )

   #some logics here.
}

# 再定义变量并调用函数
$var1 = "var1"
$var2 = "var2"

$result = Function-A -var1 $var1 -var2 $var2

其他可选简便方案（若无法调整顺序） #

如果因特殊原因不能调整主脚本顺序，可通过点 sourcing 提前加载函数：

1. 将Function-A单独保存为小脚本，比如Function-A.ps1
2. 在主脚本的调用语句前添加：

. "$PSScriptRoot/Function-A.ps1"

但显然，直接调整主脚本的代码顺序是最无额外开销的解决方式。

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