Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.


Wilogutl.exe assists the analysis of log files from a Windows Installer installation, and it displays suggested solutions to errors that are found in a log file.

Non-critical errors are not displayed. Wilogutl.exe can be run in quiet mode or with a user interface (UI). The tool generates reports as text files in both the UI and quiet modes. It works best with verbose Windows Installer log files, but also works with non-verbose logs. For more information, see Logging.

This tool is only available in the Windows SDK Components for Windows Installer Developers.


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

You can use the following command lines to run in quiet mode.

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

wilogutl /q /l c:\mymsilog.log

Command-Line Options

Wilogutl.exe uses the following case insensitive command-line options. A dash delimiter can be used in place of a slash.

noneRuns in UI mode—without command-line options.
/qSpecifies the quiet mode. Wilogutl.exe generates report files and does not display a user interface.
/lSpecifies the name of the log file to be analyzed. This option is required when using the quiet mode.
/oSpecifies the output directory for report files. This output path is used only when running in quiet mode. If the option is not present, the reports are put in the C:\WiLogResults directory.


When run in UI mode, Wilogutl.exe displays the following dialog boxes.

Windows Installer Verbose Log AnalyzerThe Windows Installer Verbose Log Analyzer dialog box enables users to select a log file for analysis:
  • The Open button opens the file in Notepad. The preview area can be used to verify that the correct log file has been selected.
  • The Analyze button begins log file analysis and displays the Detailed Log File View dialog box.
Detailed Log File ViewThe Detailed Log File View dialog box displays logged error information. Use the Back and Next buttons to navigate through multiple errors.

To display non-critical errors select the Show Ignored Debug Errors check box. The installer version on the computer used to run the logged installation is displayed. If the logged installation was run with elevated permissions, the Elevated install check box is selected and information is provided in the Client Side Privilege Details and Server Side Privilege Details text boxes. The Detailed Log File View dialog box contains the following buttons:

  • States - Show the Feature and Component States dialog box.
  • Properties - Show the Properties dialog box.
  • Policies - Show the Policies dialog box.
  • HTML Annotated Log - Show log as annotated HTML file.
  • Save Results - Save report files to specified directory.
  • Error Message Help - Show installer error message help.
  • Help - Show help for Windows Installer Setup Log Analyzer.
  • How to Read a Log File - Show the log file help document.
Feature and Component StatesThe Feature and Component States dialog box displays the states of features and components:
  • The Feature column shows the name for the feature in the installation package.
  • The Component column shows the name of the component in the installation package.
  • The Installed column shows the feature or component's state at the end of the installation.
  • The Request column shows the user's selection during the installation for the feature or component's state.
  • The Action column shows the action taken by the installer for the feature or component.

For more information, see MsiGetComponentState and MsiGetFeatureState.

PropertiesThe Properties dialog box shows Windows Installer Properties and their values at the end of the installation. You can sort the properties by name or by value:
  • The Client tab shows properties and values during the client side portion of the installation.
  • The Server tab shows properties and values during the server portion of the installation.
  • The Nested tab shows the properties and values of any Concurrent Installations.
PoliciesThe Policies dialog box displays the System Policy set after the installation:
  • A value of 0 (zero) set for the policy means the policy is not enabled.
  • A value of 1 (one) means the policy is enabled.
  • A value of ? (question mark) means the policy value is not recorded in the log.

If you need a policy value that is not in the log, try using Regedit.exe to check the registry keys on the computer failing the installation.


Report Files

When performing a quiet mode analysis or clicking the Save Results button on the Detailed Log File View dialog, the Windows Installer Setup Analyzer tool generates three text files and an HTML annotated log file.

The following table identifies the names and contents in the report files.

logfilename_summary.txtSummarizes the log file. Lists the information displayed by the Detailed Log File View dialog box and the first error.
logfilename_errors.txtIdentifies the number of errors, the errors, and recommended solutions. This file lists both critical and non-critical errors.
logfilename_policies.txtIdentifies the policy names and values set at the end of the installation as in the Policies dialog box.
details_logfilename.htmAn HTML annotated log with a legend for the color coding.


Return Values

If invalid command-line arguments are passed for quiet mode operations, Wilogutl.exe does nothing, and the process returns one of the values in the following table.

1Bad output directory is specified.
2Bad log file name is specified.
3Passed /q, but is missing the required switch /l for the log file name.
4Passed /l, but is missing the required switch /q for quiet mode.


Related topics

Released Versions, Tools, and Redistributables
Windows Installer Development Tools