Linux Azure App Service执行Install-Module报错：命令未被识别

问题描述 #

部署在Azure App Service Linux版的ASP.NET Core Web应用中，执行PowerShell脚本安装ExchangeOnlineManagement模块时，报错：

"The term 'Install-Module' is not recognized as a name of a cmdlet, function, script file, or executable program"
脚本运行的PowerShell版本为7.3.6，执行代码如下：

var scriptContents = "if(-not (Get-Module ExchangeOnlineManagement -ListAvailable))" + Environment.NewLine +
                    "{ " + Environment.NewLine +
                        "Write-Host $PSVersionTable.PSVersion" + Environment.NewLine +
                        "Install-Module ExchangeOnlineManagement -Scope CurrentUser -Force" + Environment.NewLine +
                    "}";
            
using (PowerShell ps = PowerShell.Create())
{
    ps.AddScript(scriptContents);
    var pipelineObjects = await ps.InvokeAsync().ConfigureAwait(false);
}

原因分析 #

Install-Module是PowerShellGet模块下的命令，Azure App Service Linux环境默认未预装PowerShellGet，且运行环境存在权限限制，无法通过在线方式将模块安装到CurrentUser作用域。

解决方案 #

1. 离线部署ExchangeOnlineManagement模块（推荐） #

该方案彻底规避环境限制，是最稳定的解决方式：

• 在本地PowerShell中执行命令，下载模块到本地目录：

  Save-Module -Name ExchangeOnlineManagement -Path ./PowerShellModules
  

• 将下载的ExchangeOnlineManagement文件夹复制到ASP.NET Core项目的根目录（或指定子目录）
• 修改PowerShell脚本，直接导入本地模块，跳过安装步骤：

  # 导入本地模块（路径根据实际存放位置调整）
  Import-Module ./PowerShellModules/ExchangeOnlineManagement -Force
  # 后续执行Exchange连接及操作
  Connect-ExchangeOnline -Credential $yourCredential
  $mailboxes = Get-EXOMailbox
  

• 更新C#代码中的scriptContents内容，替换为上述脚本。

2. 尝试导入PowerShellGet模块（仅环境预装时有效） #

若环境已存在PowerShellGet模块，可在脚本开头添加导入命令：

Import-Module PowerShellGet -Force
# 再执行原安装逻辑
if(-not (Get-Module ExchangeOnlineManagement -ListAvailable))
{
    Install-Module ExchangeOnlineManagement -Scope CurrentUser -Force
}

但该方案在Azure App Service Linux环境中大概率因权限或模块缺失失败，不推荐作为主要方案。

注意事项 #

• Azure App Service Linux的运行环境无持久化存储，重启应用后在线安装的模块会丢失，因此离线部署是唯一稳定的方式。
• 确保下载的模块版本与PowerShell 7.3.6兼容，可通过-RequiredVersion参数指定对应版本。

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