Hinzufügen einer nicht verwalteten macOS-PKG-App zu Microsoft Intune

Verwenden Sie die Informationen in diesem Artikel, um eine nicht verwaltete macOS PKG-App zu Microsoft Intune hinzuzufügen. Informationen zum Bereitstellen einer verwalteten PKG-App finden Sie unter Hinzufügen von branchenspezifischen macOS-Apps zu Microsoft Intune.

Voraussetzungen

Die folgenden Voraussetzungen müssen erfüllt sein, bevor eine nicht verwaltete macOS PKG-App auf macOS-Geräten installiert wird.

  • Geräte werden von Intune verwaltet.
  • Die PKG-Datei ist kleiner als 8 GB.
  • Der Microsoft Intune-Verwaltungs-Agent für macOS, Version 2308.006 oder höher, ist installiert.
  • Die PKG-Datei wird mithilfe des installer Befehls im Terminal erfolgreich ausgeführt.

Wichtige Überlegungen zur Bereitstellung von PKG-Apps

Der App-Typ "Nicht verwaltetes macOS PKG" kann die folgenden Arten von PKG-Apps installieren:

  • Nonflat packages with a hierarchical structure
  • Komponentenpakete
  • Unsignierte Pakete
  • Pakete ohne Nutzlast
  • Pakete, mit denen Apps außerhalb installiert werden /Applications/
  • Benutzerdefinierte Pakete mit Skripts

Hinweis

Diese Arten von PKG-Apps können möglicherweise nicht mit dem App-Typ "Verwaltete Branchen" bereitgestellt werden.

Die enthaltenden App-Dateien können der Reihe nach im Abschnitt "Enthaltene Apps " auf der Registerkarte " Erkennungsregeln " aufgelistet werden, beginnend mit der übergeordneten App, die in Berichten verwendet werden soll.

Wählen Sie den App-Typ aus.

  1. Melden Sie sich beim Microsoft Intune Admin Center an.
  2. Wählen Sie "Apps>, die alle Apps>erstellen" aus.
  3. Wählen Sie im Bereich "App-Typ auswählen " die macOS-Plattform und dann die Option macOS-App (PKG) aus.
  4. Klicken Sie auf Auswählen. Die Schritte zum Hinzufügen von Apps werden angezeigt.

Schritt 1 – App-Informationen

Wählen Sie die App-Paketdatei aus:

  1. Klicken Sie im Bereich App hinzufügen auf App-Paketdatei auswählen.
  2. Wählen Sie im Bereich "App-Paketdatei " die Schaltfläche "Durchsuchen" aus. Wählen Sie dann eine macOS-PKG-Datei mit der Erweiterung .pkg aus. Die App-Details werden angezeigt.
  3. Wenn Sie fertig sind, wählen Sie im Bereich "App-Paketdatei" die Option "OK" aus, um die App hinzuzufügen.

Festlegen von App-Informationen

  1. Fügen Sie auf der Seite "App-Informationen " die Details für Ihre App hinzu. Je nach der ausgewählten App werden einige der Werte in diesem Bereich möglicherweise automatisch ausgefüllt.

    • Name: Geben Sie den Namen der App so ein, wie er im Richtliniennamen und im Unternehmensportal angezeigt wird. Stellen Sie sicher, dass alle App-Namen eindeutig sind. Wenn ein App-Name zweimal vergeben wird, wird im Unternehmensportal nur eine der Apps angezeigt.
    • Beschreibung: Geben Sie eine Beschreibung für die App ein. Die Beschreibung wird im Unternehmensportal angezeigt.
    • Herausgeber: Geben Sie den Namen des Herausgebers der App ein.
    • Kategorie: Wählen Sie eine der integrierten oder von Ihnen erstellten App-Kategorien aus. Kategorien erleichtern es Benutzern, die App über das Unternehmensportal zu finden.
    • Informations-URL: Geben Sie optional eine URL zu einer Website ein, die Informationen über diese App enthält. Die URL wird im Unternehmensportal angezeigt.
    • URL zu den Datenschutzbestimmungen: Geben Sie optional eine URL zu einer Website ein, die Datenschutzinformationen für diese App enthält. Die URL wird im Unternehmensportal angezeigt.
    • Entwickler: Geben Sie optional den Namen des App-Entwicklers ein.
    • Besitzer: Geben Sie optional einen Namen für den Besitzer dieser App ein. Ein Beispiel ist Personalabteilung.
    • Anmerkungen: Geben Sie optional Anmerkungen zu dieser App ein.
    • Logo: Laden Sie ein Symbol hoch, das mit der App verknüpft ist. Dieses Symbol wird mit der App angezeigt, wenn Benutzer das Unternehmensportal durchsuchen.
  2. Wählen Sie "Weiter " aus, um die Anforderungen festzulegen.

Schritt 2 – Programm

Optional können Sie ein Vorinstallationsskript und ein Skript nach der Installation konfigurieren, um die App-Installation anzupassen.

Skript vorinstallieren: Stellen Sie ein Skript bereit, das vor der Installation der App ausgeführt wird. Nur wenn das Vorinstallationsskript 0 (null) zurückgibt (was Erfolg anzeigt), fährt die App mit der Installation fort. Wenn das Vorinstallationsskript einen Code ungleich Null zurückgibt (was auf einen Fehler hinweist), wird die App nicht installiert und meldet ihren InstallationsStatus als "fehlgeschlagen". Das Vorinstallationsskript wird bei fehlgeschlagenen Installationen beim nächsten Geräte-Check-in (Sync) erneut ausgeführt.

Skript nach der Installation: Stellen Sie ein Skript bereit, das nach der erfolgreichen Installation der App ausgeführt wird. Falls angegeben, wird das Skript nach der Installation nach einer erfolgreichen App-Installation ausgeführt. Unabhängig vom Status der Skriptausführung nach der Installation meldet eine installierte App ihren Installationsstatus als "erfolgreich".

Hinweis

  • Jedes Vorinstallations- oder Nachinstallationsskript muss weniger als 15360 Zeichen lang sein.
  • Der Microsoft Intune Management Agent für macOS, Version 2309.007 oder höher, ist erforderlich, um Vorinstallations- und Nachinstallationsskripts für macOS PKG-Apps zu konfigurieren.
  • Weitere Informationen zum Konfigurieren von Skripts vor und nach der Installation finden Sie unter Voraussetzungen für Shellskripts.

Schritt 3 – Anforderungen

Sie können das für die Installation dieser App erforderliche Mindestbetriebssystem auswählen.

Mindestbetriebssystem: Wählen Sie aus der Liste die Mindestversion des Betriebssystems aus, auf der die App installiert werden kann. Wenn Sie die App einem Gerät mit einem früheren Betriebssystem zuweisen, wird sie nicht installiert.

Schritt 4 – Erkennungsregeln

Sie können Erkennungsregeln verwenden, um auszuwählen, wie eine App-Installation auf einem verwalteten macOS-Gerät erkannt wird.

App-Version ignorieren: Wählen Sie Ja aus, um die App zu installieren, wenn die App noch nicht auf dem Gerät installiert ist. Damit wird nur nach dem Vorhandensein der App-Bündel-ID gesucht. Wählen Sie für Apps mit einem automatischen Updatemechanismus Ja aus. Wählen Sie Nein aus, um die App zu installieren, wenn sie noch nicht auf dem Gerät installiert ist oder wenn die Versionsnummer der bereitgestellten App nicht mit der Version übereinstimmt, die bereits auf dem Gerät installiert ist.

Enthaltene Apps: Geben Sie die Apps an, die in der hochgeladenen Datei enthalten sind. Enthaltene App-Bundle-IDs und Buildnummern werden verwendet, um den Status der App-Installation der hochgeladenen Datei zu erkennen und zu überwachen. Die Liste der enthaltenen Apps sollte nur die Anwendung(en) enthalten, die von der hochgeladenen Datei installiert wurden. Alle anderen Dateitypen, bei denen es sich nicht um eine Anwendung handelt, sollten aus der Liste der enthaltenen Apps ausgeschlossen werden. Wenn die Liste der eingeschlossenen Apps Dateien enthält, die keine Anwendungen sind, oder wenn nicht alle aufgelisteten Apps installiert sind, meldet der Status der App-Installation keinen Erfolg.

Hinweis

  • Wenn ein PKG-Paket mehrere Apps enthält, kann nur eine davon in den zugehörigen App-Berichten angezeigt werden.
  • Die erste App-/Paket-ID in der Liste der enthaltenen Apps ist diejenige, über die ein Bericht erstellt wird. Die Liste kann bei Bedarf neu sortiert werden.
  • Im Fall der Intune-Unternehmensportal-App sind viele zusätzliche Bibliotheken im PKG enthalten, die sicher entfernt werden können (mithilfe des Papierkorbsymbols). Dadurch bleibt nur eine einzige App-Bündel-ID übrig: com.microsoft.CompanyPortalMac

Tipp

Das CFBundleIdentifier und CFBundleShortVersionString finden Sie unter der <app_name>.app/Contents/Info.plist Datei einer installierten App auf einem Mac.

Alternativ kann Mac Terminal verwendet werden, um die enthaltenen App-Details einer installierten App an einem bekannten Ort nachzuschlagen und zu bestätigen.

Um beispielsweise die Bündel-ID und die Buildnummer von Unternehmensportal nachzuschlagen, führen Sie Folgendes aus:
defaults read /Applications/Company\ Portal.app/Contents/Info CFBundleIdentifier
Führen Sie dann Folgendes aus:
defaults read /Applications/Company\ Portal.app/Contents/Info CFBundleShortVersionString

Für Apps, die zu Intune hinzugefügt wurden, können Sie das Intune Admin Center verwenden, um die App-Bündel-ID abzurufen.

Schritt 5 – Bereichsmarkierungen auswählen (optional)

Sie können Bereichstags verwenden, um zu bestimmen, wer Client-App-Informationen in Intune anzeigen kann. Ausführliche Informationen zu Bereichstags finden Sie unter Verwenden von rollenbasierter Zugriffssteuerung und Bereichstags für verteilte IT. 1. Klicken Sie auf Bereichstags auswählen , um optional Bereichstags für die App hinzuzufügen. 2. Wählen Sie "Weiter" aus, um die Seite "Aufgaben" anzuzeigen.

Schritt 6 – Aufgaben

Sie können entweder die erforderlichen oder die verfügbaren Gruppenzuweisungen für die App auswählen. Weitere Informationen finden Sie unter Hinzufügen von Gruppen zum Organisieren von Benutzern und Geräten und Zuweisen von Apps zu Gruppen mit Microsoft Intune.

Hinweis

Eine macOS-App, die mit dem Intune-Agent bereitgestellt wird, wird nicht automatisch vom Gerät entfernt, wenn das Gerät zurückgezogen wird. Die App und die darin enthaltenen Daten verbleiben auf dem Gerät. Es wird empfohlen, die App zu entfernen, bevor Sie das Gerät außer Betrieb nehmen.

  1. Wählen Sie für die jeweilige App entweder den Aufgabentyp "Erforderlich" oder "Verfügbar" aus.
  2. Wählen Sie "Weiter " aus, um die Seite "Überprüfen + erstellen" anzuzeigen.

Hinweis

Wenn Sie eine neue Version einer verfügbaren App in Intune hochladen, müssen die Benutzer keine Maßnahmen ergreifen. Die Installation erfolgt automatisch.

Schritt 7 – Überprüfen + erstellen

  1. Überprüfen Sie die Werte und Einstellungen, die Sie für die App eingegeben haben.
  2. Wenn Sie fertig sind, wählen Sie Erstellen aus, um die App zu Intune hinzuzufügen. Der Übersichtsbereich für die macOS PKG-App wird angezeigt.

Die von Ihnen erstellte App wird in der App-Liste angezeigt, wo Sie sie den von Ihnen ausgewählten Gruppen zuweisen können. Hilfe finden Sie unter Zuweisen von Apps zu Gruppen.

Bekannte Probleme

  • Der Zuweisungstyp "Deinstallieren" ist nicht verfügbar. Derzeit werden nur erforderliche und verfügbare Zuweisungen unterstützt.
  • Das Intune-Unternehmensportal zeigt auch nach einer erfolgreichen App-Installation den Status "Ausstehend" an. Insbesondere werden Verfügbare Apps als ausstehend angezeigt, nachdem der Benutzer in der Unternehmensportal-App auf die Schaltfläche Installieren geklickt hat, auch wenn sie erfolgreich installiert wurden. Benutzer können die Installation erneut versuchen, indem sie auf dem lokalen Gerät auf der Registerkarte "Geräte" der Unternehmensportal-App auf "Status überprüfen" klicken. Die Berichterstellung in der Intune Admin Konsole ist von diesem Problem nicht betroffen. Dieses Problem wird derzeit aktiv angegangen, um gelöst zu werden.

Problembehandlung

Die Installation einer macOS-App ist möglicherweise aus einem der folgenden Gründe in der folgenden Tabelle nicht erfolgreich. Führen Sie die Korrekturschritte aus, um diese Fehler zu beheben. Wenn die App zugewiesen bleibt, werden fehlgeschlagene Installationen beim nächsten Einchecken des Agents wiederholt.

Fehlercode Fehlermeldung Schritte zur Fehlerbehebung
0x87D30137 Das Gerät erfüllt nicht die vom Administrator festgelegten Mindestanforderungen an das Betriebssystem. Aktualisieren Sie macOS auf die minimale Betriebssystemversion, die vom Administrator benötigt wird.
2016214710 Das vom Administrator bereitgestellte Vorinstallationsskript ist fehlgeschlagen. Dies ist möglicherweise zu erwarten, wenn das Vorinstallationsskript darauf wartet, dass eine Bedingung erfüllt wird, bevor die App-Installation fortgesetzt werden kann. Das fehlgeschlagene Vorinstallationsskript wird beim nächsten Geräte-Check-in erneut versucht. Überprüfen Sie das Vorinstallationsskript, wenn der Fehler weiterhin besteht.
0x87D3012F, 0x87D30130, 0x87D30133, 0x87D30134, 0x87D30136, Die App konnte aufgrund eines internen Fehlers nicht installiert werden. Wenden Sie sich an den Intune-Support, wenn der Fehler weiterhin besteht. Beim Installieren der App mit Intune ist ein Fehler aufgetreten. Versuchen Sie, die App manuell zu installieren, oder versuchen Sie, ein neues macOS-App-Profil zu erstellen, das die App enthält. Wenden Sie sich an den Intune-Support, wenn der Fehler weiterhin besteht.

Beachten Sie, dass Skriptfehler nach der Installation nicht gemeldet werden. Eine erfolgreiche App-Installation, gefolgt von einem fehlgeschlagenen Skript nach der Installation, meldet den Status der App-Installation als "erfolgreich".

Nächste Schritte