部署前如何正确检查已安装的Az PowerShell模块？

问题背景 #

在TeamCity自动部署流程中，原本使用以下PowerShell命令安装Azure模块：

Install-Module -Name Az -Scope CurrentUser -Force
Install-Module -Name Az.ServiceBus -Scope CurrentUser

第一条命令每次执行耗时10-15分钟，移除-Force参数后部署时间明显缩短，但担心未来会引发版本冲突问题。自行编写的条件判断逻辑存在缺陷：若系统中仅存在单个Az子模块（如Az.Accounts），会误判整个Az模块已安装，导致其他必要子模块无法被安装。

解决方案 #

1. 检查Az元模块是否存在 #

Az是一个元模块，它本身是独立模块，安装时会自动包含所有核心Az子模块。因此正确的判断逻辑应该是检查Az元模块是否存在，而非零散的子模块：

# 检查Az元模块是否已安装
if (-not (Get-Module -ListAvailable -Name Az)) {
    Install-Module -Name Az -Scope CurrentUser -Force
}

# 检查Az.ServiceBus子模块是否已安装
if (-not (Get-Module -ListAvailable -Name Az.ServiceBus)) {
    Install-Module -Name Az.ServiceBus -Scope CurrentUser
}

只要Az元模块存在，就说明基础Azure模块环境已就绪，无需重复安装核心组件，同时能确保Az.ServiceBus缺失时自动安装。

2. 可选：指定最低版本要求 #

如果部署流程依赖特定版本的Az模块，可以加入版本校验逻辑，避免因版本过低引发问题：

# 定义需要的Az最低版本
$requiredAzVersion = [version]"9.0.0"
# 获取已安装的最高版本Az模块
$installedAzModule = Get-Module -ListAvailable -Name Az | Sort-Object Version -Descending | Select-Object -First 1

# 若未安装或版本低于要求，则执行安装
if (-not $installedAzModule -or $installedAzModule.Version -lt $requiredAzVersion) {
    Install-Module -Name Az -Scope CurrentUser -RequiredVersion $requiredAzVersion -Force
}

# 检查并安装Az.ServiceBus
if (-not (Get-Module -ListAvailable -Name Az.ServiceBus)) {
    Install-Module -Name Az.ServiceBus -Scope CurrentUser
}

关于-Force参数的说明 #

配合条件判断保留-Force是更稳妥的选择：当模块未安装或版本不符合要求时，-Force会自动覆盖版本冲突提示；若模块已满足要求，命令会直接跳过，不会产生额外耗时。

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