在AWS Lambda的.NET运行时中执行PowerShell的Install-Module遇阻求助

问题背景 #

在AWS Lambda的.NET Core 3.1（C#/PowerShell）运行时中执行PowerShell脚本时遇到以下问题：

• 执行Install-Module ExchangeOnlineManagement报错：[Error] - The term 'Install-Module' is not recognized as the name of a cmdlet, function, script file, or operable program.
• 尝试在项目/lambda_code目录下添加/modules文件夹并放入目标模块后，导入仍报错：[Error] - The specified module 'ExchangeOnlineManagement' was not loaded because no valid module file was found in any module directory.
• 查看PSModulePath输出为：/tmp/765bd878-da6c-4275-a378-78de284fb3e3/.local/share/powershell/Modules:/usr/local/share/powershell/Modules:/var/task/Modules
• 手动指定路径执行Import-Module –Name \modules\ExchangeOnlineManagement -Verbose，依旧报模块找不到的错误

PowerShell版本信息：

Name                           Value
----                           -----
PSVersion                      7.0.0
PSEdition                      Core
GitCommitId                    7.0.0
OS                             Linux 4.14.255-276-224.499.amzn2.x86_64 #1 SMP Tue May 3 22:30:10 UTC 2022
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

核心原因 #

1. Install-Module不可用：AWS Lambda的PowerShell运行时默认未包含PowerShellGet模块（Install-Module属于该模块），且Lambda是临时无服务器环境，无法在线安装模块。
2. 模块路径不符合规则：PowerShell加载模块时会从PSModulePath指定的目录查找，每个模块必须放在对应目录下的同名子文件夹中，且文件夹内要有合法的模块文件（如.psm1或.psd1）。

解决步骤 #

1. 本地导出目标模块 #

在本地PowerShell环境中，执行命令下载并导出ExchangeOnlineManagement模块到指定目录：

Save-Module -Name ExchangeOnlineManagement -Path ./modules

执行后，./modules目录下会生成ExchangeOnlineManagement子文件夹，包含该模块的所有文件。

2. 调整项目目录结构 #

根据PSModulePath输出，/var/task/Modules是部署包中可被识别的模块目录，调整项目结构如下：

• 在Lambda项目根目录（对应部署后的/var/task）下创建Modules文件夹
• 将本地导出的ExchangeOnlineManagement完整子文件夹复制到./Modules目录下
• 最终项目结构示例：

  lambda_code/
  ├── 你的脚本文件.ps1
  └── Modules/
      └── ExchangeOnlineManagement/
          ├── ExchangeOnlineManagement.psd1
          ├── ExchangeOnlineManagement.psm1
          └── ...（其他模块相关文件）
  

3. 正确导入模块 #

在PowerShell脚本中直接使用模块名导入即可，无需指定路径：

Import-Module ExchangeOnlineManagement -Verbose

可添加日志验证模块是否加载成功：

Get-Module ExchangeOnlineManagement | Write-Host

4. 部署时的注意事项 #

通过Terraform和GitLab CI部署时，确保Modules目录被包含在部署包中，检查.gitignore规则，避免该目录被排除。

额外说明 #

• Lambda的/tmp目录是临时存储，函数重启后会清空，不要将模块放在该目录下
• PowerShell 7.0.0对模块存在兼容性要求，可在Save-Module时通过-RequiredVersion参数指定兼容的模块版本

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