---
title: "将 Windows 代理安装到 Windows 自定义映像中"
slug: "installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image"
updated: 2026-06-29T23:34:24Z
published: 2026-06-29T23:34:24Z
canonical: "learn.workforceexperience.hp.com/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://learn.workforceexperience.hp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 将 Windows 代理安装到 Windows 自定义映像中

管理大型 Windows 设备队列的组织通常会创建自定义映像，以简化部署并减少跨环境的设置时间。将 HP Insights Windows 应用程序（也称为 Windows 代理）集成到这些自定义映像中，使 IT 团队能够从首次启动开始就自动将设备注册到 HP Workforce Experience Platform （WXP）。这种方法有助于消除部署后安装和配置的需要。

本文提供了使用 [Windows Audit Mode](/wxp/docs/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image#method-1-windows-audit-mode) 或 [System Center Configuration Manager (SCCM) Task Sequence.](/wxp/docs/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image#method-2-system-center-configuration-manager-sccm-task-sequence) 将 HP Insights for Windows 代理安装到自定义 Windows 映像中的分步指南

> 如果您使用的是 HP 配置服务，请联系您的 HP 销售代表或业务合作伙伴，将 Windows 代理加载到您的自定义映像中。

### 先决条件

在开始安装之前：

- 将 [UPN suffixes](/wxp/docs/obtaining-the-user-principal-name-domain-suffix) 提供给您的惠普服务专家或业务合作伙伴。
- 获取公司 PIN。
  - 在 WXP 的左侧菜单中，单击 **设置** > **首选项**。将显示 **“首选项”** 选项卡。
  - 在“首选项”选项卡上，滚动到 **“公司 PIN** ”部分并复制 PIN 码。

## **下载 Windows 代理**

**要下载适用于 Windows 的 HP Insights 代理：**

访问 URL - [https://workforceexperience.hp.com/software](https://workforceexperience.hp.com/software) 下载 HP Insights Windows 应用程序（Windows 代理）。

详细步骤，请参阅文章 - [Downloading the HP Insights for Windows Application.](/wxp/docs/installing-hp-insights-windows-application-using-setupexe)

> **注意：** HP Insights Analytics 客户端 - 依赖项包不能安装在非 HP 制造的 PC（包括虚拟机）上。

## **方法 1：Windows 审核模式**

按照以下步骤将 Windows 代理添加到参考映像，然后再将其发送给用户。

> [!NOTE]
> **注意：**
> 
> 1. 如果目标平台是 x64，请保持 setup.exe 不变。如果目标平台是 Arm64，请使用 setuparm.exe 替代 setup.exe。
> 2. setuparm.exe 适用于 Windows 11 24H2 及更高版本。

#### **第 1 步：创建install.cmd批处理脚本文件**

1. 在 USB 驱动器上，将下载的setup.exe安装程序文件放置。
2. 在文本编辑器（如记事本）中，创建一个名为 `install.cmd` 以下内容的文件：

```plaintext
reg add "HKLM\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager\GPO\DisableOnlineCheck" /v State /t REG_SZ /d True /f %~dp0setup.exe /silent /HIDETRAY=True CPIN=Company-PIN
```

将占位符公司 PIN 替换为 HP 服务专家提供的实际 PIN 码，然后保存文件。例如：%~dp0setup.exe /silent CPIN=AbcDefg
  1. > **注意**：如果 PC 无法通过经过身份验证的代理连接到 Internet，则可以省略该`reg add`行。
3. 确保 USB 驱动器上有以下文件：
  - install.cmd
  - setuparm.exe
  - setup.exe

#### **第 2 步：修改参考图像**

本节介绍修改 Windows 参考映像以添加 Windows 代理的步骤。以下说明假定您已创建 Windows 参考映像，并将 Windows 代理添加到该映像中。

> [!WARNING]
> **警告**：在执行以下步骤之前，请确保具有参考图像的 PC 无法访问互联网。

1. 将带有参考映像的 Windows PC 启动到审核模式。
  1. 在 Windows 现成体验 （OOBE） 屏幕上，按 **Ctrl + Shift + F3** 进入审核模式。将显示 **“系统准备 （Sysprep）”工具** 。
2. 将包含install.cmd和Setup.exe文件的 USB 驱动器插入 PC。
3. 打开 Windows 资源管理器并转到 USB 驱动器。
4. 右键单击install.cmd文件，然后选择 **以管理员身份运行**。将显示一个命令窗口。
5. 开始执行安装命令。命令窗口消失后，系统托盘中会出现 HP 图标，并带有黄色感叹号，表示 Windows 代理 **未注册**。

> [!WARNING]
> **警告**：完成上述步骤后，Windows 代理图标必须显示为 “**未注册** ”。如果显示为**“已注册”**， 则无法正确创建参考图像。确保设备无法连接到互联网以执行注册。
6. 使用 Windows 资源管理器，转到并 `C:\ProgramData\Hewlett-Packard\HP Touchpoint Manager` 确认创建的文件 `enroll_config.json` 。
  1. 如果**未显示enroll_config.json** 文件，则 install.cmd脚本文件可能存在问题。请按照以下步骤重试：
    1. 再次右键单击install.cmd脚本，并确保 选择**以管理员** 身份运行。
    2. 重复**创建install.cmd批处理脚本** 中的 步骤以重新创建install.cmd文件，然后再次尝试运行该脚本。
    3. 从 PC 中取出 USB 驱动器。
7. 在 Sysprep 工具中，确保选择以下选项，然后选择 “**确定”**：
  - **系统清理作**：进入系统现成体验 （OOBE）
  - 选择 **“泛化”**
  - **关机选项**：关机
8. 或者，在命令窗口中运行命令： `Sysprep /generalize /shutdown`。然后将对参考 PC 进行推广，并可以捕获图像。

#### 第 3 步： **捕获参考图像**

本部分介绍在安装 Windows 代理后捕获参考映像的步骤。这些步骤仅供参考，可以修改这些步骤以符合您的标准成像程序。

要捕获参考图像：

1. 使用可启动 **WinPE 媒体** 启动设备。
  1. 有关帮助，请参阅 Microsoft 资源： [下载 WinPE （Windows PE）](https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/download-winpe--windows-pe) [创建可启动的 WinPE 媒体](https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/winpe-create-usb-bootable-drive)
  2. 确保 USB 驱动器上有足够的空间来存储图像。
2. 在具有参考映像的电脑上，插入可启动的 WinPE 媒体，并将设备启动到 WinPE。
3. 在命令提示符下，运行以下命令以捕获 Windows 分区：

`Dism /Capture-Image /ImageFile:"D:\Images\company.wim" /CaptureDir:C:\ /Name:Company`

替换 `D:` 为目标路径。图像被成功捕获并保存到 USB 驱动器或文件存储位置。

#### **第 4 步：应用捕获的图像**

本节介绍将捕获的映像应用到电脑并确认 Windows 代理可以成功注册的步骤。这些步骤仅供参考，可以修改这些步骤以符合您的标准成像程序。

要应用捕获的图像：

1. 使用 MBR 或 UEFI/GPT 的脚本对目标 PC 的硬盘驱动器进行分区。
  1. 根据要应用映像的硬件选择分区选项。 有关帮助，请参阅以下 Microsoft 资源： [基于 BIOS/MBR 的硬盘分区](https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/configure-biosmbr-based-hard-drive-partitions) [基于 UEFI/GPT 的硬盘分区](https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/configure-uefigpt-based-hard-drive-partitions)
2. 使用脚本应用捕获的图像，例如： `D:\ApplyImage.bat C:\Images\Company.wim`
  1. 有关其他信息，请参阅下面的 Microsoft 资源： [使用单个 .WIM 文件](https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/capture-and-apply-windows-using-a-single-wim)
  2. 这可以是上面 [捕获参考图像（Capture the Reference Image](/wxp/docs/zh-cn/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image#第-3-步：-捕获参考图像) ） 部分中用于捕获参考图像的同一USB驱动器。
3. 使用之前创建的可启动 WinPE 媒体将电脑启动到 WinPE，然后插入包含脚本和捕获映像的 USB 驱动器。
4. 通过运行 diskpart 实用程序并应用上面创建的驱动器分区脚本来对硬盘驱动器进行分区。例如： 磁盘部分 /s CreatePartitions-UEFI.txt 如果分区成功，您应该会看到驱动器分区，如下所示： ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image-image-acdafy47.jpg?sv=2026-02-06&spr=https&st=2026-10-29T02%3A08%3A00Z&se=2026-10-29T03%3A08%3A00Z&sr=c&sp=r&sig=VkQT%2FE9fUp0tFn4lv5%2BU%2BSTkoYu1oOHZXM1cyjSyNp8%3D)
5. 使用上面创建的脚本将映像应用于 Windows 和恢复分区。例如，如果脚本和图像位于 D： 驱动器上： D：\ApplyImage.bat C：\Images\Fabrikam.wim
6. 如果脚本找不到 Winre.wim 文件，则可能需要将 Winre.wim 文件从 Windows 安装介质复制到 USB 驱动器。在 Windows 安装介质上，Winre.wim 文件位于 **\Windows\system32\Recovery** 路径下的 install.wim 文件中。
7. 如果图像已成功应用于 PC，您应该会看到如下屏幕所示的作成功消息： ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image-image-6cyh3nzb.jpg?sv=2026-02-06&spr=https&st=2026-10-29T02%3A08%3A00Z&se=2026-10-29T03%3A08%3A00Z&sr=c&sp=r&sig=VkQT%2FE9fUp0tFn4lv5%2BU%2BSTkoYu1oOHZXM1cyjSyNp8%3D)
8. 从电脑中取出可启动的 WinPE 媒体和 USB 驱动器。在 WinPE 中键入 **Exit** 以重新启动电脑。电脑应启动到 Windows 10/11 OOBE。
9. 在浏览 Windows 10/11 OOBE 时，请确保将电脑连接到可以访问 Internet 的网络。
10. OOBE 过程完成并显示 Windows 桌面后，PC 应自动注册 HP Insights 服务。
11. 如果设备已加入域，并且已在 HP Insights 服务公司租户中配置了 UPN 域后缀，则 PC 将在连接到 Internet 时静默注册。
12. 如果设备未加入域，您将看到一个注册确认对话框，如下所示，选择 **“同意”** 将完成注册过程： ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/installing-the-hp-insights-for-windows-agent-into-a-windows-custom-image-image-bnj95lco.jpg?sv=2026-02-06&spr=https&st=2026-10-29T02%3A08%3A00Z&se=2026-10-29T03%3A08%3A00Z&sr=c&sp=r&sig=VkQT%2FE9fUp0tFn4lv5%2BU%2BSTkoYu1oOHZXM1cyjSyNp8%3D)
13. 可以通过右键单击 HP 系统托盘图标并选择 **状态**来确认注册状态。设备注册状态应显示为 **已注册**，如以下屏幕所示：

## **方法 2：System Center Configuration Manager （SCCM） 任务序列**

按照以下步骤使用 System Center Configuration Manager （SCCM） 任务序列将 HP Insights for Windows 代理安装到自定义映像中。

### **创建install.cmd批处理脚本文件**

本节介绍如何下载 HP Insights for Windows 代理并创建install.cmd批处理脚本文件，以在映像中预配置 HP Insights for Windows 代理以启用自动设备注册。

**要创建install.cmd批处理脚本文件，请执行以下作：**

1. 在 Windows PC 上，启动 Web 浏览器并从 [https://www.hpdaas.com/software](https://www.hpdaas.com/software) 下载 最新版本的 HP Insights for Windows 代理。
2. 下载适用于 Windows 的 HP Insights 代理Setup.exe安装程序文件。
  1. 参见 [Installing HP Insights Windows Application Using setup.exe](/wxp/docs/installing-hp-insights-windows-application-using-setupexe)。
3. 将Setup.exe安装程序文件复制到 SCCM 可访问的文件共享上。
4. 在文本编辑器（如记事本）中，创建一个名为 **install.cmd** 的文件 。
5. 将以下文本复制并粘贴到install.cmd批处理脚本文件的正文中：

`reg add "HKLM\SOFTWARE\Policies\Hewlett-Packard\HP Touchpoint Manager\GPO\DisableOnlineCheck" /v State /t REG_SZ /d True /f %~dp0setup.exe /silent /HIDETRAY=True CPIN=Company PIN`
  1. > [!NOTE]
> **注意：**如果目标平台是 x64，请保持 setup.exe 不变。如果目标平台是 Arm64，请使用 setuparm.exe 替代 setup.exe。
6. 将**公司范围的 PIN** 替换 为您的 HP 服务专家或业务合作伙伴提供的 PIN。例如： `%~dp0setup.exe /silent CPIN=AbcDefg`
  1. > **注意**： 如果映像的 Windows PC 无法通过经过身份验证的代理连接到互联网，则可以省略上述 **reg add** 命令。
7. 将脚本文件保存到保存setup.exe安装程序文件的同一文件共享中。

### **在 SCCM 中创建应用程序**

本节介绍如何在 SCCM 中创建应用程序以安装 HP Insights for Windows 代理。

要在 SCCM 中创建应用程序，请执行以下作：

1. 登录到 SCCM 管理控制台。 启动 “**创建包和程序向导**”。
2. 在 SCCM 管理控制台中，单击 **软件库**。
3. 在“软件库”工作区中，单击 **“应用程序管理** ”> “**应用程序**”。 单击 顶部的**“创建应用程序** ”。
4. 选择 **“手动指定应用程序信息”**，然后单击“ **下一步**”。
5. 在相应字段中键入以下内容：
  - **名称**：HP Insights for Windows 代理
  - **发行商**： 惠普公司
  - **版本**：3.xx.xxx（替换为要部署的setup.exe文件的版本）。
6. 单击 **下一步** 以接受**应用程序目录** 条目的默认值 。
7. 单击 **“添加** ”以创建新的 **部署类型**，然后选择 **“脚本安装程序”**。手动指定将自动选择的部署类型信息，然后单击 **下一步**。
8. 键入“HP Insights for Windows 代理静默安装”作为部署的名称，然后单击 **下一步**。
9. 在**“内容位置”**中 ，指定install.cmd文件的网络路径（UNC 名称）。
10. 在安装程序中，指定install.cmd文件。
11. 在“卸载程序”中，指定以下命令。

`%PROGRAMFILES%\InstallShield Installation Information\{24CB35EB-F445-4061-8C3A-67D5631996C5}\setup.exe -remove -silent`
  1. > [!NOTE]
> **注意：**如果目标平台是 x64，请保持 setup.exe 不变。如果目标平台是 Arm64，请使用 setuparm.exe 替代 setup.exe。
12. 选中**“在 64 位客户端上以 32 位进程形式运行安装和卸载程序”**复 选框，然后单击 **“下一步**”。
13. 要指定检测规则，请单击 “**添加子句** ”并输入以下规则以检测客户端二进制文件的存在，然后单击 **“确定**”。单击**下一步** 继续 ：
  - **设置类型**：文件系统
  - 如果目标平台是 x64，请使用以下路径：`%ProgramFiles(x86)%\Hewlett-Packard\HP Insights Manager\Agent`
  - 如果目标平台是 Arm64，请使用以下路径：`%ProgramW6432%\Hewlett-Packard\HP Insights Manager\Agent`
  - **文件或文件夹名称**：LHAgent.exe
  - 选中**“此文件或文件夹与 64 位系统** 上的 32 位应用程序相关联” 复选框。
  - 选中 **“目标系统上必须存在文件系统设置才能指示此应用程序** 的存在”复选框。
14. 若要指定用户体验设置，请选择以下设置，然后单击 **下一步**：
  - **安装行为**：系统安装
  - **登录要求**：用户是否登录
  - **安装程序可见性**：隐藏
  - **最大允许运行时间（分钟）：**20
15. 单击 **“下一步** ”以接受安装要求的默认值。
16. 单击 **“下一步** ”以接受软件依赖项的默认值。
17. 确认部署详情，然后单击 **下一步**。
18. 显示完成屏幕后，单击 **“关闭”**。
19. 在**“创建应用程序向导**” 中，单击 **“下一步** ”继续。
20. 确认设置，然后单击 **下一步**。
21. 显示完成屏幕后，单击 **“关闭”**。
22. 新应用程序将显示在**“应用程序”** 节点下。右键单击，然后选择 **“属性”**。
23. 选择**“分发设置** ” 选项卡，然后选择“ 将**包分配给分发点时自动下载内容”**。
24. 通过右键单击应用程序并选择 **“分发内容**”，然后演练内容分发向导，将应用程序分发到分发点。

#### **将应用程序添加到现有 Windows 安装任务序列**

本节介绍如何将 HP Insights for Windows 代理添加到现有任务序列。这些步骤假定你已有用于安装 Windows 的现有任务序列。

**若要将应用程序添加到现有任务序列，请执行以下作：**

1. 在 SCCM 管理控制台中，单击 **软件库**。
2. 在“软件库”工作区中，单击 **“作系统** ”>“**询问序列**”。
3. 右键单击现有的 Windows 部署任务序列，然后选择 **“编辑”**。
4. 将新的“安装应用程序”任务添加到“安装应用程序”任务组，以便它与其他应用程序一起安装。如果存在，应将其添加到“加入域”或“工作组”任务之后。
5. 要添加新的安装应用程序任务，请选择“**安装作系统”** 节点，然后选择 “**添加** > **软件** ”> **“安装应用程序**”。
6. 选择“**安装以下应用程序** ” 部分下的星号图标，然后选择 HP Insights for Windows 代理并选择 **“确定**”。
7. 选择“**确定** ”以 更新任务序列。
8. 根据映像过程，创建任务序列媒体或使用任务序列捕获参考图像。

## **联系我们**

如需帮助，请创建[**支持案例**](/wxp/docs/zh-cn/creating-a-support-case)或发送电子邮件至 [**support@wxp.hp.com**](mailto:support@wxp.hp.com)。