---
title: "macOS-agentin käyttöönotto Intunen kautta"
slug: "deploy-macos-agent-via-intune"
updated: 2026-06-15T22:39:41Z
published: 2026-06-15T22:39:41Z
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.

# macOS-agentin käyttöönotto Intunen kautta

### **Johdanto**

HP Insights macOS -agentti auttaa rekisteröimään ja yhdistämään macOS-laitteet HP Workforce Experience Platform (WXP) -alustaan. Tämä artikkeli kuvaa, kuinka `HPInsightsInstaller.pkg` otetaan käyttöön hallituissa macOS-laitteissa Microsoft Intunen avulla. Se selittää myös, kuinka rekisteröintimääritys lisätään, tunnistussäännöt määritetään ja sovellus kohdistetaan vaadituille laite- tai käyttäjäryhmille.

### **Edellytykset**

Varmista ennen käyttöönottoa, että seuraavat vaatimukset täyttyvät:

- macOS-laitteet on rekisteröity onnistuneesti Microsoft Intuneen.
- Apple MDM Push Certificate on määritetty ja aktiivinen.
- Intune-lisenssi on kohdistettu kohdekäyttäjille.
- `HPInsightsInstaller.pkg` on viimeistelty ja testattu hiljaista asennusta varten.
- Yrityksen PIN-koodi on saatavilla (jos JSON-rekisteröintimääritys on tarpeen).
- Vaadittu Microsoft Entra ID (Azure AD) -laite- tai käyttäjäryhmä on luotu kohdistusta varten.

### **Yleiskatsaus käyttöönottoprosessiin**

1. `HPInsightsInstaller.pkg`:n lataaminen Intuneen
2. Sovelluksen metatietojen määritys
3. Esiasennuksen rekisteröintiskriptin määritys
4. Tunnistussääntöjen asettaminen
5. Vaatimusten määrittely
6. Sovelluksen kohdistaminen laite- tai käyttäjäryhmille

| Käsite | Tarkoitus |
| --- | --- |
| PKG-käyttöönotto | Asentaa HP Insights macOS -agentin |
| Esiasennusskripti | Luo `enrollment.json`-tiedoston ja vaaditun määrityksen ennen agentin asennuksen alkamista. |
| `enrollment.json` | Tarjoaa yrityksen PIN-koodin tai laiterekisteröintiin tarvittavat rekisteröintitiedot |

### **Vaihe 1: HPInsightsInstaller.pkg:n lataaminen Intuneen**

1. Kirjaudu sisään [Intune Admin Centeriin](https://intune.microsoft.com/).
2. Napsauta **Sovellukset** > **macOS** > **Lisää**.
3. Valitse macOS-sovellus (PKG).
4. Napsauta **Valitse**.
5. Lataa tiedosto `HPInsightsInstaller.pkg`.
6. Napsauta **OK**.

`HPInsightsInstaller.pkg` asentaa HP Insights macOS -agentin hallituille macOS-laitteille. Agentti yhdistää laitteen WXP-alustaan asennuksen ja rekisteröinnin jälkeen.

### **Vaihe 2: Sovellustietojen määritys**

Lisää seuraavat tiedot ja napsauta **Seuraava**:

- **Nimi**: HP Insights macOS Agent
- **Kuvaus**: Anna asianmukainen kuvaus.
- **Julkaisija**: HP
- **Luokka**: Sovellukset
- **Logo**: Valinnainen.

### **Vaihe 3: Esiasennusskriptin määritys**

Käytä esiasennusskriptiä vain, jos käyttöönottosi edellyttää, että `enrollment.json`-tiedosto luodaan laitteelle ennen HP Insights -agentin asennusta. Jos pakettisi sisältää jo vaaditun rekisteröintimäärityksen tai jos toinen käyttöönottomenetelmä luo tiedoston, tämä vaihe ei ehkä ole tarpeen.

Tämä vaihe on pakollinen hiljaista rekisteröintiä varten.

**Script 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
```

**Script 2**

```plaintext
Enrollment_Tray.sh (Valikkopalkin kuvakkeen piilotusvaihtoehto)
#!/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
```

> **Huomautus**: `HideTray`-arvo määrittää, onko HP Insights -agentin kuvake näkyvissä macOS-valikkopalkissa. Aseta `HideTray` arvoon `true`, jos valikkopalkin kuvake on piilotettava loppukäyttäjiltä. Jätä tämä arvo pois, jos kuvakkeen on pysyttävä näkyvissä.

Valitse sopiva skripti sen mukaan, pitääkö valikkokuvakkeen olla näkyvissä; liitä se sitten kohtaan Esiasennusskripti.

### **Vaihe 4: Vaatimusten määrittely**

Määritä seuraavat ja napsauta **Seuraava**:

- **macOS:n vähimmäisversio**: Esimerkiksi macOS 12 tai uudempi.
- **Arkkitehtuuri**: Oletus.

### **Vaihe 5: Tunnistussääntöjen määritys (kriittinen vaihe)**

Määritä tunnistussääntö asennetun HP Insights -agentin sovelluspaketin perusteella. Jos tunnistussääntö ei vastaa asennettua sovellusta, Intune voi raportoida käyttöönoton epäonnistuneeksi, vaikka paketti asennetaan onnistuneesti.

Jos sovellus asennetaan /Applications-hakemistoon, määritä seuraavat:

- **Sovelluspaketin tunniste**: com.hp.DaasClient.macOS.APMAgent
- **(Valinnainen) Versiovertailu**

Varmista, että tunnistussääntö vastaa paketin todellista asennuskäyttäytymistä.

### **Vaihe 6: Kohdistusten määritys**

Valitse seuraava kohdistustyyppi:

- **Pakollinen**: Asennetaan automaattisesti ja hiljaisesti.
- **Saatavilla**: Käyttäjät asentavat sovelluksen Company Portalin kautta.

Automaattista hiljaista käyttöönottoa varten:

1. Valitse **Pakollinen** ja kohdista sovellus asianmukaiselle laiteryhmälle.
2. Napsauta **Seuraava**.
3. Napsauta **Luo**.

## **Ota yhteyttä**

Jos tarvitset apua, luo [**tukipyyntö**](/wxp/docs/fi/creating-a-support-case) tai lähetä sähköposti osoitteeseen [**support@wxp.hp.com**](mailto:support@wxp.hp.com).