部署PS脚本安装Az模块8.0.0时出现模块未找到错误的求助

问题场景 #

执行以下PowerShell脚本作为YAML部署任务时，出现导入失败错误：

指定的版本为8.0.0的Az模块未加载，因为在任何模块目录中都未找到有效的模块文件

执行的脚本：

Install-Module Az -RequiredVersion 8.0.0 -Scope CurrentUser -Force -AllowClobber
Import-Module Az -RequiredVersion 8.0.0 -Force

遗漏的配置/步骤 #

• 未信任PowerShell Gallery源：默认PSGallery处于未信任状态，Install-Module可能因安全限制静默失败，需先执行：

  Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
  

• 用户范围与权限不匹配：如果部署使用系统级账户（如CI/CD代理账户），Scope CurrentUser的模块路径对该账户不可见，建议改为Scope AllUsers（需管理员权限），或确认当前用户对CurrentUser模块目录（$HOME\Documents\WindowsPowerShell\Modules）有读写权限。
• 未刷新模块路径缓存：模块安装后PowerShell可能未实时更新模块路径，可在导入前强制扫描可用模块，或手动添加路径：

  # 强制扫描模块
  Get-Module -ListAvailable Az
  # 手动添加CurrentUser模块路径（按需）
  $env:PSModulePath += ";$HOME\Documents\WindowsPowerShell\Modules"
  

• 依赖模块版本不足：Az 8.0.0对PowerShellGet、PackageManagement有版本要求，需先更新依赖：

  Install-Module -Name PowerShellGet -Force -AllowClobber
  

• PowerShell版本环境不匹配：Az 8.0.0支持PowerShell 5.1及7+，但PS5.1与PS7的模块目录相互独立。如果YAML任务用的是powershell（PS5.1），但安装时用的是pwsh（PS7），会导致模块找不到，需确保任务使用的PowerShell版本与安装命令一致。

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