---
title: "通过 Intune 部署 macOS 代理"
slug: "deploy-macos-agent-via-intune"
updated: 2026-06-15T22:59:52Z
published: 2026-06-15T22:59:52Z
canonical: "learn.workforceexperience.hp.com/deploy-macos-agent-via-intune"
---

> ## 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.

# 通过 Intune 部署 macOS 代理

### **简介**

HP Insights macOS 代理帮助将 macOS 设备注册并连接到 HP Workforce Experience Platform (WXP)。本文介绍如何使用 Microsoft Intune 在托管的 macOS 设备上部署 `HPInsightsInstaller.pkg`。还说明了如何添加注册配置、配置检测规则以及将应用程序分配给所需的设备或用户组。

### **先决条件**

在部署之前，请确保满足以下要求：

- macOS 设备已成功注册到 Microsoft Intune。
- Apple MDM Push Certificate 已配置并处于活动状态。
- Intune 许可证已分配给目标用户。
- `HPInsightsInstaller.pkg` 已最终确定并已测试静默安装。
- 企业 PIN 可用（如果需要 JSON 注册配置）。
- 所需的 Microsoft Entra ID (Azure AD) 设备或用户组已创建用于分配。

### **部署流程概述**

1. 将 `HPInsightsInstaller.pkg` 上传到 Intune
2. 配置应用程序元数据
3. 配置预安装注册脚本
4. 设置检测规则
5. 定义要求
6. 将应用程序分配给设备或用户组

| 概念 | 用途 |
| --- | --- |
| PKG 部署 | 安装 HP Insights macOS 代理 |
| 预安装脚本 | 在代理安装开始之前创建 `enrollment.json` 和所需的配置。 |
| `enrollment.json` | 提供设备注册所需的企业 PIN 或注册信息 |

### **步骤 1：将 HPInsightsInstaller.pkg 上传到 Intune**

1. 登录到 [Intune Admin Center](https://intune.microsoft.com/)。
2. 点击 **应用程序** > **macOS** > **添加**。
3. 选择 macOS 应用 (PKG)。
4. 点击 **选择**。
5. 上传 `HPInsightsInstaller.pkg` 文件。
6. 点击 **确定**。

`HPInsightsInstaller.pkg` 在托管的 macOS 设备上安装 HP Insights macOS 代理。代理在安装和注册完成后将设备连接到 WXP。

### **步骤 2：配置应用程序信息**

添加以下详细信息并点击 **下一步**：

- **名称**：HP Insights macOS Agent
- **描述**：提供适当的描述。
- **发布者**：HP
- **类别**：应用程序
- **徽标**：可选。

### **步骤 3：配置预安装脚本**

仅当您的部署要求在安装 HP Insights 代理之前在设备上创建 `enrollment.json` 文件时，才使用预安装脚本。如果您的软件包已包含所需的注册配置，或者如果另一种部署方法创建了该文件，则可能不需要此步骤。

此步骤对于静默注册是必需的。

**脚本 1**

```plaintext
#!/bin/bash

APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########

if [ ! -d "$APPLICATION_SUPPORT_DIRECTORY" ]; then
    mkdir -p "$APPLICATION_SUPPORT_DIRECTORY"
fi

echo "{\"PIN\":\"$PIN\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ -f "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json" ]; then
    exit 0
else
    exit 1
fi
```

**脚本 2**

```plaintext
Enrollment_Tray.sh（隐藏菜单栏图标选项）
#!/bin/bash

APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########

if [ ! -d "$APPLICATION_SUPPORT_DIRECTORY" ]; then
    mkdir -p "$APPLICATION_SUPPORT_DIRECTORY"
fi

echo "{\"PIN\":\"$PIN\",\"HideTray\":\"true\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"

if [ -f "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json" ]; then
    exit 0
else
    exit 1
fi
```

> **注意**：`HideTray` 值控制 HP Insights 代理图标是否在 macOS 菜单栏中可见。如果需要向最终用户隐藏菜单栏图标，请将 `HideTray` 设置为 `true`。如果图标需要保持可见，请省略此值。

根据菜单图标是否需要可见选择适当的脚本；然后将其粘贴到预安装脚本中。

### **步骤 4：定义要求**

定义以下内容并点击 **下一步**：

- **最低 macOS 版本**：例如，macOS 12 或更高版本。
- **架构**：默认。

### **步骤 5：配置检测规则（关键步骤）**

根据已安装的 HP Insights 代理应用程序包配置检测规则。如果检测规则与已安装的应用程序不匹配，即使软件包安装正确，Intune 也可能将部署报告为失败。

如果应用程序安装在 /Applications 目录中，请配置以下内容：

- **应用程序包 ID**：com.hp.DaasClient.macOS.APMAgent
- **（可选）版本比较**

确保检测规则与软件包的实际安装行为一致。

### **步骤 6：配置分配**

选择以下分配类型：

- **必需**：自动静默安装。
- **可用**：用户从 Company Portal 安装应用程序。

对于自动静默部署：

1. 选择 **必需** 并将应用程序分配给适当的设备组。
2. 点击 **下一步**。
3. 点击 **创建**。

## **联系我们**

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