Installer.EnableLog メソッド

  • [アーティクル]

Installer オブジェクトの EnableLog メソッドを使用すると、現在のプロセス空間における後続のすべてのインストール セッションに対して、選んだメッセージの種類のログが有効になります。

構文

Installer.EnableLog(
  logMode,
  logFile
)

パラメーター

logMode

ログに記録するメッセージの種類を表す文字を含む必須の文字列。 文字列は次の値を組み合わせて指定できます。

値 説明
I 情報のみのメッセージ。
。 致命的でない警告メッセージ。
e 致命的なエラーである可能性のあるエラー メッセージ。
f 置き換えが必要な使用中のファイルのリスト。
a アクション通知の開始。
r アクションに固有のコンテンツを含むアクション データ レコード。
u ユーザー要求メッセージ。
c UI 初期化パラメーター。
m メモリ不足メッセージ。
v ユーザーに対して一般的には有用でない大量の情報をログ ファイルに送信します。 サポートに使用できます。
p ダンプ プロパティ テーブル。エンジン終了時の "property = value"
+ 既存のログ ファイルに追加します。
! 各行をログ ファイルにフラッシュします。
x 詳細デバッグ情報。 このオプションは、Windows Server 2003 でのみ使用できます。
o ディスク領域不足メッセージ。

 

logFile

作成されるログ ファイルへのパスを含む必須の文字列。 ログ記録をオフにするには、空の文字列 ("") を使用します。

戻り値

このメソッドは値を返しません。

解説

このメソッドを使用する場合、ログ ファイルの場所へのパスが既に存在している必要があります。 インストーラーでは、ログ ファイルのディレクトリ構造が作成されません。

EnableLog を使用して設定されたログ オプションは、既存の Windows インストーラーのログ ポリシー設定よりも優先されます。

ログ記録では、既定で既存のログ ファイルが上書きされます。 既存のログ ファイルに追加するには、ログ モードで '+' 文字を使用する必要があります。

'!' オプションは、インストールが大幅に遅くなる可能性があるため推奨されません。 このオプションは、インストールをデバッグするときに役立つ場合があります。

次のサンプル スクリプトでは、インストールの詳細ログを有効にします。 インストールの最後に、生成されたログ ファイルは c:\temp\install.log にあります。

    Dim Installer
    Set Installer = CreateObject("WindowsInstaller.Installer")
    Installer.EnableLog "voicewarmup", "c:\temp\install.log"
    Installer.InstallProduct "\\server\share\products\sample\sample.msi"

必要条件

要件 値
バージョン
 Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー
[DLL]
Msi.dll
IID
 IID_IInstaller が 000C1090-0000-0000-C000-000000000046 として定義されている

こちらもご覧ください

Windows インストーラーのログ記録