Wilogutl.exe

  • 项目

Wilogutl.exe 有助于分析 Windows Installer 安装中的日志文件，并显示针对日志文件中找到的错误的建议解决方案。

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

此工具仅在面向 Windows Installer 开发人员的 Windows SDK 组件中提供。

语法

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

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

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

wilogutl /q /lc:\mymsilog.log

命令行选项

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

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

 

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

名称 说明
Windows Installer 详细日志分析器 “Windows Installer 详细日志分析器”对话框使用户能够选择要进行分析的日志文件：
  • “打开”按钮在记事本中打开文件。 预览区域可用于验证是否已选择正确的日志文件。
  • “分析”按钮开始日志文件分析并显示“详细日志文件视图”对话框。
详细日志文件视图 “详细日志文件视图”对话框显示记录的错误信息。 使用“上一个”和“下一个”按钮浏览多个错误。 若要显示非关键错误，请选中“显示忽略的调试错误”复选框。 随即显示计算机上用于运行记录的安装的安装程序版本。 如果记录的安装以提升的权限运行，则选中了“提升的安装”复选框，并在“客户端特权详细信息”和“服务器端特权详细信息”文本框中提供了信息。 “详细日志文件视图”对话框包含以下按钮：
  • 状态 - 显示“功能和组件状态”对话框。
  • 属性 - 显示“属性”对话框。
  • 策略 - 显示“策略”对话框。
  • HTML 附注日志 - 将日志显示为附注 HTML 文件。
  • 保存结果 - 将报表文件保存到指定目录。
  • 错误消息帮助 - 显示安装程序错误消息帮助。
  • 帮助 - 显示 Windows Installer 安装日志分析器的帮助。
  • 如何读取日志文件 - 显示日志文件帮助文档。
功能和组件状态 “功能和组件状态”对话框显示功能和组件的状态：
  • Feature 列显示安装包中功能的名称。
  • Component 列显示安装包中组件的名称。
  • Installed 列显示安装结束时功能或组件的状态。
  • Request 列显示用户在安装过程中对功能或组件状态的选择。
  • Action 列显示安装程序针对功能或组件执行的操作。
有关详细信息，请参阅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 开发工具