次の方法で共有


Wilogutl.exe

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

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

このツールは、 Windows Installer Developers 向け 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 インストーラー詳細ログ アナライザー Windows インストーラーの詳細ログ アナライザー ダイアログ ボックスでは、分析するログ ファイルを選択できます。
  • 開く ボタンをクリックすると、ファイルがメモ帳で開きます。 プレビュー領域を使用して、正しいログ ファイルが選択されたことを確認できます。
  • 分析 ボタンはログファイルの分析を開始し、詳細ログファイルビューダイアログボックスを表示します。
詳細なログファイルビュー [詳細なログ ファイルの表示] ダイアログ ボックスには、ログに記録されたエラー情報が表示されます。 複数のエラーを移動するには、 戻る ボタンと 次へ ボタンを使用します。 重大でないエラーを表示するには、 「無視されたデバッグ エラーを表示」 チェック ボックスをオンにします。 ログに記録されたインストールを実行するために使用されたコンピューター上のインストーラーのバージョンが表示されます。 ログに記録されたインストールが管理者権限で実行された場合、 管理者権限によるインストール チェックボックスが選択され、クライアント側権限の詳細 および サーバー側権限の詳細 テキストボックスに情報が提供されます。 [詳細なログ ファイルの表示] ダイアログ ボックスには、次のボタンがあります。
  • 状態 - フィーチャーとコンポーネントの状態ダイアログ ボックスを表示します。
  • プロパティ - プロパティ ダイアログ ボックスを表示します。
  • ポリシー - ポリシー ダイアログ ボックスを表示します。
  • HTML 注釈付きログ - ログを注釈付き HTML ファイルとして表示します。
  • 結果を保存 - レポート ファイルを指定されたディレクトリに保存します。
  • エラー メッセージのヘルプ - インストーラーのエラー メッセージのヘルプを表示します。
  • ヘルプ - Windows インストーラー セットアップ ログ アナライザーのヘルプを表示します。
  • ログ ファイルの読み方 - ログ ファイルのヘルプ ドキュメントを表示します。
機能とコンポーネントの状態 フィーチャとコンポーネントの状態 ダイアログボックスには、フィーチャとコンポーネントの状態が表示されます。
  • 機能 列には、インストール パッケージ内の機能の名前が表示されます。
  • コンポーネント 列には、インストール パッケージ内のコンポーネントの名前が表示されます。
  • インストール済み 列には、インストール終了時の機能またはコンポーネントの状態が表示されます。
  • リクエスト 列には、インストール中にユーザーが選択した機能またはコンポーネントの状態が表示されます。
  • アクション 列には、機能またはコンポーネントに対してインストーラーによって実行されたアクションが表示されます。
詳細については、 MsiGetComponentState および MsiGetFeatureStateを参照してください。
プロパティ [プロパティ] ダイアログ ボックスには、インストール終了時の Windows インストーラーの プロパティ とその値が表示されます。 プロパティは名前または値で並べ替えることができます。
  • クライアント タブには、インストールのクライアント側部分のプロパティと値が表示されます。
  • サーバー タブには、インストールのサーバー部分でのプロパティと値が表示されます。
  • ネスト タブには、 同時インストールのプロパティと値が表示されます。
ポリシー [ポリシー] ダイアログ ボックスには、インストール後に設定された システム ポリシー が表示されます。
  • ポリシーに 0 (ゼロ) の値が設定されている場合、ポリシーは有効になっていません。
  • 値が 1 の場合、ポリシーが有効であることを意味します。
  • ? の値 (疑問符) は、ポリシー値がログに記録されないことを意味します。
ログにないポリシー値が必要な場合は、Regedit.exe を使用して、インストールに失敗したコンピューターのレジストリ キーを確認してください。

 

レポート ファイル

サイレント モード分析を実行するか、[詳細ログ ファイル ビュー] ダイアログの [結果の保存] ボタンをクリックすると、Windows インストーラー セットアップ アナライザー ツールによって 3 つのテキスト ファイルと HTML 注釈付きログ ファイルが生成されます。

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

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

 

戻り値

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

Value 意味
1 不正な出力ディレクトリが指定されました。
2 不正なログファイル名が指定されました。
3 /q は渡されましたが、ログ ファイル名に必要なスイッチ /l がありません。
4 /l は渡されましたが、静音モードに必要なスイッチ /q がありません。

 

リリースされたバージョン、ツール、再配布可能ファイル

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