> ## 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.

# Fehlerbehebung bei Agent-Check-ins

> Diagnostizieren und beheben Sie fehlgeschlagene Check-ins des Iru Agent unter macOS und Windows. Beheben Sie Netzwerkprobleme, Zertifikatfehler und Verbindungsprobleme.

<Callout icon="list-check" color="#B84A7A" iconType="regular">Diese Anleitung gilt für Mac-Computer und Windows-Computer</Callout>

### Über Probleme beim Agent-Check-in

In Iru Endpoint registrierte macOS- und Windows-Computer verwenden den Iru Agent für verschiedene Verwaltungsaufgaben. Der Agent versucht, alle 15 Minuten einzuchecken. Wenn ein Gerät nicht wie erwartet eincheckt, können die folgenden Schritte helfen, die Kommunikation wiederherzustellen.

<Note>
  Seit dem **8. April 2026** wurden die Apps vom **Kandji**-Branding <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" /> auf das **Iru**-Branding <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" /> umgestellt. Die App-Namen wurden von **Kandji Self Service** in **Iru Self Service** und von **Kandji Agent** in **Iru Agent** geändert. Das Portal für die manuelle Registrierung verwendet jetzt das Iru-Branding. Bitte aktualisieren Sie **Skripte, Automatisierungen und Dienstprogramme**, die noch auf die alten App-Namen verweisen.
</Note>

### Funktionsweise

Der Iru Agent kommuniziert mit den Iru Endpoint-Servern, um Konfigurationsaktualisierungen, Richtlinienänderungen und Anwendungsbereitstellungen zu empfangen. Wenn Check-ins fehlschlagen, erhalten Geräte möglicherweise wichtige Aktualisierungen nicht, was zu Compliance-Problemen oder veralteten Konfigurationen führen kann.

### Internetverbindung prüfen

Stellen Sie sicher, dass das Gerät über eine aktive Internetverbindung mit Zugriff auf die unter [Iru in Unternehmensnetzwerken verwenden](/de/iru/requirements/using-iru-on-enterprise-networks) aufgeführten Domains und Ports verfügt.

Als schneller Schritt zur Fehlerbehebung:

* Versuchen Sie, das Gerät mit einem anderen Netzwerk zu verbinden, z. B. einem mobilen Hotspot
* Wenn die Check-ins wieder funktionieren, liegt das Problem möglicherweise an der Filter- oder Firewall-Konfiguration des ursprünglichen Netzwerks

### Plattformspezifische Fehlerbehebung

<Tabs>
  <Tab title="macOS" icon="apple" iconType="brands">
    ### Einen Check-in erzwingen (macOS)

    #### Self Service

    * Endbenutzer können **Iru Self Service** öffnen, zu **Device Info** wechseln und **Synchronisieren** auswählen

    #### Befehlszeile

    * Führen Sie den folgenden Befehl im **Terminal** aus, um einen Check-in zu erzwingen:

    ```bash theme={null}
    sudo iru run -F
    ```

    Die Ausgabe kann zusätzliche Details liefern.

    ### Den Iru Agent neu installieren

    Unter macOS können Sie den Iru Agent über die Iru-Web-App neu installieren:

    <Steps>
      <Step title="Gerätedatensatz öffnen">
        Wechseln Sie in der Iru-Web-App zum Gerätedatensatz
      </Step>

      <Step title="Agent neu installieren">
        Wählen Sie im Geräteaktionsmenü **Reinstall Agent**
      </Step>

      <Step title="Installationsstatus überwachen">
        Überwachen Sie den Status auf der Registerkarte **Aktivität**. Achten Sie auf den MDM-Befehl `InstallEnterpriseApplication`
      </Step>
    </Steps>

    <Note>
      Wenn der Befehl **NotNow** zurückgibt (Gerät ist beschäftigt):

      * Stellen Sie sicher, dass auf dem Mac ein Benutzer angemeldet und der Mac an die Stromversorgung angeschlossen ist, und versuchen Sie es dann erneut. Siehe [Entwicklerdokumentation von Apple](https://developer.apple.com/documentation/devicemanagement/implementing_device_management/handling_notnow_status_responses)
    </Note>

    ### Hinweise zum Neustart

    * Nach einem Neustart wartet Iru möglicherweise bis zu 30 Minuten mit dem Check-in, damit macOS Aktualisierungen und Hintergrundaufgaben abschließen kann

    ### Überprüfung des Agent-Status

    Agent-Status prüfen:

    ```bash theme={null}
    sudo iru library --state
    ```
  </Tab>

  <Tab title="Windows" icon="microsoft" iconType="brands">
    ### Einen Check-in erzwingen (Windows)

    #### Iru Agent-Dienst neu starten

    * Klicken Sie mit der rechten Maustaste auf das **Windows**-Symbol und wählen Sie **Ausführen**
    * Geben Sie `services.msc` ein und drücken Sie die **Eingabetaste**
    * Suchen Sie **Iru Agent** in der Liste der Dienste
    * Klicken Sie mit der rechten Maustaste auf **Iru Agent** und wählen Sie **Neu starten**

    Dadurch wird ein sofortiger Check-in erzwungen.

    #### Befehlszeile

    * Führen Sie den folgenden Befehl in **PowerShell** als Administrator aus:

    ```powershell theme={null}
    dsregcmd /status
    ```

    ### Den Iru Agent neu installieren

    Unter Windows können Sie entweder eine beliebige neue App oder Richtlinie an das Gerät übertragen oder das Gerät erneut registrieren, damit der Agent installiert werden kann.

    ### Hinweise zum Neustart

    * Check-ins werden in der Regel innerhalb des 15-minütigen Agent-Zyklus wieder aufgenommen

    ### Agent-Protokolle prüfen

    Die Agent-Protokolle befinden sich unter:

    ```
    %ProgramData%\kandji\agent\logs
    ```

    ### Überprüfung des Agent-Status

    Prüfen Sie den Agent-Status unter:

    * **Einstellungen** > **Konten** > **Auf Arbeits- oder Schulkonto zugreifen**
    * **Ereignisanzeige** > **Anwendungs- und Dienstprotokolle** > **Microsoft** > **Windows** > **DeviceManagement-Enterprise-Diagnostics-Provider**
  </Tab>
</Tabs>

### Neustart

Ein Neustart des Geräts kann einen hängenden Prozess beheben und es dem Iru Agent ermöglichen, den normalen Check-in wieder aufzunehmen.

### Erneut registrieren

Wenn die obigen Schritte das Problem nicht beheben, registrieren Sie das Gerät manuell erneut.

<Steps>
  <Step title="Vorhandene Registrierung entfernen">
    Entfernen Sie die vorhandene MDM-Registrierung
  </Step>

  <Step title="Gerät erneut registrieren">
    Registrieren Sie das Gerät mit dem richtigen **Registrierungscode** erneut
  </Step>
</Steps>

<Note>
  Stellen Sie sicher, dass beim Registrieren eines Geräts der richtige Blueprint ausgewählt ist. Wenn ein anderer Blueprint ausgewählt wird, setzt das Gerät die diesem Blueprint zugewiesenen Library Items und Parameters durch. Der Gerätedatensatz wird nach der erneuten Registrierung nicht dupliziert. Iru Endpoint verknüpft die neue Registrierung mit dem vorhandenen Gerätedatensatz.
</Note>

### Erweiterte Fehlerbehebung

Prüfen Sie die Protokolle auf:

* Installationsfehler
* Richtlinienfehler
* Kommunikationsprobleme
* Probleme mit der Netzwerkverbindung

### Netzwerkdiagnose

<Steps>
  <Step title="Konnektivität testen">
    Verwenden Sie Netzwerkdiagnosetools, um die Verbindung zu den Iru-Diensten zu testen
  </Step>

  <Step title="Firewall prüfen">
    Überprüfen Sie, ob die Firewall-Regeln die Kommunikation mit den Iru-Domains zulassen
  </Step>

  <Step title="DNS testen">
    Stellen Sie sicher, dass die DNS-Auflösung für Iru-Domains funktioniert
  </Step>

  <Step title="Proxy prüfen">
    Überprüfen Sie gegebenenfalls die Proxy-Einstellungen
  </Step>
</Steps>

### Häufige Probleme und Lösungen

<AccordionGroup>
  <Accordion title="Agent reagiert nicht">
    **Symptome:**

    * Gerät wird in Iru als offline angezeigt
    * Keine aktuellen Check-ins im Gerätedatensatz
    * Richtlinien werden nicht angewendet

    **Lösungen:**

    * Internetverbindung prüfen
    * Gerät neu starten
    * Manuellen Check-in erzwingen
    * Agent bei Bedarf neu installieren
  </Accordion>

  <Accordion title="Check-ins schlagen fehl">
    **Symptome:**

    * Fehlermeldungen in den Agent-Protokollen
    * Probleme mit der Netzwerkverbindung
    * Firewall blockiert die Kommunikation

    **Lösungen:**

    * Netzwerkverbindung überprüfen
    * Firewall-Regeln prüfen
    * Mit einem anderen Netzwerk testen
    * Agent-Protokolle auf bestimmte Fehler prüfen
  </Accordion>

  <Accordion title="Probleme bei der Agent-Installation">
    **Symptome:**

    * Agent nach der Registrierung nicht installiert
    * Installationsfehler in den Protokollen
    * Gerät erscheint nicht in Iru

    **Lösungen:**

    * Überprüfen, ob das Gerät die Anforderungen erfüllt
    * Netzwerkverbindung während der Registrierung prüfen
    * Installationsprotokolle prüfen
  </Accordion>
</AccordionGroup>

### Bewährte Methoden

<CardGroup cols={2}>
  <Card title="Regelmäßig überwachen" icon="eye">
    Überwachen Sie den Check-in-Status von Geräten regelmäßig, um Probleme frühzeitig zu erkennen
  </Card>

  <Card title="Konnektivität testen" icon="wifi">
    Testen Sie die Netzwerkverbindung von verwalteten Geräten zu den Iru-Diensten
  </Card>

  <Card title="Protokolle prüfen" icon="file-text">
    Prüfen Sie die Agent-Protokolle regelmäßig auf mögliche Probleme
  </Card>

  <Card title="Probleme dokumentieren" icon="book">
    Dokumentieren Sie wiederkehrende Probleme und deren Lösungen zur späteren Bezugnahme
  </Card>
</CardGroup>