在Azure DevOps发布管道运行Azure PowerShell命令报错的解决咨询

我之前在Azure DevOps发布管道里也碰到过一模一样的问题，本质是托管代理环境里缺少对应的Az模块或者任务配置没到位，给你几个靠谱的解决步骤：

1. 检查Azure PowerShell任务的版本配置 #

托管代理默认可能没有预装所有Az模块，尤其是旧版本的任务。你可以这么做：

• 打开你的发布管道，找到那个报错的Inline Azure PowerShell任务
• 在任务配置面板里，找到Azure PowerShell version选项，选择Latest installed version（优先推荐，会自动用代理上最新的Az版本，通常包含Az.KeyVault模块）
• 如果需要指定版本，确保选的版本是Az 5.0及以上，这些版本都包含Az.KeyVault模块

2. 手动在脚本中安装Az.KeyVault模块 #

如果上面的方法还是不行，你可以在Inline脚本的开头先手动安装模块——因为托管代理每次运行都是全新环境，所以每次都需要执行这段：

# 先信任PSGallery仓库
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
# 安装Az.KeyVault模块
Install-Module -Name Az.KeyVault -Force -AllowClobber -Scope CurrentUser

这段命令会强制安装最新版本的Az.KeyVault模块，-Scope CurrentUser是为了避免需要管理员权限（托管代理的用户权限有限）。

3. 确认Azure连接类型正确 #

别小看这个细节：

• 在任务配置的Azure Connection Type里，一定要选Azure Resource Manager，而不是旧的Classic类型
• 因为Get-AzKeyVaultSecret是Az模块（针对ARM）的命令，旧的AzureRM模块或者Classic连接环境里是识别不了这个命令的

额外小提示 #

如果你不想每次都安装模块，也可以考虑用自托管代理，自己提前装好所有需要的Az模块，这样每次运行管道就不用重复安装了，不过托管代理的优势是不用维护，看你的需求选择就行。

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