Azure Image Builder无法识别已存在的Windows 10基础镜像求助

AI 小北

2026-8-11

Azure Image Builder 兼容Windows 10 EVD镜像的问题解决

问题现象

执行Azure资源组部署命令时返回镜像未找到错误：

New-AzResourceGroupDeployment -ResourceGroupName $imageResourceGroup -TemplateFile $templateFilePath -api-version "2019-05-01-preview" -imageTemplateName $imageTemplateName -svclocation $location

错误信息：

Platform Image was not found. location: westus, publisherName: MicrosoftWindowsDesktop, offer: Windows-10, sku: 20h1-evd, version: latest.

模板中源镜像配置如下：

"source": {
    "type": "PlatformImage",
    "publisher": "MicrosoftWindowsDesktop",
    "offer": "Windows-10",
    "sku": "20h1-evd",
    "version": "latest"
  },

排查验证

通过以下命令可正常查询到该镜像存在于westus区域：

Get-AzVMImageSku -Location westus -PublisherName MicrosoftWindowsDesktop -Offer Windows-10

返回结果包含目标SKU：

Skus Offer PublisherName Location Id
...
20h1-evd Windows-10 MicrosoftWindowsDesktop westus /Subscriptions/68fab0aa-ab1e-4e09-a325-46ec73e30541/Providers/Microsoft.Compute/Locations/westus/Publishers/Mi…

相关问题已在GitHub提交数月，当前临时方案为改用Windows 2019-Datacenter作为基础镜像。

可行兼容方案

以下几种方法可尝试让Image Builder兼容Windows 10 EVD镜像：

升级API版本：将部署命令中的api-version从2019-05-01-preview替换为较新的稳定版本（如2022-02-14或更高），旧预览版API可能存在对新SKU的支持缺陷。
指定具体镜像版本：避免使用latest作为版本号，通过Get-AzVMImage -Location westus -PublisherName MicrosoftWindowsDesktop -Offer Windows-10 -Skus 20h1-evd命令获取具体版本号，在模板中替换version字段为该具体值。
通过共享镜像中转：先将Windows 10 EVD平台镜像复制到Azure共享镜像库（Shared Image Gallery），然后在Image Builder模板中将源类型改为SharedImageVersion，引用共享镜像库中的镜像作为基础源。
检查服务权限：确认Azure Image Builder的服务主体拥有访问MicrosoftWindowsDesktop发布者镜像的权限，必要时为其分配Compute Image User角色。