VMware Horizon Extras Bundle 详解：USB重定向与PCoIP外设配置指南

简介：VMware-Horizon-Extras-Bundle-5.1.0-13920927.zip 是面向 VMware Horizon 桌面虚拟化平台运维人员与 IT 管理员的组策略扩展组件包，用于集中配置和优化 Horizon 环境中的远程显示、客户端接入与用户资料管理。包内共 183 个文件，以 159 个 adml 语言文件和 19 个 admx 策略模板为主，另含 4 个 dll 与 1 个 xml，压缩包约 5.31MB。其中 admx 模板覆盖 PCoIP 与 Blast Extreme 显示协议调优、Horizon Client 与 Agent 策略、View Persona Management 用户个性化同步、虚拟串口与扫描设备支持、直接连接配置等模块，adml 则提供对应多语言界面文本。借助这些模板，管理员可在组策略中统一调整带宽限制、图像质量、安全选项与代理服务参数，按组织网络条件定制性能与安全性。目前已有 805 人学习下载，适合需要系统掌握 Horizon 策略配置、排查远程桌面体验问题的中高级运维人员参考使用。

1. VMware-Horizon-Extras-Bundle 到底是什么：从 pcoip 到 USB 重定向的最后一公里

很多人第一次看到VMware-Horizon-Extras-Bundle-5.1.0-13920927.zip这个文件名，会以为它是 Horizon 连接服务器的补丁包，或者跟vmware workstation那种本地虚拟机安装包是一回事。实际不是。这个 Bundle 是 Horizon Agent 的“外挂能力合集”，专门补上标准 Agent 安装包里没带的那部分组件——最典型的就是PCoIP 智能卡、USB 重定向、扫描仪重定向、串并口重定向、Flash 优化、HTML5 多媒体重定向这些需要单独授权或单独分发的模块。换句话说，标准 Agent 让你能连上虚拟桌面，Extras Bundle 让你连上之后还能插 U 盘、刷工牌、接扫描枪、用高拍仪。

它解决的是“虚拟桌面看着能用、一到外设就翻车”的问题。适合谁？适合正在做 Horizon 桌面交付、被用户投诉“U 盘不认”“扫描仪不出图”“智能卡读卡器没反应”的运维和集成工程师。文件名里的13920927是构建号，5.1.0对应 Horizon 7.x 时代的 Extras 版本线，这个包不会随 Horizon 连接服务器版本自动升级，需要你手动匹配 Agent 版本。下面按“先搞清组件构成 → 再动手装 → 再排坑 → 最后做验证”的顺序讲透。

2. Extras Bundle 里到底装了什么：组件清单与版本匹配逻辑

2.1 五个核心组件与它们各自负责的外设

Extras Bundle 解压后通常是一个 MSI 集合，不是单个安装程序。你需要先搞清楚每个 MSI 对应什么能力，再决定装哪几个。装多了会拖慢 Agent 启动，装错了会跟系统里已有的驱动打架。

提示：不是所有组件都随 5.1.0 这个构建号一起发布，具体以解压后目录里实际存在的 MSI 为准。不要凭记忆去网上找单个 MSI 拼凑，版本错配比不装还麻烦。

2.2 版本匹配：为什么不能拿 5.1.0 的 Extras 配 8.x 的 Agent

Horizon Agent 和 Extras Bundle 之间有一条隐形的版本对齐规则：Extras 的主版本号必须与 Agent 的主版本号在同一代。5.1.0 的 Extras 是为 Horizon 7.5 到 7.8 这一段的 Agent 准备的。如果你把它装到 Horizon 8 的 Agent 上，最典型的现象是 USB 重定向服务能启动，但设备枚举失败，事件日志里出现VMware USB Arbitration Service反复重启。

匹配逻辑可以这样记：

• 先确认虚拟桌面里已安装的 Agent 版本，在注册表HKLM\SOFTWARE\VMware, Inc.\VMware VDM\Agent下看Version和BuildNumber。
• 再确认 Extras Bundle 文件名里的构建号是否落在该 Agent 版本的兼容列表内。VMware 的兼容矩阵通常按 Horizon 大版本给出，5.1.0 对应的是 7.x 后期。
• 如果 Agent 是 8.x，不要用这个包，去找对应 8.x 的 Extras 版本。硬装的结果是外设时好时坏，属于玄学故障，排起来极其痛苦。

2.3 安装前必须确认的三个前置条件

在动手之前，先把这三件事查清楚，否则后面每一步都可能白做。

第一，确认虚拟桌面模板里已经装了对应版本的 Horizon Agent，并且 Agent 安装时勾选了“PCoIP 智能卡”或“USB 重定向”相关选项。如果 Agent 本身没带基础框架，Extras 装上去也没有宿主。

第二，确认客户端侧（瘦客户机或本地 PC）的 Horizon Client 版本与 Agent 版本匹配。PCoIP 外设重定向是两端协商的结果，客户端太老或太新都会导致重定向通道建不起来。

第三，确认你用的是 PCoIP 还是 Blast 协议。Extras Bundle 里很多组件是 PCoIP 专用的，如果你环境已经切到 Blast，USB 重定向要走 Blast 自己的策略，装 PCoIP Extras 不会生效。这一点在混合协议环境里最容易搞混。

3. 在黄金模板里静默安装 Extras Bundle：命令、参数与验证

3.1 解压与组件选择：先看清楚再装

拿到 zip 之后不要直接双击。先在模板虚拟机里解压到一个固定路径，比如C:\ExtrasBundle，然后列出所有 MSI，确认哪些是你真正需要的。

# 在模板虚拟机中以管理员身份打开 PowerShell Expand-Archive -Path "D:\Install\VMware-Horizon-Extras-Bundle-5.1.0-13920927.zip" -DestinationPath "C:\ExtrasBundle" -Force Get-ChildItem "C:\ExtrasBundle" -Filter *.msi | Select-Object Name, Length

这段命令做两件事：解压到本地固定目录，然后列出所有 MSI 文件名和大小。-Force用于覆盖已有解压结果，避免残留旧文件。列出文件名后，对照第 2 章的组件表，只挑你环境里需要的那几个。不要图省事全装，Flash 重定向和串口重定向在不需要的环境里就是纯负担。

3.2 静默安装命令与关键参数

Horizon Extras 的 MSI 支持标准 Windows Installer 静默参数。下面以 USB 重定向和 PCoIP 客户端扩展为例，给出可复用的安装命令。

# 安装 PCoIP 客户端扩展（含智能卡、扫描仪基础支持） msiexec /i "C:\ExtrasBundle\VMware-Horizon-PCoIP-Client-Extensions-5.1.0-13920927.msi" /qn /norestart /l*v "C:\ExtrasBundle\install-pcoip.log" # 安装 USB 重定向组件 msiexec /i "C:\ExtrasBundle\VMware-Horizon-USB-Redirection-5.1.0-13920927.msi" /qn /norestart /l*v "C:\ExtrasBundle\install-usb.log" # 安装扫描仪重定向组件 msiexec /i "C:\ExtrasBundle\VMware-Horizon-Scanner-Redirection-5.1.0-13920927.msi" /qn /norestart /l*v "C:\ExtrasBundle\install-scanner.log"

参数说明：/qn表示完全静默、不弹任何界面；/norestart阻止安装程序自动重启，方便你在模板里连续装多个组件后统一重启；/l*v输出详细日志，排错时第一时间看这个文件。日志路径建议放在同一个目录，方便打包进模板前清理。

注意：安装顺序建议先装 PCoIP Client Extensions，再装 USB 和 Scanner。因为后两者依赖前者提供的基础重定向框架。顺序反了不一定报错，但可能出现服务注册不全。

3.3 安装后验证：服务、驱动与注册表三处确认

装完不要直接关模板。按下面三步确认组件真正落地了。

第一步，查服务状态。USB 重定向依赖VMware USB Arbitration Service，PCoIP 扩展会注册VMware Horizon PCoIP Client Extensions相关服务。

Get-Service | Where-Object { $_.DisplayName -like "*VMware*" -or $_.DisplayName -like "*Horizon*" } | Select-Object DisplayName, Status, StartType

第二步，查驱动。扫描仪和串口重定向会安装虚拟驱动，在设备管理器里应该能看到对应类别的虚拟设备，即使物理设备还没插。

第三步，查注册表。Extras 组件安装后会在HKLM\SOFTWARE\VMware, Inc.\VMware VDM\Agent\下写入子键，比如USB、Scanner。如果这些子键不存在，说明 MSI 没有真正执行成功，回去看install-*.log里的Return value 3错误。

3.4 模板封装前的清理与快照

验证通过后，把安装日志和C:\ExtrasBundle临时目录清掉，然后关闭模板、拍快照。清理命令：

Remove-Item "C:\ExtrasBundle" -Recurse -Force

这一步是为了避免日志文件被批量克隆到所有虚拟桌面，既占空间又可能泄露路径信息。快照命名建议带上 Extras 版本号，比如Template-Base-Agent7.8-Extras5.1.0，以后回滚时一眼能认出。

4. 外设重定向的避坑与排查：五条血泪经验

4.1 U 盘在宿主机识别、桌面里死活不出现

现象：用户插 U 盘，瘦客户机或本地系统弹出盘符，但 Horizon 虚拟桌面里“此电脑”没有任何新设备。

原因：最常见的是 USB 重定向策略没开，或者客户端侧 Horizon Client 的 USB 重定向选项被禁用。其次才是 Extras 组件没装或服务没起。

解决：先查 Horizon 连接服务器的 USB 重定向策略是否对该用户生效；再查客户端 Horizon Client 设置里“USB 重定向”是否勾选；最后在虚拟桌面里确认VMware USB Arbitration Service处于 Running。三步都过了还不认，再看 Extras 的 USB MSI 是否真的装上了。

4.2 智能卡读卡器灯亮，但桌面里认证软件读不到卡

现象：读卡器插在客户端，灯正常亮，宿主机也能听到设备接入提示音，但虚拟桌面里的智能卡中间件提示“未找到读卡器”。

原因：PCoIP 智能卡重定向需要在 Agent 侧和客户端侧同时启用，而且中间件驱动必须装在虚拟桌面里，不是装在宿主机。很多人把中间件装错了位置。

解决：确认 Extras 里的 PCoIP Client Extensions 已安装；确认虚拟桌面里装了读卡器厂商的中间件；确认 Horizon Agent 安装时勾选了智能卡组件。三处缺一不可。

4.3 扫描仪重定向后扫描软件卡死

现象：扫描仪在宿主机能用，重定向到桌面后，扫描软件点“扫描”就卡住，过一会儿报超时。

原因：扫描仪重定向对带宽和延迟敏感，PCoIP 的扫描仪通道默认参数偏保守。另外，部分扫描仪型号的 TWAIN 驱动在重定向环境下不兼容。

解决：先换一台同型号扫描仪测试，排除个体差异；再在 Agent 侧调整扫描仪重定向的超时参数；如果仍不行，考虑改用网络扫描仪方案，绕开 USB 重定向。这是典型的“能修但成本高”场景，要算投入产出。

4.4 装了 Extras 后 Agent 启动变慢、登录时间变长

现象：模板里装了全套 Extras，批量部署后发现用户登录虚拟桌面时间从 15 秒变成 40 秒以上。

原因：不需要的重定向组件在 Agent 启动时也会加载服务、枚举虚拟设备，白白消耗时间。尤其是 Flash 重定向和串口重定向，在不需要的环境里纯属拖累。

解决：回到模板，卸载不需要的组件。只保留业务真正用到的。登录时间敏感的环境，建议逐个组件做加法测试，而不是一次性全装。

4.5 事件日志里 USB Arbitration Service 反复重启

现象：虚拟桌面事件日志里VMware USB Arbitration Service每隔几分钟重启一次，USB 设备时断时续。

原因：Extras 版本与 Agent 版本不匹配，或者系统里存在旧版 VMware 驱动残留。常见于从旧模板升级上来的环境。

解决：先确认版本匹配；再用 VMware 官方的清理工具把旧驱动清干净，重新安装匹配版本的 Agent 和 Extras。不要直接覆盖安装，残留驱动会一直捣乱。

5. 用 PowerShell 做批量验证与一个少走弯路的习惯

5.1 批量检查 Extras 组件是否落地

模板克隆出几十上百台虚拟桌面后，你不可能一台台登录去看。用下面这段 PowerShell 在域内批量查关键服务和注册表项，快速筛出没装好的机器。

# 批量检查 Horizon Extras 关键组件状态 $computers = Get-Content "C:\Scripts\vdi-list.txt" $results = foreach ($pc in $computers) { $svc = Get-Service -ComputerName $pc -Name "VMware USB Arbitration Service" -ErrorAction SilentlyContinue $reg = Invoke-Command -ComputerName $pc -ScriptBlock { Test-Path "HKLM:\SOFTWARE\VMware, Inc.\VMware VDM\Agent\USB" } -ErrorAction SilentlyContinue [PSCustomObject]@{ ComputerName = $pc USBService = if ($svc) { $svc.Status } else { "NotFound" } USBRegKey = $reg } } $results | Export-Csv "C:\Scripts\extras-check.csv" -NoTypeInformation -Encoding UTF8

逻辑说明：从文本文件读取计算机列表，逐台远程查 USB 重定向服务状态和注册表子键是否存在。-ErrorAction SilentlyContinue保证某台机器离线时脚本不中断。输出 CSV 方便筛选USBService不是Running或USBRegKey为False的机器，这些就是需要补装的。参数上，vdi-list.txt一行一个主机名，编码用 UTF8 避免中文路径问题。

5.2 一个让我少走弯路的习惯：先做减法再做加法

我早期做 Horizon 外设交付时，习惯把 Extras Bundle 里所有组件一次性装进模板，觉得“反正都装上，用户要什么有什么”。结果就是登录变慢、服务冲突、排错时根本分不清是哪个组件在捣乱。后来改成：模板里只装业务明确要求的那一两个组件，其余等有需求时再单独加。每次加组件前拍快照，加完做一轮外设验证，通过再合并到主模板。

这个习惯带来的好处是，出问题时变更范围极小，回滚成本极低。Horizon 的外设重定向本身就是两端协商加驱动配合的链路，变量越少，排错越快。Extras Bundle 不是装得越多越省事，而是装得越准越稳。希望帮到你。

本文还有配套的精品资源，点击获取