Wilogutl.exe

  • Artikel

Wilogutl.exe unterstützt die Analyse von Protokolldateien aus einer Windows Installer-Installation und zeigt vorgeschlagene Lösungen für Fehler in einer Protokolldatei an.

Nicht kritische Fehler werden nicht angezeigt. Wilogutl.exe kann im stillen Modus oder mit einer Benutzeroberfläche (UI) ausgeführt werden. Das Tool generiert Berichte als Textdateien, sowohl im UI- als auch im stillen Modus. 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[<Optionen>][<Quelldatei>][<Optionen>][<Berichtsdateiverzeichnis>]

Sie können die folgenden Befehlszeilen verwenden, um das Tool im stillen Modus auszuführen.

wilogutl /q /lc:\mymsilog.log/oc\outputdir\

wilogutl /q /lc:\mymsilog.log

Befehlszeilenoptionen

Wilogutl.exe verwendet die folgenden Befehlszeilenoptionen ohne Beachtung der Groß-/Kleinschreibung. Anstelle eines Schrägstrichs kann ein Bindestrichtrennzeichen verwendet werden.

Option BESCHREIBUNG
Keine Wird im UI-Modus ohne Befehlszeilenoptionen ausgeführt.
/q Legt den stillen Modus fest. 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 bei Ausführung im stillen Modus verwendet. Wenn die Option nicht vorhanden ist, werden die Berichte im Verzeichnis C:\WiLogResults abgelegt.

 

Bei Ausführung im UI-Modus zeigt Wilogutl.exe die folgenden Dialogfelder an.

Name BESCHREIBUNG
Windows Installer Ausführliche Protokollanalyse Über das Dialogfeld „Windows Installer Ausführliche Protokollanalyse“ können Benutzer eine Protokolldatei für die Analyse auswählen:
  • Mit der Schaltfläche Öffnen wird die Datei in Editor geöffnet. Der Vorschaubereich kann verwendet werden, um zu überprüfen, ob die richtige Protokolldatei ausgewählt wurde.
  • Die Schaltfläche Analysieren startet die Analyse der Protokolldateien und blendet das Dialogfeld „Detaillierte Protokolldateiansicht“ ein.
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 Installationsversion auf dem Computer, auf dem die protokollierte Installation ausgeführt wird, wird angezeigt. Wenn die protokollierte Installation mit erweiterten Berechtigungen ausgeführt wurde, ist das Kontrollkästchen Erweiterte Installation aktiviert und in den Textfeldern Clientseitige Berechtigungsdetails und Serverseitige Berechtigungsdetails werden Informationen bereitgestellt. Das Dialogfeld „Detaillierte Protokolldateiansicht“ enthält die folgenden Schaltflächen:
  • Status: Blendet das Dialogfeld „Feature- und Komponentenstatus“ ein.
  • Eigenschaften: Blendet das Dialogfeld „Eigenschaften“ ein.
  • Richtlinien: Blendet das Dialogfeld „Richtlinien“ ein.
  • HTML-Protokoll mit Anmerkungen: Blendet das Protokoll als HTML-Datei mit Anmerkungen ein.
  • Ergebnisse speichern: Speichert Berichtsdateien im angegebenen Verzeichnis.
  • Hilfe zu Fehlermeldungen: Hilfe zur Fehlermeldung des Installationsprogramms anzeigen.
  • Hilfe: Hilfe zur Windows Installer Setup-Protokollanalyse anzeigen.
  • Lesen einer Protokolldatei: Blendet das Hilfedokument für die Protokolldatei ein.
Feature- und Komponentenstatus Im Dialogfeld Feature- und Komponentenstatus werden die Status 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 Das Dialogfeld „Eigenschaften“ zeigt Eigenschaften von Windows Installer und deren Werte am Ende der Installation an. Sie können die Eigenschaften nach Name oder 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 serverseitigen Teils der Installation angezeigt.
  • Auf der Registerkarte Geschachtelt werden die Eigenschaften und Werte aller gleichzeitigen Installationen angezeigt.
Richtlinien Im Dialogfeld „Richtlinien“ wird die Systemrichtlinie angezeigt, die nach der Installation festgelegt wird:
  • Ein für die Richtlinie festgelegter Wert von 0 (null) bedeutet, dass die Richtlinie nicht aktiviert wird.
  • Der Wert 1 (1) bedeutet, dass die Richtlinie aktiviert wird.
  • Der Wert ? (Fragezeichen) bedeutet, dass der Richtlinienwert nicht im Protokoll aufgezeichnet wird.
Wenn Sie einen Richtlinienwert benötigen, der sich nicht im Protokoll befindet, versuchen Sie, mithilfe von Regedit.exe die Registrierungsschlüssel auf dem Computer zu überprüfen, bei dem die Installation fehlschlägt.

 

Berichtsdateien

Wenn Sie eine Analyse im stillen Modus durchführen oder im Dialogfeld Detaillierte Protokolldateiansicht auf die Schaltfläche Ergebnisse speichern klicken, generiert das Windows Installer Setupanalysetool drei Textdateien und eine HTML-Protokolldatei mit Anmerkungen.

In der folgenden Tabelle sind die Namen und Inhalte der Berichtsdateien angegeben.

Name BESCHREIBUNG
logfilename_summary.txt Fasst die Protokolldatei zusammen. Listet die im Dialogfeld „Detaillierte Protokolldateiansicht“ angezeigten Informationen und den ersten Fehler auf.
logfilename_errors.txt Gibt die Anzahl der Fehler, die Fehler und die empfohlenen Lösungen an. Diese Datei listet sowohl kritische als auch nicht kritische Fehler auf.
logfilename_policies.txt Gibt die Richtliniennamen und Werte an, die am Ende der Installation dem Dialogfeld „Richtlinien“ entsprechend festgelegt wurden.
details_logfilename.htm Ein HTML-Protokoll mit Anmerkungen und Legende für die Farbcodierung.

 

Rückgabewerte

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

Wert Bedeutung
1 Es wurde ein ungültiges Ausgabeverzeichnis angegeben.
2 Es wurde ein ungültiger Name der Protokolldatei angegeben.
3 „/q“ wurde übergeben, fehlt jedoch der erforderliche Schalter „/l“ für den Namen der Protokolldatei.
4 „/l“ wurde übergeben, es fehlt jedoch der erforderliche Schalter „/q“ für den stillen Modus.

 

Veröffentlichte Versionen, Tools und verteilbare Dateien

Windows Installer-Entwicklungstools