--- title: "Intune을 통한 macOS 에이전트 배포" slug: "deploy-macos-agent-via-intune" updated: 2026-06-15T22:56:51Z published: 2026-06-15T22:56:51Z 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/ko/creating-a-support-case)를 생성하거나 [**support@wxp.hp.com**](mailto:support@wxp.hp.com)으로 이메일을 보내주세요.