scloud by Florian Salzmann
ende

Intune Diagnose Tool: IME- und Autopilot-Logs mit einem Skript analysieren

Beim Troubleshooting von Intune und Autopilot gräbst du dich normalerweise manuell durch Logs. Mit dem Intune Diagnose Tool habe ich eine einfache PowerShell UI gebaut, mit der du Intune Management Extension und Autopilot Logs in wenigen Klicks analysierst.
Die Idee dahinter ist simpel. Du wählst ein Diagnose-Skript, ziehst deinen Log-Ordner oder eine ZIP-Datei rein und klickst auf Analyze. Das Tool erledigt den Rest.

Warum ich dieses Tool gebaut habe

Beim Troubleshooting von Intune Deployments verwende ich immer wieder dieselben Community-Skripte. Das Problem dabei: Jedes Skript hat unterschiedliche Parameter und erwartet unterschiedliche Eingabeformate.

Get-IntuneManagementExtensionDiagnostics erwartet einen Ordnerpfad. Get-AutopilotDiagnostics erwartet eine ZIP- oder CAB-Datei. Get-AutopilotDiagnosticsCommunity verwendet für dasselbe einen anderen Parameternamen.

Ich wollte einen einzigen Einstiegspunkt, bei dem ich einfach das benötigte Skript auswähle, es auf meine Logs zeige und loslege. Ohne Parameternamen auswendig zu lernen oder ZIP-Dateien manuell zu entpacken.

Was das Intune Diagnose Tool macht

Das Tool ist ein einzelnes PowerShell-Skript mit eingebauter grafischer Oberfläche. Es lädt die Diagnose-Skripte automatisch aus der PowerShell Gallery herunter und übernimmt für dich das gesamte Parameter-Mapping.

Hier eine Übersicht, was es abdeckt:

  • Auswahl von drei Diagnose-Skripten über ein Dropdown
  • Drag & Drop eines Log-Ordners, einer ZIP- oder CAB-Datei in die UI
  • Dateien über einen File Picker durchsuchen
  • Analyse des aktuellen PCs mit einem Klick starten
  • Automatisches Entpacken von ZIP-Dateien bei Bedarf
  • Automatischer Download der Skripte aus der PowerShell Gallery beim ersten Gebrauch
  • Dunkles UI-Theme mit Status-Anzeigen und einer Fortschrittsleiste

Unterstützte Diagnose-Skripte

Das Tool enthält aktuell drei bekannte Community-Skripte. Über das Dropdown am oberen Rand der UI wechselst du zwischen ihnen.

IME Diagnostics von Petri Paavola

Dahinter steckt Get-IntuneManagementExtensionDiagnostics. Es analysiert Intune Management Extension Logs und erstellt einen detaillierten Timeline-Report. Der Report umfasst Win32 App Deployments, WinGet Apps, PowerShell-Skripte, Remediation-Skripte und Autopilot ESP-Phasen.

Es generiert einen HTML-Report und unterstützt zusätzlich eine Log Viewer UI für die tiefere Analyse.

Projekt: github.com/petripaavola/Get-IntuneManagementExtensionDiagnostics

Autopilot Diagnostics von Michael Niehaus

Dahinter steckt Get-AutopilotDiagnostics, das ursprüngliche Autopilot Troubleshooting-Skript. Es zeigt Autopilot Profil-Einstellungen, ESP-Tracking-Details, App- und Policy-Status sowie Geräte-Registrierungsereignisse.

Das Skript wurde von Michael Niehaus erstellt, während er noch bei Microsoft war. Es akzeptiert ZIP- und CAB-Dateien, die vom MDMDiagnosticsTool erfasst wurden.

Quelle: PowerShell Gallery

Autopilot Diagnostics Community von Andrew Taylor

Dahinter steckt Get-AutopilotDiagnosticsCommunity, der aktiv gepflegte Community-Fork. Er baut auf dem Original auf und ergänzt Unterstützung für Autopilot v2, neue Graph API Module, verbesserte Timeline-Genauigkeit und Details zur Delivery Optimization.

Falls du heute Autopilot troubleshootest, ist dies die Version, die ich empfehle.

Projekt: github.com/andrew-s-taylor/WindowsAutopilotInfo

Installation und Ausführung

Du installierst das Skript direkt aus der PowerShell Gallery. Öffne PowerShell als Administrator und führe aus:

Install-Script -Name Intune-Diag

PowerShell Gallery Referenz

Um es nach der Installation auszuführen:

Intune-Diag

Beim ersten Start legt das Tool einen Ordner unter C:\ProgramData\IntuneDiagnostic-UI an und lädt die Diagnose-Skripte aus der PowerShell Gallery herunter. Das passiert nur einmal. Danach läuft alles lokal.

So verwendest du das Intune Diagnose Tool

Nach dem Start des Skripts öffnet sich die UI zentriert auf deinem Bildschirm.

Log-Ordner oder ZIP-Datei analysieren

Das ist der typische Workflow, wenn du Logs von einem entfernten Gerät erhältst.

  1. Wähle im Dropdown das gewünschte Diagnose-Skript aus
  2. Ziehe einen Ordner, eine ZIP- oder CAB-Datei ins Pfadfeld (oder klicke auf den Browse-Button)
  3. Klicke auf “Analyze Path”

Das Tool übernimmt den Rest. Verwendest du IME Diagnostics mit einer ZIP-Datei, entpackt das Tool das Archiv automatisch in einen Temp-Ordner. Die Autopilot-Skripte erhalten die ZIP- oder CAB-Datei direkt, da sie das Entpacken selbst übernehmen.

Ziehst du einen Ordner rein und das gewählte Autopilot-Skript erwartet eigentlich eine Datei, sucht das Tool im Ordner nach ZIP- oder CAB-Dateien und übergibt den ersten Treffer.

Aktuelles Gerät analysieren

Troubleshootest du direkt auf dem betroffenen Gerät, kannst du die Dateiauswahl komplett überspringen.

  1. Wähle das Diagnose-Skript im Dropdown aus
  2. Klicke auf “Analyze This PC”

Das Skript läuft lokal, ohne zusätzliche Parameter. Das ist besonders praktisch während der Autopilot-Registrierung oder wenn du direkt vor dem Gerät sitzt.

Credits

Die gesamte Diagnose-Logik stammt von den grossartigen Community-Skripten von Petri Paavola, Michael Niehaus und Andrew Taylor. Dieses Tool ist lediglich ein Wrapper, der es einfacher amcht, sie gemeinsam zu nutzen.

Hast du Feedback oder Ideen für neue Skripte, die ergänzt werden sollten, melde dich gerne oder eröffne ein Issue auf GitHub.