咨询：如何获取数字格式VMSS实例ID以移除Custom Script Extension

问题原因 #

当你的VMSS采用灵活编排模式时，Get-AzVmssVM返回的InstanceId是字母数字的GUID格式，但Get-AzVmssVM（带-InstanceView参数）和Remove-AzVmssVMExtension的-InstanceId参数仅接受数字序号格式的实例ID（如0、1、2），这就导致了执行失败。

解决方案 #

从VMSS实例的资源ID或名称中提取数字序号ID，以下是两种可靠的提取方式：

方法1：从实例资源ID提取（推荐，不受命名规则影响） #

实例的Id属性是完整的Azure资源路径，最后一段格式为{VMSS名称}_{数字序号}，通过分割字符串即可提取数字：

$numericInstanceId = ($instance.Id -split '/')[-1] -replace "^$VMScaleSetName_"

方法2：从实例名称提取（适用于默认命名规则） #

灵活模式VMSS的默认实例名称格式为{VMSS名称}_{数字序号}，通过下划线分割即可提取：

$numericInstanceId = ($instance.Name -split '_')[-1]

修改后的完整代码 #

# Input Parameters
$ResourceGroupName = "MyResourceGroup" # 替换为你的资源组名称
$VMScaleSetName = "MyVMSS"            # 替换为你的VMSS名称
$ExtensionName = "CustomScriptExtension" # 替换为要移除的扩展名称

# 获取所有VMSS实例
$instances = Get-AzVmssVM -ResourceGroupName $ResourceGroupName -VMScaleSetName $VMScaleSetName

# 遍历每个实例
foreach ($instance in $instances) {
    # 提取数字格式的InstanceId（从资源ID路径提取）
    $numericInstanceId = ($instance.Id -split '/')[-1] -replace "^$VMScaleSetName_"
    $alphanumericInstanceId = $instance.InstanceId
    $InstanceName = $instance.Name

    Write-Output "处理实例：数字ID=$numericInstanceId，字母数字ID=$alphanumericInstanceId，实例名称=$InstanceName"

    try {
        # 使用数字ID获取实例视图
        $instanceView = Get-AzVmssVM -ResourceGroupName $ResourceGroupName -VMScaleSetName $VMScaleSetName -InstanceId $numericInstanceId -InstanceView
        $extensionExists = $instanceView.Extensions | Where-Object { $_.Name -eq $ExtensionName }

        if ($extensionExists) {
            Write-Output "正在从实例 $numericInstanceId 移除扩展 '$ExtensionName'"
            # 移除扩展时同样使用数字ID
            Remove-AzVmssVMExtension -ResourceGroupName $ResourceGroupName -VMScaleSetName $VMScaleSetName -InstanceId $numericInstanceId -Name $ExtensionName -Force
            Write-Output "扩展 '$ExtensionName' 已成功从实例 $numericInstanceId 移除"
        } else {
            Write-Output "实例 $numericInstanceId 上未找到扩展 '$ExtensionName'"
        }
    } catch {
        Write-Output "处理实例 $numericInstanceId 时出错：$_"
    }

    Write-Output "--------------------------------------------"
}

补充说明 #

• 灵活模式VMSS的数字序号ID是Azure内部用于标识实例的唯一数字标识，所有要求数字InstanceId的Az PowerShell cmdlet都必须使用这个ID。
• 从资源ID提取的方式更可靠，因为实例名称可能被自定义修改，但资源ID的格式始终符合Azure规范。

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