> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Übersicht über Custom Apps

> Übersicht über Custom Apps in Iru Endpoint für Mac und Windows. Erfahren Sie mehr über unterstützte Paketformate, Installationsskripte, Bereitstellungsoptionen und Versionierung.

<Callout icon="list-check" color="#B84A7A" iconType="regular">Custom App Library Items sind für Mac-Computer und Windows-Computer verfügbar</Callout>

Mit Iru Endpoint können Sie benutzerdefinierte Anwendungen hochladen und auf Ihren registrierten Geräten bereitstellen. Verwenden Sie das Library Item **Mac Custom App** für Mac-Computer oder das Library Item **Windows Custom App** für Windows-Computer. Bei beiden können Sie wählen, ob die App einmal pro Gerät installiert oder kontinuierlich durchgesetzt wird, und beide unterstützen eine maximale Upload-Größe von **5 GB**.

### Was sind Custom Apps?

Custom Apps sind installerbasierte Library Items, die Sie in der Library hochladen und konfigurieren. Sie weisen sie Blueprints zu, um sie auf Mac- oder Windows-Computern bereitzustellen. Zu den Optionen gehören die einmalige Installation pro Gerät, die kontinuierliche Durchsetzung oder (auf dem Mac) das Anbieten der App in Self Service.

### Nach Plattform

Wählen Sie unten Ihre Plattform aus, um Informationen zu Installer-Typen, Konfigurationsoptionen und Schritt-für-Schritt-Anleitungen zu erhalten.

<Tabs>
  <Tab title="Mac" icon="apple" iconType="brands">
    Mit dem Library Item **Mac Custom App** können Sie benutzerdefinierte Anwendungen (PKG, DMG, ZIP) auf Mac-Computern bereitstellen. Laden Sie Installer hoch, konfigurieren Sie Audit- und Installationsoptionen (einschließlich Pre- und Post-Install-Skripten) und weisen Sie das Library Item Blueprints zu. Sie können Apps über Self Service anbieten oder sie beim Check-in automatisch durchsetzen. Die folgenden Abschnitte behandeln unterstützte Installer-Typen, Ausführungsoptionen, Skripte, Self Service und Fehlerbehebung.

    ### Installer

    Iru Endpoint unterstützt mehrere Installer-Typen für Mac:

    * **.PKG**: Iru Endpoint unterstützt komprimierte PKG- und MPKG-Dateien.
    * **.ZIP**: Bei ZIP-Dateien können Sie angeben, wohin der Inhalt entpackt werden soll.
    * **.DMG**: DMG-Dateien werden in den Ordner /Applications extrahiert. Wenn Ihre DMG ein PKG enthält, extrahieren Sie zuerst das PKG und laden Sie stattdessen dieses hoch.

    <Note>
      Die maximale Datei-Upload-Größe von Iru Endpoint beträgt 5 GB.
    </Note>

    ### Installationsoptionen

    #### Ausführungshäufigkeit

    Je nach der App, die Sie bereitstellen möchten, können Sie festlegen, ob Iru Endpoint sie einmal installieren oder kontinuierlich überwachen und ihre Installation sicherstellen soll.

    * **Einmal pro Gerät installieren**: Iru Endpoint installiert die Custom App einmal. Wenn die App vom Mac entfernt wird, wird sie nicht automatisch neu installiert. Verwenden Sie diese Option für Software-Patches, die nicht kontinuierlich ausgeführt werden sollen.

      * Wenn ein Pre-Install-Skript fehlschlägt, versucht der Iru Agent nicht, die Custom App zu installieren, und führt dieses Custom App Library Item beim nächsten Check-in erneut aus.
      * Wenn ein Post-Install-Skript fehlschlägt, führt der Iru Agent dieses Custom App Library Item beim nächsten Check-in erneut aus, unabhängig davon, ob die Custom App erfolgreich installiert wurde.
    * **Audit and enforce**: Iru Endpoint führt das Audit-Skript bei jedem Check-in aus, auch vor der ersten Installation, und stellt sicher, dass es erfolgreich ist (Exit-Code 0). Wenn das Audit-Skript mit einem anderen Wert als 0 beendet wird, installiert Iru Endpoint die Anwendung automatisch neu.
    * **Bei Bedarf aus Self Service installieren**: Das Element wird nur als optionale Installation in Self Service angeboten. Nach der Ausführung wird die Schaltfläche **Install** zu **Reinstall**.

    #### Überlegungen zum Audit-Skript

    Mit Audit-Skripten legen Sie fest, was als erfolgreich gilt. Muss sich die App an einem bestimmten Ort befinden? Eine bestimmte Prüfsumme haben? Eine bestimmte Version aufweisen? All dies können Sie mit einem Audit-Skript prüfen.

    Beispiel: Dieses Audit-Skript prüft, ob eine App vorhanden ist; ist sie nicht vorhanden, veranlasst das Skript Iru, sie neu zu installieren.

    ```bash audit-app-presence.sh icon="terminal" lines theme={null}
    #!/bin/bash
    APPPATH="/Applications/zoom.us.app"
    if [ -e "$APPPATH" ]; then
    exit 0
    else
    exit 1
    fi
    ```

    Um eine bestimmte Version einer installierten App durchzusetzen, verwenden Sie das [Minimum Enforced Version-Skript](https://github.com/kandji-inc/support/blob/main/Scripts/audit-enforce-scripts/minimum_enforced_version.zsh), das in unserem [Iru Support GitHub](https://github.com/kandji-inc/support/) verfügbar ist.

    #### Pre- und Post-Install-Skripte

    Mit Pre- und Post-Install-Skripten können Sie den Installationsprozess für Custom Apps anpassen. Verwenden Sie ein Pre-Install-Skript, um eine andere App zu entfernen, die ersetzt wird. Ein Post-Install-Skript kann die gerade installierte Custom App konfigurieren.

    #### Überlegungen zu Self Service

    Bei der Verwendung von Custom Apps mit Self Service gibt es wichtige Punkte zu beachten.

    * Wenn die Durchsetzungsoption einer Custom App auf **Installieren und fortlaufend erzwingen** oder **Einmal pro Gerät installieren** gesetzt ist, können Sie dieses Element trotzdem in Self Service anzeigen. Dies ist nützlich, wenn Benutzer die Software neu installieren müssen.
    * Wenn die Option **Enforcement** einer Custom App auf **Bei Bedarf aus Self Service installieren** gesetzt ist, wird die App erst installiert, wenn der Benutzer sie über Self Service installiert.

      * Bei der Installation über Self Service wird die neueste Version der App installiert.
      * Iru Endpoint übernimmt automatisch die Verwaltung von nicht über den App Store lizenzierten Apps, wenn **Bei Bedarf aus Self Service installieren** eingestellt ist (sofern die Bundle-ID mit der Apps and Books-Version übereinstimmt). Ihre globalen oder app-spezifischen Update-Einstellungen werden berücksichtigt.

    #### Neustart

    Einige Anwendungen erfordern nach der Installation einen Neustart, um korrekt zu funktionieren. Iru Endpoint kann den Neustart auslösen, um die ordnungsgemäße Funktion sicherzustellen. Aktivieren Sie das Kontrollkästchen **Nach erfolgreicher Installation neu starten**, damit Iru Endpoint den Computer nach der Installation der Custom App neu startet.

    <Note>
      Benutzer erhalten einen 30-minütigen Countdown, bevor der Neustart erfolgt.
    </Note>

    #### Liftoff-Einstellungen

    Erweitern Sie unten in der Mac Custom App die **Advanced Settings**. Unter **Liftoff-Einstellungen** finden Sie **Dieses Library Item verarbeiten**. Diese Einstellung legt fest, wann die App relativ zu [Iru Liftoff](/de/endpoint/library/library-items-profiles/configure-the-liftoff-library-item) installiert wird. Sie gilt für Automated Device Enrollment und manuelle Registrierung.

    * **During Liftoff** (Standard): Die Custom App wird während Liftoff verarbeitet, und Liftoff wird erst abgeschlossen, wenn sie fertig ist. Sie erscheint auf dem Install-Bildschirm, sofern nicht **In Liftoff ausblenden** ausgewählt ist.
      * **In Liftoff ausblenden**: Wenn ausgewählt, wird dieses Library Item weiterhin während Liftoff verarbeitet, aber nicht auf dem Install-Bildschirm angezeigt. Während der Verarbeitung zeigt Liftoff unten auf dem Bildschirm **Zusätzliche erforderliche Konfigurationen werden verarbeitet, bevor es weitergeht…** an. Diese Einstellung hat keinen Einfluss auf die Reihenfolge.
      * **Friendly name** (optional): Wenn angegeben, zeigt Liftoff diesen Namen anstelle des **Name** des Library Item an. Der Iru Agent ordnet Library Items beim Check-in weiterhin nach **Name**.
    * **Nach Liftoff**: Die Custom App wird nicht während Liftoff verarbeitet und erscheint nicht auf dem Install-Bildschirm. Sie wird bei einem späteren Agent-Check-in installiert.

    <Note>
      Wenn diese Custom App auch unter **Library Items während des Systemassistenten installieren** im [Automated Device Enrollment Library Item](/de/endpoint/enrollment/apple/configuring-apple-enrollment#install-library-items-during-setup-assistant) enthalten ist, wird sie weiterhin während des Setup-Assistenten installiert. **Dieses Library Item verarbeiten** ändert diese Installation nicht.
    </Note>

    #### Status

    Die Registerkarte Status in einem Custom App Library Item zeigt, welche Mac-Geräte auf die Installation der App warten, welche erfolgreich installiert wurden und welche sich nach Installationsproblemen im Status **Fehler** befinden. Der Status **Fehler** erzeugt eine Warnung; Details finden Sie in unserem Support-Artikel [Global Alerts](/de/endpoint/devices/global-alerts).

    ### Schritt-für-Schritt-Anleitung

    Eine Schritt-für-Schritt-Anleitung finden Sie unter [Mac Custom App Library Item konfigurieren](/de/endpoint/library/library-items-profiles/configure-the-custom-apps-library-item).

    ### Fehlerbehebung

    <AccordionGroup>
      <Accordion title="Gatekeeper-Warnung bei der Installation aus einer ZIP-Datei">
        Wenn die ZIP-Datei ein Paket enthält und Sie während der Installation der Custom App auf einem Mac eine Gatekeeper-Warnung sehen, führen Sie diesen Befehl in einer Terminal-Sitzung für das Paket aus, um das Quarantäne-Bit zu entfernen, bevor Sie die Installationsdatei zippen und in Iru hochladen.

        ```bash clear-quarantine.sh icon="terminal" theme={null}
        xattr -dr com.apple.quarantine "/path/to/package.pkg"
        ```
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Windows" icon="microsoft" iconType="brands">
    Mit dem Library Item **Windows Custom App** können Sie Windows-Anwendungen (MSI, EXE) auf Windows-Computern bereitstellen und verwalten. Laden Sie einen gezippten Installer hoch, konfigurieren Sie Installations- und Deinstallationsbefehle, definieren Sie die Erkennungslogik und weisen Sie das Library Item Blueprints zu. Der gezippte Installer kann einzelne Dateien oder Verzeichnisse mit Dateien enthalten. Die Durchsetzung beginnt für Online-Geräte innerhalb von 15 Minuten. Alle Installer werden im Systemkontext ausgeführt. Die folgenden Abschnitte behandeln Installer, Durchsetzungs- und Erkennungseinstellungen, Befehle, Architektur, Sicherheit und Fehlerbehebung.

    Was Endbenutzer sehen, wenn ausstehende Updates für **Auto App** oder **Windows Custom App** verfügbar sind, einschließlich der Liste **Aktualisierungen** in der Iru-Taskleisten-App und [wann eine laufende App zuerst geschlossen werden muss](/de/endpoint/library/library-items-profiles/user-experience-with-windows-apps#when-an-app-must-close), erfahren Sie unter [Benutzererfahrung mit Windows-Apps](/de/endpoint/library/library-items-profiles/user-experience-with-windows-apps#app-updates-in-the-iru-system-tray).

    ### Installer

    Laden Sie eine **.zip**-Datei hoch, die den Installer (MSI oder EXE) und alle unterstützenden Dateien oder Ordner enthält. Der Installer wird auf das Gerät heruntergeladen und lokal entpackt, bevor der Installationsbefehl ausgeführt wird, sodass die Installation zum Ausführungszeitpunkt nicht von der Netzwerkverfügbarkeit abhängt. Uploads können fortgesetzt werden; bei einer Netzwerkunterbrechung wird der Upload an der Stelle fortgesetzt, an der er unterbrochen wurde.

    <Note>
      Die maximale Datei-Upload-Größe von Iru Endpoint beträgt 5 GB.
    </Note>

    ### Installationsoptionen

    Steuert, wie Iru die App auf den Zielgeräten durchsetzt.

    * **Einmal pro Gerät installieren**: Iru installiert die App auf Geräten, auf denen sie noch nicht vorhanden ist. Nach der Installation installiert Iru die App nicht erneut, wenn ein Benutzer sie manuell entfernt.
    * **Installieren und fortlaufend erzwingen** (Standard): Iru installiert die App und installiert sie neu, wenn sie entfernt oder bei späteren Check-ins als nicht vorhanden erkannt wird.

    ### Durchsetzungszeitraum

    Steuert, ob diese Version der App sofort oder nach einer Kulanzfrist durchgesetzt wird. Setzen Sie **Enforcement deadline** auf eine der folgenden Optionen:

    * **Immediately** (Standard): Die App wird so bald wie möglich nach der Zuweisung durchgesetzt. Neue Installationen beginnen für Online-Geräte innerhalb von 15 Minuten.
    * **By enforcement deadline**: Die App versucht, bis zur Durchsetzungsfrist zu installieren, wenn die App nicht geöffnet ist. Bei Erreichen der Frist wird die Installation auf Geräten, auf denen sie noch nicht installiert wurde, verpflichtend.

    Wenn **By enforcement deadline** ausgewählt ist, erscheinen zwei zusätzliche Felder:

    * **Enforcement after version is saved**: Wie lange nach dem Speichern des Library Item die Durchsetzung beginnt. Standard: **2 weeks**.
    * **Enforcement deadline time**: Die Uhrzeit, zu der die Durchsetzung am Fristdatum wirksam wird. Standard: **12:00 PM (Noon)**.

    ### Anwendungsdetails

    * **Herausgeber**: Die Organisation oder Person, die die Anwendung erstellt hat.
    * **Name**: Der Anzeigename der Anwendung. Wird in der Library und in Gerätestatusansichten angezeigt.
    * **Version**: Eine Versionszeichenfolge für diese Version der App. Freitext; wird nicht anhand semantischer Versionierung validiert.
    * **App icon**: Laden Sie ein `.png`-Bild hoch, das die App in der Library darstellt. Ziehen Sie die Datei in den Upload-Bereich oder wählen Sie **choose file**.
    * **Upload app**: Laden Sie eine `.zip`-Datei hoch, die den Installer und alle unterstützenden Dateien oder Ordner enthält. Ziehen Sie die Datei in den Upload-Bereich oder wählen Sie **choose file**.
      * Die ZIP-Datei muss den Installer (MSI, EXE) sowie alle Dateien enthalten, auf die Ihr Installationsbefehl verweist.
      * Strukturieren Sie die ZIP-Datei so, dass relative Pfade in Ihrem Installationsbefehl korrekt aufgelöst werden, sobald der Inhalt auf dem Gerät entpackt ist.

    ### Erkennungslogik

    Die Erkennungslogik teilt Iru mit, ob die Anwendung auf einem Gerät vorhanden ist. Mindestens eine Erkennungsmethode ist erforderlich. Iru führt die Erkennung beim Check-in des Agent aus, um festzustellen, ob die App installiert werden muss oder bereits vorhanden ist.

    Wählen Sie im Dropdown-Menü **Detection logic rules** einen Erkennungstyp aus. Die Optionen erscheinen von oben nach unten als **MSI**, **File**, **Folder** und dann **Registry**.

    #### MSI

    Erkennt anhand des Product Code, ob ein bestimmtes MSI-Paket installiert ist.

    * **MSI product code**: Der Product Code des Pakets als GUID in geschweiften Klammern, `{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}`. Die Web App validiert das Format. Den Code finden Sie in den MSI-Eigenschaften oder in der Dokumentation des Produkts.
    * **Check MSI product version**: Bei **Nein** wird nur der Product Code ausgewertet. Bei **Ja** wird zusätzlich die installierte Produktversion mit einem Operator **equals** oder **is greater than or equal to** und der von Ihnen eingegebenen Versionszeichenfolge verglichen.

    #### File

    Erkennt anhand einer Datei unter einem von Ihnen angegebenen Pfad.

    * **Path to file**: Vollständiger Pfad zur Datei einschließlich des Dateinamens (zum Beispiel `C:\Program Files\YourApp\YourApp.exe`).
    * **Detection method**: Wählen Sie, wie die Datei ausgewertet wird:
      * **File exists**: Erfolgreich, wenn die Datei unter dem angegebenen Pfad gefunden wird.
      * **File does not exist**: Erfolgreich, wenn die Datei nicht gefunden wird. Zur Erkennung von Deinstallationen verwenden.
      * **Version**: Erfolgreich, wenn die Version der Datei den Vergleich erfüllt. Setzen Sie den Operator auf **equals** oder **is greater than or equal to** und geben Sie dann die Versionszeichenfolge ein.
      * **Size in MB**: Erfolgreich, wenn die Dateigröße in Megabyte den Vergleich erfüllt. Setzen Sie den Operator auf **equals** oder **is greater than or equal to** und geben Sie dann die Größe ein.

    #### Folder

    Erkennt anhand eines Ordners unter einem von Ihnen angegebenen Pfad.

    * **Path to folder**: Vollständiger Verzeichnispfad, unter dem der Ordner erwartet wird (zum Beispiel `C:\Program Files\YourApp`).
    * **Erkennungsmethode**:
      * **Folder exists**: Erfolgreich, wenn der Ordner unter dem angegebenen Pfad gefunden wird.
      * **Folder does not exist**: Erfolgreich, wenn der Ordner nicht gefunden wird.

    #### Registry

    Erkennt die App anhand eines Registrierungsschlüssels oder -werts.

    * **Key path**: Erforderlich. Vollständiger Registrierungspfad, der geprüft werden soll (zum Beispiel `HKLM\SOFTWARE\YourApp`). Bei Pfaden wird nicht zwischen Groß- und Kleinschreibung unterschieden.
    * **Wert**: Optionaler Name eines Registrierungswerts innerhalb des Schlüssels.
    * **Erkennungsmethode**:
      * **Key exists**: Erfolgreich, wenn der Schlüssel vorhanden ist. Wenn Sie einen **Wert** angegeben haben, muss der Wert unter diesem Schlüssel vorhanden sein.
      * **String comparison**: Erfolgreich, wenn der Wert im Schlüssel mit der von Ihnen angegebenen Zeichenfolge übereinstimmt.

    ### Ausführbare Dateien zur Erkennung geöffneter Apps

    * Geben Sie pro Feld einen Namen einer ausführbaren Datei ein (zum Beispiel `yourapp.exe`). Iru prüft diese Prozesse bei der Installation oder Deinstallation, damit Benutzer aufgefordert werden können, sie zu schließen.
    * Verwenden Sie **Hinzufügen** für weitere Zeilen und entfernen Sie Zeilen bei Bedarf mit dem Löschsteuerelement.
    * Es können bis zu 100 ausführbare Dateien eingegeben werden.

    ### Befehle

    Die Web App bezeichnet diese als **Install command line parameters** und **Uninstall command line parameters**. Geben Sie Befehlszeilen für die stille Installation und stille Deinstallation ein.

    **Installationsbefehl**

    Die vollständige Befehlszeile, mit der die Anwendung still installiert wird. Für MSI-Pakete sieht eine standardmäßige stille Installation so aus:

    ```powershell icon="terminal" theme={null}
    msiexec /i yourapp.msi /qn
    ```

    Wenn Ihr Installer unterstützende Dateien oder Ordner in der ZIP-Datei enthält, verweisen Sie mit relativen Pfaden darauf. Zum Beispiel:

    ```powershell icon="terminal" theme={null}
    msiexec /i lance.msi TRANSFORMS=".\mytransforms\transform.mst" /qn
    ```

    Sie können ein PowerShell-Skript aus der ZIP-Datei ausführen, statt msiexec direkt aufzurufen. Das Skript muss den Installer still ausführen.

    ```powershell icon="terminal" theme={null}
    .\installapp.ps1
    ```

    **Deinstallationsbefehl**

    Die vollständige Befehlszeile, mit der die Anwendung entfernt wird. Für MSI-Pakete:

    ```powershell icon="terminal" theme={null}
    msiexec /x {ProductCode} /qn
    ```

    <Note>
      Wenn der Pfad zum Installer, Deinstaller oder Skript in Ihrem Installations- oder Deinstallationsbefehl Leerzeichen enthält, setzen Sie diesen Pfad in doppelte Anführungszeichen (zum Beispiel `"my installer.exe"`).
    </Note>

    ### Architektur

    Wählen Sie unter **Architecture** **x64** oder **arm64** für den Installer. Wenn MSI-Metadaten verfügbar sind, versucht Iru, den richtigen Wert automatisch zu erkennen. Bestätigen oder überschreiben Sie die Auswahl vor dem Speichern.

    ### Durchsetzungsverhalten

    * Die Durchsetzung beginnt für Online-Geräte innerhalb von **15 Minuten** nach der Zuweisung. Bei neuen Installationen bedeutet dies, dass der Download innerhalb dieses Zeitfensters beginnt; die Installationsdauer hängt von der Dateigröße und der Geräteleistung ab.
    * Wenn eine Installation oder Deinstallation fehlschlägt, versucht Iru es alle 15 Minuten erneut.
    * Der Installer wird bei einem erneuten Versuch nicht erneut heruntergeladen, es sei denn, die Datei auf dem Server hat sich geändert.
    * Das Entfernen des Library Item oder der Blueprint-Zuweisung deinstalliert die App **nicht** von den Geräten. Die App bleibt auf dem Gerät; nur die Durchsetzung endet.

    Wenn Fehler bei der Installation oder Deinstallation Warnungen in Iru Endpoint erzeugen, finden Sie Details in unserem Support-Artikel [Global Alerts](/de/endpoint/devices/global-alerts).

    ### Sicherheit

    * **Hash-Überprüfung**: Iru überprüft den SHA-256-Hash des Installers, bevor der Installationsbefehl ausgeführt wird. Wenn der Hash nicht übereinstimmt, schlägt die Installation sofort fehl.
    * **Verschlüsselte Übertragung**: Installer-Dateien werden über HTTPS übertragen. Nur Geräte, auf die das Library Item abzielt, können den Installer herunterladen.

    ### Überlegungen

    * Das Entfernen eines Library Item oder einer Blueprint-Zuweisung deinstalliert die App nicht. Apps bleiben auf dem Gerät und werden nicht mehr durchgesetzt.
    * Die Installer-ZIP-Datei wird vor der Ausführung auf dem Gerät entpackt. Stellen Sie sicher, dass relative Pfade in Ihrem Installationsbefehl der Ordnerstruktur in Ihrer ZIP-Datei entsprechen.
    * Wenn mehrere Apps gleichzeitig auf ein Gerät abzielen, wird die Durchsetzung in eine Warteschlange gestellt. Das 15-Minuten-SLO gilt für den Downloadbeginn der ersten App in der Warteschlange.

    ### Best Practices

    <CardGroup cols={2}>
      <Card title="MSI-Erkennung für MSI-Pakete verwenden" icon="check">
        Bei MSI-basierten Installern identifiziert der Product Code das installierte Paket unabhängig vom Installationspfad.
      </Card>

      <Card title="Installations- und Deinstallationsbefehle vor der Bereitstellung testen" icon="flask">
        Führen Sie Ihre Installations- und Deinstallationsbefehle manuell auf einem Testgerät aus, bevor Sie sie in Iru hochladen. Stille Flags, die bei einem Installer-Typ funktionieren, funktionieren möglicherweise bei einem anderen nicht; validieren Sie sie vor der Bereitstellung für die Geräteflotte.
      </Card>

      <Card title="ZIP-Struktur an Ihren Befehl anpassen" icon="folder">
        Wenn Ihr Installationsbefehl mit relativen Pfaden auf unterstützende Dateien verweist, stellen Sie sicher, dass die Ordnerstruktur der ZIP-Datei genau diesen Pfaden entspricht. Eine Abweichung führt dazu, dass die Installation fehlschlägt.
      </Card>

      <Card title="Zuerst mit einer Pilotgruppe testen" icon="users">
        Weisen Sie das Library Item einem kleinen Blueprint mit Testgeräten zu, bevor Sie es auf Ihre gesamte Geräteflotte ausweiten. Überprüfen Sie, ob Installation, Erkennung und Berichterstattung wie erwartet funktionieren.
      </Card>

      <Card title="Erkennung spezifisch halten" icon="bullseye">
        Zu weit gefasste Erkennungsregeln (zum Beispiel die Prüfung auf einen Ordner, den mehrere Apps gemeinsam nutzen) können zu Fehlalarmen führen. Verwenden Sie die spezifischste verfügbare Erkennungsmethode.
      </Card>
    </CardGroup>

    ### Schritt-für-Schritt-Anleitung

    Eine Schritt-für-Schritt-Anleitung finden Sie unter [Windows Custom App Library Item konfigurieren](/de/endpoint/library/library-items-profiles/configure-the-windows-custom-app-library-item).

    ### Fehlerbehebung

    <AccordionGroup>
      <Accordion title="App wird auf Zielgeräten nicht installiert">
        **Mögliche Ursachen:**

        * Library Item ist dem Blueprint des Geräts nicht zugewiesen
        * Zielgeräte haben in letzter Zeit nicht eingecheckt

        **Lösungen:**

        * Stellen Sie sicher, dass das Library Item dem richtigen Blueprint zugewiesen ist und die Zielgeräte innerhalb der letzten 15 Minuten eingecheckt haben
        * Prüfen Sie die Statusansicht pro Gerät auf Exit-Codes oder Fehlermeldungen
      </Accordion>

      <Accordion title="Installation schlägt mit einem Fehlercode fehl">
        Überprüfen Sie den Exit-Code in der Statusansicht pro Gerät. Häufige MSI-Exit-Codes sind:

        * **1603**: Allgemeiner Fehler, häufig verursacht durch eine bereits laufende App, unzureichenden Speicherplatz oder ein Berechtigungsproblem.
        * **1618**: Eine andere Installation wird bereits ausgeführt. Der Agent versucht es erneut.
        * **1638**: Eine neuere Version der App ist bereits installiert. Überprüfen Sie Ihre Erkennungslogik und Ihren Upgrade-Pfad.
      </Accordion>

      <Accordion title="Erkennung stimmt nach erfolgreicher Installation nicht überein">
        **Mögliche Ursachen:**

        * Die Erkennungsregel entspricht nicht dem tatsächlichen Installationszustand
        * Falscher Product Code, Pfad oder Registrierungswert

        **Lösungen:**

        * Überprüfen Sie bei MSI-Paketen, ob der Product Code korrekt ist
        * Bestätigen Sie bei Datei- oder Registrierungserkennung den Pfad und den Wert genau so, wie sie nach der Installation erscheinen
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Mac Custom App Library Item konfigurieren" icon="apple" href="/de/endpoint/library/library-items-profiles/configure-the-custom-apps-library-item">
    Schritt-für-Schritt-Einrichtung für Mac Custom Apps (PKG, DMG, ZIP)
  </Card>

  <Card title="Windows Custom App Library Item konfigurieren" icon="microsoft" href="/de/endpoint/library/library-items-profiles/configure-the-windows-custom-app-library-item">
    Schritt-für-Schritt-Einrichtung für Windows Custom Apps (MSI, EXE)
  </Card>

  <Card title="Library-Übersicht" icon="books" href="/de/endpoint/library/library-items-profiles/library-overview">
    Library Items kuratieren, erstellen und verwalten und zu Blueprints hinzufügen
  </Card>

  <Card title="Self Service: Library Items" icon="box" href="/de/endpoint/settings/self-service/self-service-library-items">
    Library Items für Self Service konfigurieren (macOS)
  </Card>

  <Card title="Globale Warnungen" icon="bell" href="/de/endpoint/devices/global-alerts">
    Konfigurieren, wie Iru Endpoint Warnungen anzeigt, wenn Custom Apps oder andere Library Items Probleme melden
  </Card>
</CardGroup>
