Windows消费计划PowerShell函数发布后Az模块加载失败求助

1. 确保打包过程完整包含Modules目录所有文件 #

VSCode扩展发布时会完整打包wwwroot下的所有内容，但Azure DevOps的打包任务可能因配置问题遗漏模块文件。需调整打包步骤：

• 使用ArchiveFiles任务时，确保rootFolderOrFile指向wwwroot目录，且包含所有子文件：

  - task: ArchiveFiles@2
    displayName: 'Archive wwwroot'
    inputs:
      rootFolderOrFile: '$(Build.SourcesDirectory)/wwwroot'
      includeRootFolder: false
      archiveType: 'zip'
      archiveFile: '$(System.ArtifactsDirectory)/build$(Build.BuildId).zip'
      replaceExistingArchive: true
  

• 避免使用通配符打包（如**/*.zip）时误选其他无关zip包，确保只包含正确的wwwroot打包文件。

2. 调整部署模式或配置模块路径 #

切换部署方法为zipDeploy #

runFromPackage为只读运行模式，可能导致模块加载权限或路径识别问题。将AzureFunctionApp@2任务的deploymentMethod改为zipDeploy：

- task: AzureFunctionApp@2
  displayName: 'Publish Function | package'
  inputs:
    azureSubscription: ${{ parameters.customerServiceConnection }}
    appType: functionApp
    appName: $(functionName)
    package: $(System.ArtifactsDirectory)/build$(Build.BuildId).zip
    deploymentMethod: 'zipDeploy'

显式配置模块路径 #

在host.json中添加PowerShell模块路径配置，明确指定Modules目录位置：

{
  "version": "2.0",
  "powerShell": {
    "modulePath": "./Modules"
  }
}

3. 统一PowerShell Runtime版本 #

确保本地开发、DevOps代理和Function App的PowerShell版本一致：

• 在host.json中指定目标Runtime版本（根据模块兼容性选择，示例为7.2）：

  {
    "version": "2.0",
    "powerShell": {
      "runtimeVersion": "7.2"
    }
  }
  

• 在AzurePowerShell@5任务中指定对应版本，避免使用LatestVersion：

  - task: AzurePowerShell@5
    displayName: 'Publish Function | azpwsh'
    inputs:
      azureSubscription: ${{ parameters.customerServiceConnection }}
      ScriptType: 'InlineScript'
      Inline: 'Publish-AzWebapp -ResourceGroupName $(functionAppRg) -Name $(functionName) -ArchivePath $(System.ArtifactsDirectory)/build$(Build.BuildId).zip -Force'
      azurePowerShellVersion: '7.2'
      pwsh: true
  

4. 手动指定模块导入路径 #

在run.ps1开头显式导入模块并指定完整路径，绕开自动加载的路径问题：

# 导入Az模块
$modulePath = Join-Path $PSScriptRoot "../Modules"
Import-Module (Join-Path $modulePath "Az.Accounts/Az.Accounts.psd1") -Force
Import-Module (Join-Path $modulePath "Az.Resources/Az.Resources.psd1") -Force
Import-Module (Join-Path $modulePath "Az.Compute/Az.Compute.psd1") -Force
Import-Module (Join-Path $modulePath "Az.Sql/Az.Sql.psd1") -Force
Import-Module (Join-Path $modulePath "Az.SqlVirtualMachine/Az.SqlVirtualMachine.psd1") -Force

5. 清理requirements.psd1（若未启用托管依赖） #

由于未启用managedDependency，requirements.psd1可能存在冲突配置，可直接删除该文件，或清空内容，避免干扰模块加载。

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