Azure DevOps发布管道：如何让自定义PowerShell模块供多任务调用？

核心原因 #

每个Azure PowerShell任务都是独立的PowerShell会话，会话之间的模块导入、变量等状态不会共享，所以任务1中导入的模块无法直接在任务2中生效。

解决方案 #

方案1：将模块部署到Agent的全局模块路径（推荐，适合长期复用） #

把自定义模块复制到Agent的PSModulePath目录下，后续所有PowerShell任务都能直接识别并调用模块：

1. 在任务1的PowerShell脚本中添加以下代码：

$currentDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$moduleSourcePath = Join-Path $currentDir "modules\deploy"

# 获取Agent的用户级模块路径（避免权限问题）
$userModulePath = ($env:PSModulePath -split ';') | Where-Object { $_ -match 'Users\\[^\\]+\\Documents\\WindowsPowerShell\\Modules' }

# 复制模块到目标路径
Copy-Item -Path $moduleSourcePath -Destination $userModulePath -Recurse -Force

2. 后续任务（如任务2）只需简单导入模块即可使用函数：

Import-Module deploy -Force
Get-BuildNumber

方案2：通过环境变量传递模块路径，简化后续任务导入 #

利用Azure DevOps任务间共享环境变量的特性，传递模块路径，后续任务只需一行代码完成导入：

1. 在任务1的PowerShell脚本中设置共享环境变量：

$currentDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$modulePath = Join-Path $currentDir "modules\deploy"
# 设置跨任务共享的环境变量
Write-Host "##vso[task.setvariable variable=CUSTOM_MODULE_PATH;]$modulePath"

# 任务1中正常使用模块
Import-Module $modulePath -Force
Get-BuildNumber

2. 在任务2的PowerShell脚本中直接用环境变量导入模块：

Import-Module $env:CUSTOM_MODULE_PATH -Force
Get-BuildNumber

针对疑问的解答 #

• 是否使用Install-Module而非Import-Module？
  若需从Azure Artifacts或PowerShell Gallery直接安装模块，Install-Module适用；但你的模块已提取到Agent的Release目录，直接复制到全局路径或传递路径的方式效率更高。
• 是否必须为每个任务导入模块？
  是的，因为每个任务是独立会话。但通过上述方案，你可以避免重复编写复杂的路径定位代码，只需一行简单的Import-Module即可；若给模块添加规范的.psd1清单并导出函数，部署到全局路径后，PowerShell会自动加载模块，无需显式调用Import-Module。

额外优化建议 #

你的deploy.psm1仅通过点源加载脚本，建议添加模块清单文件（deploy.psd1），明确指定要导出的函数，确保模块结构规范且函数能正确暴露到全局：

# 示例deploy.psd1内容
@{
    RootModule = 'deploy.psm1'
    ModuleVersion = '1.0.0'
    FunctionsToExport = @('Get-BuildNumber', '其他需导出的函数名')
}

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