Azure Function导入AzureAD模块失败：代理生成错误求助

算力阿峰

2026-8-19

解决Azure Function中导入AzureAD模块的代理生成错误

问题场景

在Azure Function的PowerShell脚本中执行以下代码导入AzureAD模块：

Import-Module AzureAD -UseWindowsPowerShell

同时已在requirements.psd1中添加模块版本配置：

'AzureAD' = '2.*'

运行函数时触发错误：

ERROR: Failed to generate proxies for remote module 'AzureAD'. The -OutputModule parameter does not resolve to a path, and a user module path cannot be found for the provided name.

对应的中文异常详情：

Exception :
Type : System.InvalidOperationException
Message : 无法为远程模块'AzureAD'生成代理。-OutputModule参数无法解析为路径，且找不到与提供名称匹配的用户模块路径。
InnerException :
Type : System.Management.Automation.CmdletInvocationException
ErrorRecord :
Exception :
Type : System.ArgumentException
Message : -OutputModule参数无法解析为路径，且找不到与提供名称匹配的用户模块路径。
TargetSite :
Name : ThrowTerminatingError
DeclaringType : System.Management.Automation.MshCommandRuntime, System.Management.Automation, Version=7.2.4.500, Culture=neutral, PublicKeyToken=31bf3856ad364e35
MemberType : Method
Module : System.Management.Automation.dll
Source : System.Management.Automation
HResult : -2147024809
StackTrace :
at System.Management.Automation.MshCommandRuntime.ThrowTerminatingError(ErrorRecord errorRecord)
TargetObject : Microsoft.PowerShell.Commands.ExportPSSessionCommand
CategoryInfo : InvalidArgument: (Microsoft.PowerShel…ortPSSessionCommand:ExportPSSessionCommand) [Export-PSSession], ArgumentException
FullyQualifiedErrorId : ExportPSSession_ErrorModuleNameOrPath,Microsoft.PowerShell.Commands.ExportPSSessionCommand
InvocationInfo :
MyCommand : Export-PSSession
HistoryId : 1
InvocationName : Export-PSSession
CommandOrigin : Internal
ScriptStackTrace : at , C:\home\site\wwwroot\TimerTrigger1\run.ps1: line 3
TargetSite :
Name : Invoke
DeclaringType : System.Management.Automation.Runspaces.PipelineBase, System.Management.Automation, Version=7.2.4.500, Culture=neutral, PublicKeyToken=31bf3856ad364e35
MemberType : Method
Module : System.Management.Automation.dll
Message : -OutputModule参数无法解析为路径，且找不到与提供名称匹配的用户模块路径。
InnerException :
Type : System.ArgumentException
Message : -OutputModule参数无法解析为路径，且找不到与提供名称匹配的用户模块路径。
TargetSite :
Name : ThrowTerminatingError
DeclaringType : System.Management.Automation.MshCommandRuntime, System.Management.Automation, Version=7.2.4.500, Culture=neutral, PublicKeyToken=31bf3856ad364e35
MemberType : Method
Module : System.Management.Automation.dll
Source : System.Management.Automation
HResult : -2147024809
StackTrace :
at System.Management.Automation.MshCommandRuntime.ThrowTerminatingError(ErrorRecord errorRecord)
Source : System.Management.Automation
HResult : -2146233087
StackTrace :
at System.Management.Automation.Runspaces.PipelineBase.Invoke(IEnumerable input)
at System.Management.Automation.Runspaces.Pipeline.Invoke()
at System.Management.Automation.PowerShell.Worker.ConstructPipelineAndDoWork(Runspace rs, Boolean performSyncInvoke)
at System.Management.Automation.PowerShell.CoreInvokeHelper[TInput,TOutput](PSDataCollection1 input, PSDataCollection1 output, PSInvocationSettings settings)
at System.Management.Automation.PowerShell.CoreInvoke[TInput,TOutput](PSDataCollection1 input, PSDataCollection1 output, PSInvocationSettings settings)
at System.Management.Automation.RemoteDiscoveryHelper.InvokeNestedPowerShell(PowerShell powerShell, PSCmdlet cmdlet, PSInvocationSettings invocationSettings, String errorMessageTemplate, CancellationToken cancellationToken)+MoveNext()
at System.Management.Automation.RemoteDiscoveryHelper.EnumerateWithCatch[T](IEnumerable1 enumerable, Action1 exceptionHandler)+MoveNext()
HResult : -2146233079
CategoryInfo : NotSpecified: (:) [Import-Module], InvalidOperationException
FullyQualifiedErrorId :

原因分析

Azure Functions的PowerShell运行时基于PowerShell 7，-UseWindowsPowerShell参数会尝试在Windows PowerShell会话中导入模块，并生成代理模块映射到PS7环境。但Functions沙箱的权限限制和默认模块路径配置问题，导致系统无法找到或创建代理模块的存储路径，从而抛出错误。

解决方案

方案1：改用PowerShell 7兼容模块（推荐）

传统AzureAD模块已进入维护模式，官方更推荐使用Microsoft Graph PowerShell模块（完全支持PS7），或使用支持PS7的AzureADPreview模块。

更新requirements.psd1配置：

# 若选择Microsoft Graph（优先推荐）
'Microsoft.Graph' = '2.*'
# 若需兼容AzureAD原有逻辑，选择AzureADPreview
'AzureADPreview' = '2.*'

修改脚本中的导入代码：

对于Microsoft Graph：

Import-Module Microsoft.Graph
# 按需加载所需模块子集，例如用户管理模块
Select-MgProfile -Name v1.0
Import-Module Microsoft.Graph.Users

对于AzureADPreview：

Import-Module AzureADPreview

方案2：手动指定代理模块输出路径

如果必须使用传统AzureAD模块，可手动指定代理模块的输出路径到Functions有权限写入的临时目录：

$proxyModulePath = Join-Path $env:TEMP 'AzureADProxy'
New-Item -Path $proxyModulePath -ItemType Directory -Force | Out-Null

修改导入命令，指定输出路径：

Import-Module AzureAD -UseWindowsPowerShell -OutputModule $proxyModulePath

方案3：检查运行时配置

确认Function App的FUNCTIONS_WORKER_RUNTIME_VERSION配置为~7（对应PowerShell 7.x版本），避免版本冲突。
确保requirements.psd1文件放置在Function App的根目录（wwwroot文件夹下），而非单个函数的目录中。

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