Installer.EnableLog-Methode

Artikel
06/13/2023

Die EnableLog-Methode des Installer-Objekts ermöglicht die Protokollierung des ausgewählten Nachrichtentyps für alle nachfolgenden Installationssitzungen im aktuellen Prozessbereich.

Syntax

Installer.EnableLog(
  logMode,
  logFile
)

Parameter

logMode

Eine erforderliche Zeichenfolge, die Buchstaben zur Darstellung der zu protokollierenden Nachrichtentypen enthält. Für die Zeichenfolge ist eine Kombination der folgenden Werte gültig.

Wert	Beschreibung
I	Reine Informationsmeldungen.
w	Nicht schwerwiegende Warnmeldungen.
e	Fehlermeldungen, die schwerwiegende Fehler sein können.
f	Liste der verwendeten Dateien, die ersetzt werden müssen.
a	Benachrichtigung zum Start der Aktion.
r	Aktionsdatensatz, der aktionsspezifische Inhalte enthält.
u	Benutzeranforderungsmeldungen.
c	Benutzeroberflächen-Initialisierungsparameter.
m	Meldung bei nicht genügend Arbeitsspeicher.
v	Sendet große Mengen von Informationen an die Protokolldatei, die für Benutzer im Allgemeinen nicht nützlich ist. Kann zur Unterstützung verwendet werden.
p	Dump-Eigenschaftstabelle; "property = value" beim Beenden der Engine
+	Wird an eine vorhandene Protokolldatei angehängt.
!	Leert jede Zeile in der Protokolldatei.
x	Extra-Debuginformationen. Diese Option ist nur bei Windows Server 2003 verfügbar.
o	Meldungen bei nicht genügend Speicherplatz.

logFile

Erforderliche Zeichenfolge, die den Pfad zu der zu erstellenden Protokolldatei enthält. Verwenden Sie eine leere Zeichenfolge (""), um die Protokollierung zu deaktivieren.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Der Pfad zum Speicherort der Protokolldatei muss bei Verwendung dieser Methode bereits vorhanden sein. Der Installer erstellt nicht die Verzeichnisstruktur für die Protokolldatei.

Die mit EnableLog festgelegten Protokollierungsoptionen setzen die vorhandenen Windows Installer-Protokollierungsrichtlinieneinstellungen außer Kraft.

Die Protokollierung überschreibt standardmäßig eine vorhandene Protokolldatei. Zum Anfügen an eine vorhandene Protokolldatei müssen Sie den Buchstaben "+" im Protokollierungsmodus verwenden.

Die Option "!" wird nicht empfohlen, da sie die Installation erheblich verlangsamen kann. Diese Option kann beim Debuggen einer Installation nützlich sein.

Das folgende Beispielskript aktiviert die ausführliche Protokollierung für eine Installation. Am Ende der Installation befindet sich die generierte Protokolldatei unter „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"

Anforderungen

Anforderung	Wert
Version	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP
DLL	Msi.dll
IID	IID_IInstaller ist definiert als 000C1090-0000-0000-C000-000000000046

Siehe auch

Windows Installer-Protokollierung

Freigeben über