Installieren Sie den Task Mining-Agent für macOS

  • Freigeben Version: Australia
  • Aktualisiert 27. April 2026
  • 5 Minuten Lesedauer

    • Installieren Sie den Task Mining-Desktop-Agent auf macOS-Workstations, und stellen Sie den Task Mining-Agenten auf verwalteten macOS-Geräten mithilfe VON JAMF bereit. Mit diesem Verfahren werden das Paket, die Skripts, die Richtlinien und das Konfigurationsprofil erstellt, die für die Enterprise-Bereitstellung erforderlich sind.

    Vorbereitungen

    Erforderliche Rolle: Task Mining Agent-Installation
    Hinweis:
    Sie müssen Teil von sein Task Mining Agent-Installationsgruppe mit den Rollen itil, sn_tm_core.service_user und Agent_Client_Collector_admin zur Installation von Task Mining Service Desk-Mitarbeiter. Wenn die Gruppe nicht vorhanden ist, erstellen Sie manuell eine Gruppe mit diesem Namen und diesen Rollen. Weitere Informationen finden Sie unter Weisen Sie einer Gruppe eine Rolle zu .

    Warum und wann dieser Vorgang ausgeführt wird

    Der Task Mining-Agent für macOS wird als bereitgestellt .Paket Archivieren. Es kann mit einem einzeiligen Terminalskript installiert werden, das den gesamten Download und die gesamte Konfiguration automatisch verarbeitet, oder indem das Installationspaket manuell heruntergeladen und konfiguriert wird.

    Die JAMF-Bereitstellung erstellt zwei Skripts, zwei Richtlinien und ein Konfigurationsprofil. Das erste Skript generiert die JSON-Konfigurationsdatei, die das Installationsprogramm benötigt. Das zweite Skript überprüft, ob der Agent installiert ist, und löst eine Neuinstallation aus, wenn nicht. Die erste Richtlinie kombiniert das Paket und das Konfigurationsskript und wird mit einem anwenderdefinierten Auslöser ausgeführt. Die zweite Richtlinie führt das Bereitstellungsskript nach einem wiederkehrenden Zeitplan aus. Das Konfigurationsprofil gewährt die Barrierefreiheitsberechtigungen, die der Agent für die Datenerfassung benötigt.

    Prozedur

    1. Rufen Sie ab Instanz-URL Und Registrierungsschlüssel .
      Die Instanz-URL und die Registrierungsschlüsselwerte sind für Windows- und macOS-Agenten identisch.
      1. Navigieren zu Alle > Task Mining > Agent-Installationan.
      2. Wählen Sie einen vorhandenen Schlüssel aus, oder erstellen Sie einen.

        Screenshot der Auswahl des Registrierungsschlüssels.

      3. Kopieren Sie Instanz-URL Und Registrierungsschlüssel Auf der Seite „Service Desk-Mitarbeiter-Installation“.

      Screenshot der Instanz-URL und des Registrierungsschlüssels.

    2. Installieren Sie den macOS-Agenten, indem Sie das Terminalskript ausführen.
      1. Wählen Sie aus MacOS Registerkarte auf Agent-Installation Seite.
      2. Wählen Sie Aus Kopieren Neben Herunterladen und installieren Zum Erfassen des einzeiligen macOS-Befehlszeilenskripts.
        Screenshot der macOS-Befehlszeile.
      3. Öffnen Sie das macOS Terminal Anwendung.
      4. Fügen Sie das Skript ein, und drücken Sie Eingabetaste .
      Das Skript lädt das Installationspaket herunter, generiert die erforderliche Konfigurationsdatei mithilfe Ihrer Instanz-URL und des Registrierungsschlüssels und führt das Installationsprogramm automatisch aus.
      Hinweis:
      Laden Sie für eine manuelle Installation die Dateien Intel und Apple Silicon und JSON herunter. Platzieren Sie beide Dateien in demselben Ordner. Benennen Sie die JSON-Datei nicht um. Doppelklicken Sie auf die .pkg-Datei (oder verwenden Sie die Tastenkombination), um das Installationsprogramm zu starten, und befolgen Sie die Anweisungen auf dem Bildschirm.
      Screenshot von JSON und Intel und Apple Silicon.
    3. Fügen Sie das Agent-Paket zu JAMF hinzu.
      1. Suchen Sie in den JAMF-Einstellungen nach Pakete .
      2. Wählen Sie Neu.
      3. Geben Sie den Paketnamen ein, und laden Sie den Service Desk-Mitarbeiter hoch .Paket Archivieren und speichern Sie das Paket.
    4. Erstellen Sie das Konfigurationsskript.
      1. Suchen Sie in den JAMF-Einstellungen nach Skripts .
      2. Wählen Sie Neu.
      3. Benennen Sie das Skript Task Mining-Skript .
      4. Wählen Sie aus Skript Wählen Sie den entsprechenden Skripttyp aus, und geben Sie das folgende Skript ein: 
        #!/bin/bash
#set these variables in the param sections 4 and 5
REGAPIURL=$4
REGKEY=$5
TARGET="/Library/Application Support/JAMF/Downloads/"
JSON="tm-macos-agent_installer.json"

if [[ -z "REGAPIURL" || -z "REGKEY" ]]; then
    echo "reg api url and reg key must be set as 4 and 5 arguments"
    exit 1
fi

cd "$TARGET" || {
    echo "failed to change dir"
    exit 2
}

cat <<EOF > "$JSON"
{
    "agent": {
        "reg-api-url": "$REGAPIURL",
        "reg-key": "$REGKEY"
    }
}
EOF
      5. Wählen Sie Speichern.
    5. Erstellen Sie das Bereitstellungsskript.
      1. Wählen Sie Aus Neu Um ein weiteres Skript hinzuzufügen.
      2. Benennen Sie das Skript Task Mining-Bereitstellung .
      3. Wählen Sie aus Skript Registerkarte und geben Sie das folgende Skript ein: 
        #!/bin/bash
APP_PATH="/Applications/Task Mining Agent.app"

if [ ! -d "$APP_PATH" ]; then
    echo "taskmining is not installed -> triggering install via Jamf policy"
    if ! jamf policy -event taskmining_provisioning; then
        echo "error triggering jamf policy"
        exit
    fi
else
    echo "taskmining app already installed"
fi
      4. Wählen Sie Speichern.
    6. Erstellen Sie die Installationsrichtlinie.
      1. Im JAMF Computer Kategorie, navigieren Sie zu Inhaltsmanagement > Richtlinien Und wählen Sie aus Neu .
      2. Benennen Sie die Richtlinie Task Mining-Installationsprogramm .
      3. Unter Auslöser , Auswählen Anwenderdefiniert Und Eingabetaste TaskMining_Provisioning In Anwenderdefiniertes Ereignis Feld.
      4. Festgelegt Ausführungshäufigkeit Bis Läuft .
      5. Wählen Sie Speichern.
      6. Unter Umfang Registerkarte auswählen Hinzufügen , Wählen Sie die Zielcomputer oder -Gruppen aus, und wählen Sie aus Fertig .
      7. Wählen Sie in der Sidebar aus Optionen > Pakete > Konfigurierenan.
      8. Wählen Sie Aus Hinzufügen Neben dem Task Mining-Agenten-Paket.
      9. In der Sidebar Skripts Und Konfigurieren .
      10. Suchen Task Mining-Skript (Nicht Aufgaben-Mining-Bereitstellung), und wählen Sie aus Hinzufügen .
      11. Unter Priorität , Auswählen Vor .
      12. Fügen Sie die Instanz-URL in ein Parameter 4 Und den Registrierungsschlüssel in Parameter 5 .
      13. Wählen Sie Speichern.
    7. Erstellen Sie die Bereitstellungsrichtlinie.
      1. Navigieren zu Inhaltsmanagement > Richtlinien Und wählen Sie aus Neu .
      2. Benennen Sie die Richtlinie Task Mining-Bereitstellung .
      3. Unter Auslöser , Auswählen Starten , Melden Sie Sich An , Und Wiederkehrender Check-in .
      4. Festgelegt Ausführungshäufigkeit Bis Läuft .
      5. In Umfang Fügen Sie die gleichen Bereitstellungsziele wie die Installationsrichtlinie hinzu.
      6. Wählen Sie in der Sidebar aus Skripts Und Konfigurieren .
      7. Suchen Task Mining-Bereitstellung (Kein Task Mining-Skript), und wählen Sie aus Hinzufügen .
        Es sind keine Parameter erforderlich.
      8. Fügen Sie dieser Richtlinie kein Paket hinzu.
      9. Wählen Sie Speichern.
    8. Erstellen Sie das Konfigurationsprofil.
      1. Im JAMF Computer Kategorie, navigieren Sie zu Inhaltsmanagement > Konfigurationsprofile Und wählen Sie aus Neu .
      2. Benennen Sie das Profil Task Mining .
      3. Wählen Sie in der Sidebar aus Richtliniensteuerung Für Datenschutzeinstellungen Und wählen Sie aus Konfigurieren .
      4. Geben Sie die folgenden Werte ein, und wählen Sie aus Paket-ID Von Bezeichnertyp Liste:
        • Bezeichner : com.servicenow.taskmining.agent
        • Codeanforderung : 
          identifier "com.servicenow.taskmining.agent" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = AS2BZHDV7Q
        Hinweis:
        Die Codeanforderung ist ein statischer Wert. Führen Sie den folgenden Terminalbefehl aus, um ihn zu erhalten: codesign – dr – ./Task\ Mining\ Agent.App
      5. Wählen Sie Hinzufügen.
      6. Unter App oder Service , Auswählen Barrierefreiheit .
      7. Unter Zugriff , Auswählen Zulassen .
      8. Wählen Sie Aus Speichern Wählen Sie für die Barrierefreiheitsberechtigung aus Speichern Erneut unten auf der Seite für das gesamte Profil.
    9. Markieren Sie den Daemon als verwaltetes Anmeldeelement.
      1. Wählen Sie im Konfigurationsprofil aus Verwaltete Anmeldelemente .
      2. Fügen Sie eine Regel mit den folgenden Werten hinzu:
        • Regelbezeichnung : com.servicenowtaskmining.daemon
        • Teambezeichner : AS2BZHDV7Q
        Hinweis:
        Der Teambezeichner ist derselbe Wert wie der Betreff.OU In der Codeanforderung aus dem vorherigen Schritt.
      3. Wählen Sie Speichern.

    Nächste Maßnahme

    Um Richtlinien auf einem macOS-Gerät zu debuggen, können Sie sie manuell über das Terminal auslösen. Der Richtlinienbezeichner ist der ID-Wert in der JAMF-URL beim Bearbeiten dieser Richtlinie.
    sudo jamf policy -id policy-id