hyper-v存储qos用于防止单vm突发i/o影响其他vm，仅管控csv上vhdx/vhds文件，需群集环境、scsi控制器及powershell配置，支持dedicated/aggregated策略并实时监控。
在 hyper-v（windows server 2016 及以上，含 2022）中配置存储 qos，核心目标是防止某台虚拟机因突发 i/o 占用全部共享存储带宽，影响其他 vm。它不作用于直通磁盘或来宾内 iscsi，只管控 vhdx/vhds/vhd set 文件的 i/o 流量。实际操作分两类场景，关键区别在于是否使用故障转移群集和 csv 存储。
确认前提条件
Storage QoS 依赖 Windows 故障转移群集服务，不是单机功能：
- 必须部署为群集环境（至少两节点），且所有节点运行 Windows Server 2016 或更新版本；
- 存储需为群集共享卷（CSV），常见于 S2D、Scale-Out File Server（SOFS）或传统 SAN CSV；
- Hyper-V 角色已安装，VM 使用 SCSI 控制器挂载 VHDX（IDE 不支持 QoS）；
- 所有操作通过 PowerShell 完成，GUI 无原生界面支持。
创建并绑定存储 QoS 策略（推荐集群方式）
这是生产环境的标准做法，便于集中管理与策略复用：
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 用 New-StorageQosPolicy 创建策略，指定类型（Dedicated 或 Aggregated）、最小/最大 IOPS 和带宽（可选）：
New-StorageQosPolicy -Name "GoldTier" -PolicyType Dedicated -MinimumIops 500 -MaximumIops 2000 -MaximumBandwidth 100MB - Dedicated 策略为每个 VHDX 单独保障资源；Aggregated 策略让多个 VHDX 共享同一组上限（适合租户级配额）；
- 用 Get-StorageQosPolicy 查看策略 ID，再通过 Set-VMHardDiskDrive 绑定到具体虚拟硬盘：
Get-VM "DB-01" | Get-VMHardDiskDrive | Set-VMHardDiskDrive -PolicyId (Get-StorageQosPolicy -Name "GoldTier").PolicyId - 绑定后，策略即时生效，无需重启 VM。
验证与实时监控
策略上线后必须验证是否按预期执行：
- 运行 Get-StorageQoSFlow 查看实时流控数据，重点关注：
– InitiatorName（VM 名）、FilePath（对应 VHDX 路径）
– InitiatorIOPS / StorageNodeIOPS（当前实际 I/O）
– Status（是否受限，如 “Throttled” 表示已达上限） - 加排序和筛选更直观：
Get-StorageQosFlow | Where-Object {$_.Status -eq "Throttled"} | Sort-Object StorageNodeIOPS -Descending | ft InitiatorName, FilePath, StorageNodeIOPS, Status - 配合 PerfMon 监控 “Hyper-V Virtual Storage Device\Avg. sec/Read”、“Avg. sec/Write”，确认延迟是否回落至合理区间（如
注意事项与避坑点
几个容易出错但文档常忽略的关键细节：
- IOPS 归一化单位默认为 8KB 块大小，若业务以 64KB 大块为主，实际 IOPS 数值会显著降低（同吞吐下 IOPS = 吞吐 ÷ 块大小），设限时需换算；
- 策略仅对启用了 CSV 的 VHDX 生效；本地存储（非 CSV）或非群集 VM 的 VHDX 不受控；
- MinimumIOPS 是“保障型预留”，不是“强制最低”，仅当存储整体空闲且该 VM 有请求时才兑现；
- 若 VM 迁移后 QoS 异常，检查目标节点是否加入同一群集、CSV 是否在线、策略是否已在该节点同步（通常自动，但偶有缓存延迟）。
