PowerShell自动化AKS集群版本升级报错求助

问题场景 #

我是PowerShell新手，尝试用Azure PowerShell实现AKS集群版本自动化升级，流程为：获取集群当前版本→查询可用非预览版本→逐个升级。但运行代码时遇到错误，无法完成升级。

错误信息 #

Cannot convert 'System.Object[]' to the type 'System.String' required by parameter 'KubernetesVersion'. Specified method is not supported. ---> System.NotSupportedException: Specified method is not supported.

错误原因 #

1. 参数类型不匹配：$Versions是包含多个版本号的数组（如输出中的1.24.3 1.24.6），但Set-AzAksCluster的-KubernetesVersion参数仅接受单个字符串类型的版本号，直接传数组会触发类型转换错误。
2. 缺少版本顺序控制：AKS升级需遵循「最多跨一个次要版本」的规则，必须按版本号从低到高逐个升级，原代码未对可用版本排序，也没有等待上一次升级完成的逻辑。

修正后的完整代码 #

Param 
(    
    [Parameter(Mandatory=$true)]
    [String] 
    $AKSName
)

Connect-AzAccount -Identity > $null
Set-AzContext -SubscriptionId "id" > $null

# 一次性获取AKS资源信息，减少API调用次数
$aksResource = Get-AzResource -Name $AKSName
$AKsResourceGroup = $aksResource.ResourceGroupName
$AKsLocation = $aksResource.Location

# 获取集群当前Kubernetes版本
$CurrentVersion = (Get-AzAksCluster -ResourceGroupName $AKsResourceGroup -Name $AKSName -WarningAction Ignore).KubernetesVersion
Write-Host "当前集群版本: $CurrentVersion"

# 查询可用非预览升级版本，并按版本号升序排序
$availableVersions = Get-AzAksVersion -Location $AKsLocation -WarningAction Ignore | 
    Where-Object { $_.OrchestratorVersion -gt $CurrentVersion -and !$_.IsPreview } | 
    Select-Object -ExpandProperty OrchestratorVersion |
    Sort-Object { [version]$_ }

# 检查是否有可用升级版本
if (-not $availableVersions) {
    Write-Host "没有可用的非预览升级版本"
    exit 0
}

Write-Host "可用的升级版本（按顺序）: $($availableVersions -join ', ')"

# 逐个执行版本升级
foreach ($version in $availableVersions) {
    Write-Host "开始升级到版本: $version"
    # 触发升级操作
    Set-AzAksCluster -ResourceGroupName $AKsResourceGroup -Name $AKSName -KubernetesVersion $version -WarningAction Ignore
    
    # 轮询等待升级完成，避免异步操作导致的冲突
    do {
        Start-Sleep -Seconds 30
        $clusterStatus = (Get-AzAksCluster -ResourceGroupName $AKsResourceGroup -Name $AKSName).ProvisioningState
        Write-Host "当前升级状态: $clusterStatus"
    } while ($clusterStatus -ne 'Succeeded')

    Write-Host "已成功升级到版本: $version`n"
}

# 输出升级完成后的最终集群状态
Write-Host "=== 升级完成，最终集群状态 ==="
Get-AzAksCluster -ResourceGroupName $AKsResourceGroup -Name $AKSName | 
    Format-Table -Property Name, Location, KubernetesVersion, ProvisioningState -AutoSize

关键修改说明 #

• 优化API调用：合并Get-AzResource调用，减少不必要的Azure API请求，提升脚本效率
• 版本排序：通过Sort-Object { [version]$_ }将可用版本按语义化版本号升序排列，确保符合AKS跨版本升级规则
• 数组拆分处理：用foreach循环遍历每个版本，给Set-AzAksCluster传入单个版本字符串，解决类型不匹配问题
• 升级等待逻辑：增加轮询判断，直到集群ProvisioningState变为Succeeded再进行下一次升级，避免异步操作冲突
• 状态可视化：添加Write-Host输出，让升级过程的状态和进度更清晰

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