Azure Automation自定义PowerShell模块无法导出命令问题咨询

问题概述 #

本地测试正常的自定义PowerShell模块，每个函数单独存放在functions文件夹，通过.psm1加载并导出成员，但上传到Azure Automation后，模块能成功导入，却始终无法识别导出的命令。尝试过调整.psd1的FunctionsToExport配置（指定函数名、通配符、空数组）、修改压缩包结构，均无效果。

模块核心代码与结构 #

.psm1加载逻辑

$functions = @(Get-ChildItem -Path $PSScriptRoot\functions\*.ps1 -ErrorAction SilentlyContinue)

foreach ($import in @($functions)) {
    try {
        . $import.Fullname -ErrorAction Stop
    }
    catch {
        Write-Error -Message "Failed to import function $($import.Fullname): $_" -ErrorAction Continue
    }
}

Export-ModuleMember -Function $functions.Basename

.psd1关键配置

#...
RootModule        = 'MHZ.Developer.psm1'
#...
FunctionsToExport = '*'
CmdletsToExport   = '*'
VariablesToExport = '*'
AliasesToExport   = @()
#...

原压缩包结构

MHZ.Developer.zip
├── MHZ.Developer.psd1
├── MHZ.Developer.psm1
│   ├── functions
│   │   ├── Get-FooBaa.ps1

调整后尝试过同名文件夹结构，上传后模块路径为C:\usr\src\PSModules\MHZ.Developer\MHZ.Developer.psm1。

核心问题排查 #

1. 压缩包结构不规范：Azure Automation要求模块压缩包必须以模块名作为顶层文件夹，直接将.psd1、.psm1放在zip根目录会导致路径解析异常。
2. 路径解析兼容性：Azure Automation的PowerShell 5.1环境中，$PSScriptRoot的路径解析可能和本地存在差异，导致无法定位functions文件夹。
3. 导出语法隐式转换问题：$functions.Basename的成员枚举写法在本地有效，但在Azure Automation环境中可能存在数组转换异常，导致Export-ModuleMember无法正确识别函数名。

解决方案 #

1. 修正压缩包结构 #

确保压缩包顶层是与模块同名的文件夹，所有模块文件都包含在该文件夹内，正确结构示例：

MHZ.Developer.zip
├── MHZ.Developer/
│   ├── MHZ.Developer.psd1
│   ├── MHZ.Developer.psm1
│   ├── functions/
│   │   ├── Get-FooBaa.ps1

2. 优化.psm1加载与导出逻辑 #

添加日志输出用于排查，并显式提取函数名数组：

# 输出路径信息用于排查
Write-Output "PSScriptRoot: $PSScriptRoot"
$functionsDir = Join-Path -Path $PSScriptRoot -ChildPath "functions"
Write-Output "Functions directory: $functionsDir"

# 强制报错以便定位路径问题
$functions = @(Get-ChildItem -Path "$functionsDir\*.ps1" -ErrorAction Stop)
Write-Output "Found function files: $($functions.Name)"

foreach ($import in $functions) {
    try {
        . $import.FullName -ErrorAction Stop
        Write-Output "Successfully imported: $($import.Basename)"
    }
    catch {
        Write-Error -Message "Import failed for $($import.FullName): $_" -ErrorAction Continue
    }
}

# 显式提取函数名数组，避免隐式转换问题
$functionNames = $functions | Select-Object -ExpandProperty Basename
Export-ModuleMember -Function $functionNames

3. 规范.psd1配置（可选） #

虽然Export-ModuleMember已指定导出内容，但显式列出函数名可提升Azure Automation索引兼容性：

FunctionsToExport = @('Get-FooBaa') # 替换为实际函数名列表

4. 测试验证 #

创建测试Runbook，手动导入模块并检查导出命令：

Import-Module MHZ.Developer -Force
Get-Command -Module MHZ.Developer

运行后查看作业日志，确认是否有函数加载失败提示，或是否成功列出目标函数。

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