Wilogutl.exe

  • 项目

Wilogutl.exe 可帮助分析 Windows Installer 安装中的日志文件，并显示针对在日志文件中所发现错误的推荐解决方案。

不显示非严重错误。 Wilogutl.exe 可在静默模式下或通过用户界面 (UI) 来运行。 该工具会以 UI 与静默模式下的文本文件的形式生成报表。 它最适用于详细 Windows Installer 日志文件，但同时也适用于非详细日志。 有关详细信息，请参阅日志记录。

此工具仅在适用于 Windows Installer 开发人员的 Windows SDK 组件中提供。

语法

wilogutl.exe [<选项>][<源文件>][<选项>][<报表文件目录>]

可使用以下命令行以静默模式运行。

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

wilogutl /q /l c:\mymsilog.log

命令行选项

Wilogutl.exe 使用以下不区分大小写的命令行选项。 短划线分隔符可用于代替斜杠。

选项 Description
无 在 UI 模式下运行—没有命令行选项。
/q 指定静默模式。 Wilogutl.exe 会生成报表文件，且不显示用户界面。
/l 指定要分析的日志文件的名称。 使用静默模式时，此选项为必选选项。
/o 指定报表文件的输出目录。 仅当在静默模式下运行时，才使用此输出路径。 如果此选项不存在，报表则会放入 C:\WiLogResults 目录中。

 

在 UI 模式下运行时，Wilogutl.exe 会显示以下对话框。

名称 描述
Windows Installer 详细日志分析器 Windows Installer 详细日志分析器对话框允许用户选择要分析的日志文件：
  • 打开按钮可用于在记事本中打开该文件。 预览区域可用于验证是否已选择正确的日志文件。
  • 分析按钮可开始日志文件分析，并显示“详细日志文件视图”对话框。
详细日志文件视图 “详细日志文件视图”对话框会显示记录的错误信息。 使用后退和下一个按钮可浏览多个错误。 若要显示非严重错误，请选中显示忽略的调试错误复选框。 显示用于运行已记录安装的计算机上的安装程序版本。 如果记录的安装是使用提升的权限来运行的，则会选中提升安装复选框，并在客户端权限详细信息和服务器端权限详细信息文本框中提供相关信息。 “详细日志文件视图”对话框包含以下按钮：
  • 状态 - 显示“功能和组件状态”对话框。
  • 属性 - 显示“属性”对话框。
  • 策略 - 显示“策略”对话框。
  • HTML 批注日志 - 将日志显示为带批注的 HTML 文件。
  • 保存结果 - 将报表文件保存到指定目录。
  • 错误消息帮助 - 显示安装程序错误消息帮助。
  • 帮助 - 显示 Windows Installer 安装日志分析器的帮助。
  • 如何读取日志文件 - 显示日志文件帮助文档。
功能和组件状态 功能和组件状态对话框可显示功能和组件的状态：
  • 功能列可显示安装包中功能的名称。
  • 组件列可显示安装包中组件的名称。
  • 已安装列可显示安装结束时的功能或组件的状态。
  • 请求列可显示安装期间用户为功能或组件的状态而做出的选择。
  • 操作列可显示安装程序为功能或组件而执行的操作。
有关详细信息，请参阅 MsiGetComponentState 和 MsiGetFeatureState。
属性 “属性”对话框可显示安装结束时的 Windows Installer 属性及其值。 可按名称或值对属性进行排序：
  • 客户端选项卡可显示此安装的客户端部分所使用的属性和值。
  • 服务器选项卡可显示此安装的服务器部分所使用的属性和值。
  • 嵌套选项卡可显示所有并发安装的属性和值。
策略 “策略”对话框可显示安装后设置的系统策略：
  • 为策略设置的值为 0（零）表示未启用该策略。
  • 值为 1（一）则表示已启用该策略。
  • 值为 ? （问号）表示策略值未记录在日志中。
如需不在日志中的策略值，请尝试使用 Regedit.exe 来检查计算机上导致安装失败的注册表项。

 

报表文件

执行静默模式分析或单击详细日志文件视图对话框中的保存结果按钮时，Windows Installer 安装分析器工具会生成三个文本文件和一个带批注的 HTML 日志文件。

下表标识了报表文件中的名称和内容。

名称 描述
logfilename_summary.txt 对此日志文件进行总结。 列出“详细日志文件视图”对话框显示的信息，以及第一个错误。
logfilename_errors.txt 标识错误数、错误和建议的解决方案。 此文件同时列出了严重错误和非严重错误。
logfilename_policies.txt 标识在安装结束时设置的策略名称和值（如“策略”对话框中所示）。
details_logfilename.htm 附带颜色编码图例的带批注 HTML 日志。

 

返回值

如果为静默模式操作传递了无效命令行参数，Wilogutl.exe 则不执行任何操作，且该流程将返回下表中的某一值。

值 含义
1 指定了错误的输出目录。
2 指定了错误的日志文件名。
3 已传递 /q，但缺少日志文件名称所需的开关 /l。
4 已传递 /l，但对于静默模式缺少所需的开关 /q。

 

已发布的版本、工具和可再发行版

Windows Installer 开发工具