Wilogutl.exe

  • [アーティクル]

Wilogutl.exe では、Windows インストーラー インストールのログ ファイルの分析を支援し、ログ ファイルで見つかったエラーに対して推奨される解決策を表示します。

重大でないエラーは表示されません。 Wilogutl.exe は、Quiet モードで実行することも、ユーザー インターフェイス (UI) を使用して実行することもできます。 このツールでは、UI モードと Quiet モードの両方でテキスト ファイルとしてレポートが生成されます。 これは詳細な Windows インストーラー ログ ファイルで最適に機能しますが、詳細でないログでも機能します。 詳細については、ログ記録に関するページを参照してください。

このツールは、Windows インストーラー開発者向けの Windows SDK コンポーネントからのみ入手できます。

構文

wilogutl.exe[<オプション>][<ソース ファイル>][<オプション>][<レポート ファイル ディレクトリ>]

次のコマンド ラインを使用して、Quiet モードで実行できます。

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

wilogutl /q /lc:\mymsilog.log

コマンド ライン オプション

Wilogutl.exe では、大文字と小文字を区別しない次のコマンド ライン オプションが使用されます。 スラッシュの代わりにダッシュ区切り記号を使用できます。

オプション 説明
なし コマンド ライン オプションを使用せずに UI モードで実行します。
/q Quiet モードを指定します。 Wilogutl.exe ではレポート ファイルが生成され、ユーザー インターフェイスは表示されません。
/l 分析するログ ファイルの名前を指定します。 このオプションは、Quiet モードを使用する場合に必要です。
/o レポート ファイルの出力ディレクトリを指定します。 この出力パスは、Quiet モードで実行されている場合にのみ使用されます。 オプションが存在しない場合、レポートは C:\WiLogResults ディレクトリに配置されます。

 

UI モードで実行すると、Wilogutl.exe では次のダイアログ ボックスが表示されます。

名前 説明
Windows Installer Verbose Log Analyzer [Windows Installer Verbose Log Analyzer] ダイアログ ボックスを使用すると、ユーザーは分析用のログ ファイルを選択できます。
  • [Open] ボタンを使用すると、メモ帳でファイルが開きます。 プレビュー領域を使用して、正しいログ ファイルが選択されていることを確認できます。
  • [Analyze] ボタンを使用すると、ログ ファイルの分析が開始され、[Detailed Log File View] ダイアログ ボックスが表示されます。
Detailed Log File View [Detailed Log File View] ダイアログ ボックスには、ログに記録されたエラー情報が表示されます。 [Back] ボタンと [Next] ボタンを使用して、複数のエラー間を移動します。 重大でないエラーを表示するには、[Show Ignored Debug Errors] チェック ボックスを選択します。 ログに記録されたインストールの実行に使用されたコンピューターのインストーラー バージョンが表示されます。 ログに記録されたインストールが管理者特権で実行された場合は、[Elevated install]のチェック ボックスが選択され、[Client Side Privilege Details] と [Server Side Privilege Details] テキスト ボックスに情報が表示されます。 [Detailed Log File View] ダイアログ ボックスには、次のボタンがあります。
  • [States] - [Feature and Component States] ダイアログ ボックスを表示します。
  • [Properties] - [Properties] ダイアログ ボックスを表示します。
  • [Policies] - [Policies] ダイアログ ボックスを表示します。
  • [HTML Annotated Log] - ログを注釈付き HTML ファイルとして表示します。
  • [Save Results] - レポート ファイルを指定したディレクトリに保存します。
  • [Error Message Help] - インストーラーのエラー メッセージ ヘルプを表示します。
  • [Help] - Windows インストーラー セットアップ ログ アナライザーのヘルプを表示します。
  • [How to Read a Log File] - ログ ファイルのヘルプ ドキュメントを表示します。
Feature and Component States [Feature and Component States] ダイアログ ボックスには、機能とコンポーネントの状態が表示されます。
  • [Feature] 列には、インストール パッケージ内の機能の名前が表示されます。
  • [Component] 列には、インストール パッケージ内のコンポーネントの名前が表示されます。
  • [Installed] 列には、インストールの最後の機能またはコンポーネントの状態が表示されます。
  • [Request] 列には、機能またはコンポーネントの状態に対するインストール中のユーザーの選択が表示されます。
  • [Action] 列には、機能またはコンポーネントに対してインストーラーによって実行されたアクションが表示されます。
詳細については、MsiGetComponentState および MsiGetFeatureState を参照してください。
プロパティ [Properties] ダイアログ ボックスには、インストールの最後の Windows インストーラーのプロパティとその値が表示されます。 プロパティは、名前または値で並べ替えることができます。
  • [Client] タブには、インストールのクライアント側部分のプロパティと値が表示されます。
  • [Server] タブには、インストールのサーバー部分のプロパティと値が表示されます。
  • [Nested] タブには、同時実行インストールのプロパティと値が表示されます。
ポリシー [Policies] ダイアログ ボックスには、インストール後に設定されたシステム ポリシーが表示されます。
  • ポリシーに値 0 (ゼロ) を設定すると、ポリシーが有効になっていないことを意味します。
  • 値 1 は、ポリシーが有効になっていることを意味します。
  • ? (疑問符) は、ポリシー値がログに記録されないことを意味します。
ログにないポリシー値が必要な場合は、Regedit.exe を使用して、インストールに失敗したコンピューターのレジストリ キーを確認してみてください。

 

レポート ファイル

Quiet モード分析を実行するか、[Detailed Log File View] ダイアログの [Save Results] ボタンをクリックすると、Windows インストーラー セットアップ アナライザー ツールによって 3 つのテキスト ファイルと HTML 注釈付きログ ファイルが生成されます。

次の表は、レポート ファイルの名前と内容を示しています。

名前 説明
logfilename_summary.txt ログ ファイルを要約します。 [Detailed Log File View] ダイアログ ボックスに表示される情報と、最初のエラーが一覧表示されます。
logfilename_errors.txt エラーの数、エラー、推奨される解決策を識別します。 このファイルには、重大なエラーと重大でないエラーの両方が一覧表示されます。
logfilename_policies.txt [Policies] ダイアログ ボックスのように、インストールの最後に設定されたポリシー名と値を識別します。
details_logfilename.htm 色分け用の凡例を含む HTML 注釈付きログ。

 

戻り値

Quiet モードの操作に無効なコマンド ライン引数が渡された場合、Wilogutl.exe では何も行われず、次の表のいずれかの値が返されます。

値 意味
1 無効な出力ディレクトリが指定されています。
2 無効なログ ファイル名が指定されています。
3 /q が渡されましたが、ログ ファイル名に必要なスイッチ /l がありません。
4 /l が渡されましたが、Quiet モードに必要なスイッチ /q がありません。

 

リリース済みバージョン、ツール、再頒布可能パッケージ

Windows インストーラー開発ツール