Wilogutl.exe

  • Artikel

Wilogutl.exe unterstützt die Analyse von Protokolldateien aus einer Windows Installer-Installation und zeigt Lösungsvorschläge für Fehler an, die in einer Protokolldatei gefunden werden.

Nicht kritische Fehler werden nicht angezeigt. Wilogutl.exe kann im Hintergrundmodus oder mit einer Benutzeroberfläche (UI) ausgeführt werden. Das Tool generiert Berichte als Textdateien sowohl in der Benutzeroberfläche als auch im Hintergrundmodus. Es funktioniert am besten mit ausführlichen Windows Installer-Protokolldateien, aber auch mit nicht ausführlichen Protokollen. Weitere Informationen finden Sie unter Protokollierung.

Dieses Tool ist nur in den Windows SDK-Komponenten für Windows Installer-Entwickler verfügbar.

Syntax

wilogutl.exe [<options>][<source file>][<options>][<report file directory>]

Sie können die folgenden Befehlszeilen für die Ausführung im Hintergrundmodus verwenden.

wilogutl /q /l c:\mymsilog.log /o c\outputdir\

wilogutl /q /l c:\mymsilog.log

Befehlszeilenoptionen

Wilogutl.exe verwendet die folgenden Befehlszeilenoptionen ohne Groß-/Kleinschreibung. Ein Strichtrennzeichen kann anstelle eines Schrägstrichs verwendet werden.

Option Description
Keine Wird im Benutzeroberflächenmodus ohne Befehlszeilenoptionen ausgeführt.
/q Gibt den stillen Modus an. Wilogutl.exe generiert Berichtsdateien und zeigt keine Benutzeroberfläche an.
/l Gibt den Namen der zu analysierenden Protokolldatei an. Diese Option ist erforderlich, wenn Sie den stillen Modus verwenden.
/o Gibt das Ausgabeverzeichnis für Berichtsdateien an. Dieser Ausgabepfad wird nur verwendet, wenn er im stillen Modus ausgeführt wird. Wenn die Option nicht vorhanden ist, werden die Berichte im Verzeichnis „C:\WiLogResults“ abgelegt.

 

Wenn Sie Wilogutl.exe im UI-Modus ausführen, werden die folgenden Dialogfelder angezeigt.

Name Beschreibung
Ausführliches Protokollanalysetool für Windows Installer Im Dialogfeld „Ausführliches Protokollanalysetool für Windows Installer“ können Benutzer eine Protokolldatei für die Analyse auswählen:
  • Über die Schaltfläche Öffnen wird die Datei im Editor geöffnet. Der Vorschaubereich kann verwendet werden, um zu überprüfen, ob die richtige Protokolldatei ausgewählt wurde.
  • Über die Schaltfläche Analysieren wird die Protokolldateianalyse gestartet und das Dialogfeld „Detaillierte Protokolldateiansicht“ an.
Detaillierte Protokolldateiansicht Im Dialogfeld „Detaillierte Protokolldateiansicht“ werden protokollierte Fehlerinformationen angezeigt. Verwenden Sie die Schaltflächen Zurück und Weiter, um durch mehrere Fehler zu navigieren. Aktivieren Sie das Kontrollkästchen Ignorierte Debugfehler anzeigen, um nicht kritische Fehler anzuzeigen. Die Installationsprogrammversion auf dem Computer, auf dem die protokollierte Installation ausgeführt wird, wird angezeigt. Wenn die protokollierte Installation mit erhöhten Berechtigungen ausgeführt wurde, ist das Kontrollkästchen Installation mit erhöhten Berechtigungen aktiviert, und Informationen finden Sie in den Textfeldern Clientseitige Berechtigungsdetails und Serverseitige Berechtigungsdetails. Das Dialogfeld „Detaillierte Protokolldateiansicht“ enthält die folgenden Schaltflächen:
  • Zustände – Dialogfeld „Feature- und Komponentenstatus anzeigen“.
  • Eigenschaften: Dialogfeld „Eigenschaften anzeigen“.
  • Richtlinien – Dialogfeld „Richtlinien anzeigen“.
  • Kommentiertes HTML-Protokoll – Protokoll als kommentierte HTML-Datei anzeigen.
  • Ergebnisse speichern – Berichtsdateien im angegebenen Verzeichnis speichern.
  • Hilfe zu Fehlermeldungen – Hilfe zur Installer-Fehlermeldungen anzeigen.
  • Hilfe – Hilfe für die Windows Installer-Setupprotokollanalyse anzeigen.
  • So lesen Sie eine Protokolldatei – Das Hilfedokument der Protokolldatei anzeigen.
Feature- und Komponentenstatus Im Dialogfeld Feature- und Komponentenstatus werden die Zustände von Features und Komponenten angezeigt:
  • In der Spalte Feature wird der Name des Features im Installationspaket angezeigt.
  • In der Spalte Komponente wird der Name der Komponente im Installationspaket angezeigt.
  • In der Spalte Installiert wird der Status des Features oder der Komponente am Ende der Installation angezeigt.
  • In der Spalte Anforderung wird die Auswahl des Benutzers während der Installation für den Status des Features oder der Komponente angezeigt.
  • In der Spalte "Aktion " wird die Aktion angezeigt, die vom Installationsprogramm für das Feature oder die Komponente ausgeführt wird.
Weitere Informationen finden Sie unter MsiGetComponentState und MsiGetFeatureState.
Eigenschaften Im Dialogfeld „Eigenschaften“ werden Windows Installer-Eigenschaften und deren Werte am Ende der Installation angezeigt. Sie können die Eigenschaften nach Namen oder nach Wert sortieren:
  • Auf der Registerkarte Client werden Eigenschaften und Werte während des clientseitigen Teils der Installation angezeigt.
  • Auf der Registerkarte Server werden Eigenschaften und Werte während des Serverteils der Installation angezeigt.
  • Auf der Registerkarte Geschachtelt werden die Eigenschaften und Werte aller Gleichzeitigen Installationen angezeigt.
Richtlinien Im Dialogfeld „Richtlinien“ wird die nach der Installation festgelegte Systemrichtlinie angezeigt:
  • Ein Wert von 0 (Null) für die Richtlinie bedeutet, dass die Richtlinie nicht aktiviert ist.
  • Der Wert 1 (eins) bedeutet, dass die Richtlinie aktiviert ist.
  • Ein Wert von ? (Fragezeichen) bedeutet, dass der Richtlinienwert nicht im Protokoll aufgezeichnet wird.
Wenn Sie einen Richtlinienwert benötigen, der sich nicht im Protokoll befindet, versuchen Sie, Regedit.exe zu verwenden, um die Registrierungsschlüssel auf dem Computer zu überprüfen, bei denen die Installation fehlschlägt.

 

Berichtsdateien

Wenn Sie eine Analyse im stillen Modus durchführen oder auf Ergebnisse speichern im Dialogfeld Detaillierte Protokolldateiansicht klicken, generiert das Windows Installer Setup Analyzer-Tool drei Textdateien und eine HTML-kommentierte Protokolldatei.

In der folgenden Tabelle sind die Namen und Inhalte in den Berichtsdateien aufgeführt.

Name Beschreibung
logfilename_summary.txt Fasst die Protokolldatei zusammen. Listet die Informationen auf, die im Dialogfeld „Detaillierte Protokolldateiansicht“ und dem ersten Fehler angezeigt werden.
logfilename_errors.txt Identifiziert die Anzahl der Fehler, die Fehler und die empfohlenen Lösungen. Diese Datei listet sowohl kritische als auch nicht kritische Fehler auf.
logfilename_policies.txt Identifiziert die am Ende der Installation festgelegten Richtliniennamen und Werte wie im Dialogfeld „Richtlinien“.
details_logfilename.htm Ein mit Anmerkungen versehenes HTML-Protokoll mit einer Legende für die Farbcodierung.

 

Rückgabewerte

Wenn ungültige Befehlszeilenargumente für Vorgänge im stillen Modus übergeben werden, führt Wilogutl.exe nichts aus, und der Prozess gibt einen der Werte in der folgenden Tabelle zurück.

Wert Bedeutung
1 Ungültiges Ausgabeverzeichnis ist angegeben.
2 Ungültiger Protokolldateiname ist angegeben.
3 /q wurde übergeben, es fehlt jedoch der erforderliche Switch /i für den Namen der Protokolldatei.
4 /l wurde übergeben, es fehlt jedoch der erforderliche Switch /q für den stillen Modus.

 

Veröffentlichte Versionen, Tools und Redistributables

Entwicklungstools für Windows Installer