如何在Azure DevOps Pipeline中安装Hyper-V？安装失败求助

问题描述 #

在Azure DevOps流水线的PowerShell任务中尝试安装Hyper-V时遇到以下问题：

• 执行Get-VM提示“未被识别为cmdlet名称”
• 执行Get-Module -ListAvailable找不到Hyper-V模块，确认Hyper-V未安装
• 使用Windows Server 2019和Windows Server 2022构建代理均失败
• 已尝试的操作均无效：
  • 执行DISM /Online /NoRestart /Enable-Feature /All /FeatureName:Microsoft-Hyper-V /LogLevel:4，运行过程看似正常但最终返回Exit Code 1
  • 执行多条Enable-WindowsOptionalFeature命令：

    Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -NoRestart -All
    Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-Offline -NoRestart
    

  • 执行Import-Module Hyper-V提示找不到模块

解决方案 #

1. 确认构建代理类型 #

如果使用微软托管的构建代理：
微软托管的Windows代理是临时虚拟机，安装Hyper-V后需要重启才能生效，但流水线任务无法在重启后继续执行，且微软托管代理不允许持久化更改。这种情况下，建议改用自托管构建代理，提前在代理机器上预安装Hyper-V并启用。

2. 自托管代理的正确安装步骤 #

使用自托管代理时，需以管理员权限执行以下操作：

步骤1：启用Hyper-V及所有子功能

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All -NoRestart

步骤2：检查安装状态

执行命令确认Hyper-V功能已启用：

Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V

若State显示Enabled，需手动重启代理机器——流水线任务无法自动完成重启，需提前在自托管代理机器上完成重启并验证Hyper-V可用。

步骤3：验证Hyper-V模块

重启后执行以下命令确认模块正常：

Get-Module -ListAvailable Hyper-V
Import-Module Hyper-V
Get-VM

3. 处理DISM Exit Code 1的问题 #

DISM返回Exit Code 1通常因权限不足或系统文件损坏导致：

• 确保PowerShell任务在ADO流水线中勾选Run as administrator（以管理员权限运行）
• 先修复系统文件再尝试安装：

  DISM /Online /Cleanup-Image /RestoreHealth
  sfc /scannow
  DISM /Online /NoRestart /Enable-Feature /All /FeatureName:Microsoft-Hyper-V /LogLevel:4
  

4. 流水线任务注意事项 #

• 若必须在流水线中关联Hyper-V功能，需将自托管代理设置为保留代理，避免每次任务重新创建虚拟机
• 安装Hyper-V后的重启无法在流水线任务中完成，因此建议提前在代理机器上完成Hyper-V的安装、重启及验证，流水线任务直接调用即可

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