Azure DevOps运行AzurePowerShell@5任务时遇版本转换错误

错误原因 #

任务尝试加载版本为null的Az模块，触发类型转换失败，导致无法找到模块路径。这通常是因为任务的Azure PowerShell版本参数未正确配置。

解决方案 #

• 检查任务版本配置
  打开流水线中的AzurePowerShell@5任务，找到「Azure PowerShell Version」选项：

  • 不要留空或设置为null，选择「Latest installed」（使用代理上已安装的最新版本），或指定明确的版本号（如10.2.0）。
  • 若用YAML定义流水线，确保azurePowerShellVersion字段值有效，示例：

    - task: AzurePowerShell@5
      inputs:
        azureSubscription: '你的订阅名称'
        ScriptType: 'FilePath'
        ScriptPath: 'scripts/deploy.ps1'
        azurePowerShellVersion: 'LatestVersion' # 或具体版本号
    

• 排查自定义脚本中的版本参数
  如果脚本中手动指定Az模块版本，确保不要传递$null值，避免类似Install-Module Az -Version $null的错误代码。

• 自托管代理的备选处理
  若使用自托管代理，手动安装Az模块到代理机器：

  1. 在代理机器上运行Install-Module Az -Force -AllowClobber安装最新版本
  2. 运行Get-Module -ListAvailable Az确认安装的版本
  3. 在任务中指定该已安装的版本号，跳过动态下载步骤

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