Veeam中Windows虚拟机备份点的文件级恢复按钮置灰

问题说明

来源与分类

• 来源渠道：Veeam对接技术支持群现场案例和内部复现。
• 分类结论：虚拟机元数据配置问题；部分旧版API Proxy批量备份场景可能同时存在兼容问题。
• 确认依据：现场Windows虚拟机在平台中只设置为笼统的Windows操作系统类型时，Veeam无法将新备份点识别为可执行Windows文件级恢复；将操作系统类型调整为与虚拟机实际系统一致的具体版本，例如Windows Server 2019，并重新执行备份后，文件级恢复可以选择。
• 内部追踪：暂无关联Jira。

问题元数据

• 问题编号：暂无。
• 组件/产品：ZSphere、Cloud、Veeam API Proxy、Veeam Backup & Replication。
• 状态：主要场景已有处理方案。
• 优先级/严重程度：一般。
• 已确认环境：Cloud 5.4.8、Veeam 12、API Proxy 1.0.x；ZSphere对接场景也应检查相同的操作系统类型信息。
• 首个修复版本：操作系统类型问题不涉及代码修复；旧版API Proxy批量备份兼容问题由后续1.0.3版本跟进，具体支持范围以对应发布说明为准。
• 问题确认日期：2026-07-06。
• 最后更新时间：2026-09-01。

问题描述

在Veeam中为ZSphere或Cloud上的Windows虚拟机创建备份后，进入备份点的恢复操作时，文件级恢复按钮可能显示为灰色，无法选择。即使源虚拟机实际运行Windows，Veeam也可能没有将该备份点识别为Windows备份。

现场确认的主要原因是平台中的虚拟机操作系统类型只设置为笼统的Windows，或者迁移后的虚拟机没有保留准确的操作系统版本信息。Veeam在生成备份点时会使用平台提供的虚拟机元数据判断客户机类型；操作系统类型不够具体或与实际系统不一致时，备份任务可以成功，但文件级恢复入口可能不会启用。

修改平台中的虚拟机操作系统类型只会影响后续产生的备份点。已有备份点中的客户机识别信息不会自动更新，因此修改后需要重新执行备份，再使用新备份点验证文件级恢复。

此外，Veeam 12配合早期API Proxy版本进行多虚拟机批量备份时，群内曾出现文件级恢复按钮置灰的兼容问题。若操作系统类型已经正确但问题仍然存在，应继续检查API Proxy版本和备份方式。

现象

• Windows虚拟机备份任务可以完成，但在Veeam中选择备份点后，文件级恢复按钮显示为灰色。
• 同一次批量备份中的多个Windows虚拟机均无法选择文件级恢复。
• Veeam没有将备份点识别为Windows客户机，或者恢复界面只允许执行整机、磁盘等其他恢复方式。
• 源虚拟机实际运行Windows，但在ZSphere或Cloud中只设置为Windows，没有选择Windows Server 2019等具体版本。
• 迁移进入平台的Windows虚拟机更容易保留笼统、缺失或不准确的操作系统类型。
• 将操作系统类型调整为实际Windows版本并重新备份后，新备份点可以选择文件级恢复。

现场截图

影响

• 无法通过Veeam恢复备份点中的单个文件或文件夹。
• 用户可能只能采用整机恢复、磁盘恢复或其他恢复方式，增加恢复时间和操作影响。
• 该现象不等于备份任务失败，也不能仅凭按钮置灰判断备份数据已经损坏。
• 修改虚拟机操作系统类型不会修复已有备份点，需要重新备份才能验证。
• Veeam访问客户机网络、客户机凭据等问题可能影响后续文件写回，但与文件级恢复入口是否启用不是同一个阶段的问题。

适用环境

• 产品：ZSphere、ZStack Cloud、Veeam Backup & Replication。
• 产品线：ZVF及Cloud相关Veeam集成场景。
• 组件：虚拟机操作系统元数据、Veeam API Proxy、Veeam文件级恢复。
• 已确认环境：Cloud 5.4.8、Veeam 12、API Proxy 1.0.x。
• 触发条件：平台中的Windows虚拟机操作系统类型过于笼统、缺失或不准确；部分旧版API Proxy多虚拟机批量备份场景也可能触发。

可能原因

该现象可能由以下一种或多种情况导致：