Befehlszeilenoptionen

Das ausführbare Programm zum Interpretieren von Paketen und Installieren von Produkten heißt „Msiexec.exe“. Beachten Sie, dass Msiexec bei der Rückgabe auch eine Fehlerstufe festlegt, die den Systemfehlercodes entspricht. Bei Befehlszeilenoptionen wird die Groß-/Kleinschreibung nicht beachtet.

Die Befehlszeilenoptionen in der folgenden Tabelle stehen in Windows Installer 3.0 und früheren Versionen zur Verfügung. Die standardmäßigen Installer-Befehlszeilenoptionen sind auch ab Windows Installer 3.0 verfügbar.

Option	Parameter	Bedeutung
/I	Paket|Produktcode	Installiert oder konfiguriert ein Produkt.
/f	[p|o|e|d|c|a|u|m|s|v] Paket|Produktcode	Repariert ein Produkt. Diese Option ignoriert alle Eigenschaftenwerte, die in der Befehlszeile eingegeben werden. Die Standardargumentliste für diese Option lautet „omus“. Diese Option verwendet dieselbe Argumentliste wie die REINSTALLMODE-Eigenschaft. p: Es wird nur dann eine Neuinstallation durchgeführt, wenn die Datei fehlt. o: Es wird eine Neuinstallation durchgeführt, wenn die Datei fehlt oder eine ältere Version installiert ist. e: Es wird eine Neuinstallation durchgeführt, wenn die Datei fehlt oder eine gleichwertige oder ältere Version installiert ist. d: Es wird eine Neuinstallation durchgeführt, wenn die Datei fehlt oder eine andere Version installiert ist. c: Es wird eine Neuinstallation durchgeführt, wenn die Datei fehlt oder die gespeicherte Prüfsumme nicht mit dem berechneten Wert übereinstimmt. Es werden nur Dateien repariert, die einen msidbFileAttributesChecksum-Wert in der Attributspalte der File-Tabelle enthalten. a: Erzwingt, dass alle Dateien neu installiert werden. u: Schreibt alle erforderlichen benutzerspezifischen Registrierungseinträge neu. m: Schreibt alle erforderlichen computerspezifischen Registrierungseinträge neu. s: Überschreibt alle vorhandenen Verknüpfungen. v: Die Ausführung erfolgt über die Quelle, und das lokale Paket wird erneut zwischengespeichert. Verwenden Sie die Option v zur Neuinstallation nicht für die Erstinstallation einer Anwendung oder eines Features.
/a	Pakete	Option für die administrative Installation. Installiert ein Produkt im Netzwerk.
/x	Paket|Produktcode	Deinstalliert ein Produkt.
/j	[u|m]Paket oder [u|m]Paket/tTransformationsliste or [u|m]Paket/gSprachen-ID	Kündigt ein Produkt an. Diese Option ignoriert alle Eigenschaftenwerte, die in der Befehlszeile eingegeben werden. u: Ankündigung für den aktuellen Benutzer bzw. die aktuelle Benutzerin. m: Ankündigung für alle Benutzer*innen des Computers. g: Der Sprachbezeichner. t: Wendet die Transformation auf das angekündigte Paket an.
/L	[i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] Protokolldatei	Schreibt Protokollierungsinformationen in eine Protokolldatei im angegebenen vorhandenen Pfad. Der Pfad zum Speicherort der Protokolldatei muss bereits vorhanden sein. Der Installer erstellt nicht die Verzeichnisstruktur für die Protokolldatei. Die folgenden Flags geben an, welche Informationen protokolliert werden sollen. Wenn keine Flags angegeben sind, lautet der Standardwert „iwearmo“. i: Statusmeldungen w: Nicht schwerwiegende Warnungen e: Sämtliche Fehlermeldungen a: Start von Aktionen r: Aktionsspezifische Einträge u: Benutzeranforderungen c: Anfängliche UI-Parameter m: Informationen zu fehlendem Arbeitsspeicher oder einer schwerwiegenden Beendigung o: Meldungen bei nicht genügend Speicherplatz p: Terminaleigenschaften v: Ausführliche Ausgabe e: Zusätzliche Debuginformationen Windows Installer 2.0: Nicht unterstützt. Die Option „x“ steht in Windows Installer-Version 3.0.3790.2180 und höher zur Verfügung. +: Anfügen an vorhandene Datei ! Leert jede Zeile in die Protokolldatei *: Platzhalter, protokolliert alle Informationen mit Ausnahme der Optionen „v“ und „x“ Geben Sie „/l*vx“ an, um die Optionen „v“ und „x“ einzuschließen. Hinweis: Weitere Informationen zu allen Methoden, die zum Festlegen des Protokollierungsmodus verfügbar sind, finden Sie unter Normale Protokollierung im Abschnitt Windows Installer-Protokollierung
/m	filename Hinweis: Die Länge von filename darf nicht mehr als acht Zeichen betragen.	Generiert eine MIF-Datei zum SMS-Status. Muss mit den Optionen zum Installieren (-i), Entfernen (-x), für die administrative Installation (-a) oder zur Neuinstallation (-f) verwendet werden. „ISMIF32.DLL“ wird als Teil von SMS installiert und muss sich im Pfad befinden. Die Felder der Status-MIF-Datei werden mit den folgenden Informationen gefüllt: Hersteller – Author Produkt – Revision Number Version – Subject Gebietsschema – Template Seriennummer – nicht festgelegt Installation: Legen Sie „ISMIF32.DLL“ auf „DateTime“ fest. InstallStatus: „Success“ oder „Failed“ Beschreibung: Fehlermeldungen in der folgenden Reihenfolge: 1) Vom Installer generierte Fehlermeldungen. 2) Ressource aus „Msi.dll“, wenn die Installation nicht gestartet werden konnte oder durch den Benutzer/die Benutzerin beendet wurde. 3) Datei mit Systemfehlermeldungen. 4) Formatierte Meldung: „Installerfehler %i“, wobei „%i“ ein Fehler ist, der von „Msi.dll“ zurückgegeben wird.
/p	Patchpaket[;Patchpaket2 ]	Wendet einen Patch an. Um einen Patch auf ein installiertes Administratorimage anzuwenden, müssen Sie die folgenden Optionen kombinieren: /p <PatchPackage>[;p atchPackage2 ] /a \<Package>
/q	n|b|r|f	Legt die Ebene der Benutzeroberfläche fest. q , qn – Keine Benutzeroberfläche qb : Einfache Benutzeroberfläche. Verwenden Sie qb! , um die Schaltfläche Abbrechen auszublenden. qr: Reduzierte Benutzeroberfläche ohne modales Dialogfeld, das am Ende der Installation angezeigt wird. qf: Vollständige Benutzeroberfläche und alle erstellten Dialogfelder fatalError, UserExit oder Modal beenden am Ende. qn+ – Keine Benutzeroberfläche außer einem modalen Dialogfeld, das am Ende angezeigt wird. qb+ – Einfache Benutzeroberfläche mit einem modalen Dialogfeld, das am Ende angezeigt wird. Das modale Feld wird nicht angezeigt, wenn der Benutzer die Installation abbricht. Verwenden Sie qb+! oder qb!+, um die Schaltfläche Abbrechen auszublenden. qb- – Einfache Benutzeroberfläche ohne modale Dialogfelder. Beachten Sie, dass /qb+- keine unterstützte Benutzeroberflächenebene ist. Verwenden Sie qb-! oder qb!, um die Schaltfläche Abbrechen auszublenden. Beachten Sie, dass die ! option ist mit Windows Installer 2.0 verfügbar und funktioniert nur mit der einfachen Benutzeroberfläche. Er ist mit der vollständigen Benutzeroberfläche nicht gültig.
/? oder /h		Zeigt Copyrightinformationen für Windows Installer an.
/Y	module	Ruft die Systemfunktion DllRegisterServer auf, um module selbst zu registrieren, die über die Befehlszeile übergeben werden. Geben Sie den vollständigen Pfad zur DLL an. Für MY_FILE.DLL im aktuellen Ordner können Sie beispielsweise Folgendes verwenden: msiexec /y .\MY_FILE.DLL Diese Option wird nur für Registrierungsinformationen verwendet, die nicht mithilfe der Registrierungstabellen der .msi-Datei hinzugefügt werden können.
/Z	module	Ruft die Systemfunktion DllUnRegisterServer auf, um die Registrierung von Modulen aufzuheben, die über die Befehlszeile übergeben werden. Geben Sie den vollständigen Pfad zur DLL an. Für MY_FILE.DLL im aktuellen Ordner können Sie beispielsweise Folgendes verwenden: msiexec /z .\MY_FILE.DLL Diese Option wird nur für Registrierungsinformationen verwendet, die nicht mithilfe der Registrierungstabellen der .msi-Datei entfernt werden können.
/c	Kündigt eine neue Instanz des Produkts an. Muss zusammen mit der Option „/t“ verwendet werden. Verfügbar ab der Windows Installer-Version, die im Lieferumfang von Windows Server 2003 und Windows XP mit Service Pack 1 (SP1) enthalten ist.
/n	ProductCode	Gibt eine bestimmte Instanz des Produkts an. Wird verwendet, um eine Instanz zu identifizieren, die im Rahmen der Unterstützung für mehrere Instanzen über eine Transformation zur Produktcodeänderung installiert wurde. Verfügbar ab der Windows Installer-Version, die im Lieferumfang von Windows Server 2003 und Windows XP mit SP1 enthalten ist.

Die folgenden Optionen sollten nicht zusammen verwendet werden: /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y, /z. Die einzige Ausnahme von dieser Regel ist, dass zum Patchen einer administrativen Installation sowohl „/p“ als auch „/a“ verwendet werden müssen. Die Optionen „/t“, „/c“ und „/g“ sollten nur mit „/j“ verwendet werden. Die Optionen „/l“ und „/q“ können mit folgenden Optionen verwendet werden: /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p Die Option „/n“ kann mit „/i“, „/f“, „/x“ und „/p“ verwendet werden.

Um ein Produkt aus „A:\Example.msi“ zu installieren, installieren Sie das Produkt wie folgt:

msiexec /i A:\Example.msi

Nur öffentliche Eigenschaften können über die Befehlszeile geändert werden. Alle Eigenschaftennamen in der Befehlszeile werden als Großbuchstaben interpretiert, aber der Wert behält die Groß-/Kleinschreibung bei. Wenn Sie MyProperty in einer Befehlszeile eingeben, überschreibt der Installer den Wert von MYPROPERTY und nicht den Wert von MyProperty in der Property-Tabelle. Weitere Informationen hierzu finden Sie unter Informationen zu Eigenschaften.

Um ein Produkt zu installieren, bei dem PROPERTY auf VALUE festgelegt ist, verwenden Sie in der Befehlszeile die folgende Syntax. Sie können die Eigenschaft an einer beliebigen Stelle platzieren, außer zwischen einer Option und dem zugehörigen Argument.

Korrekte Syntax:

msiexec /i A:\Example.msi PROPERTY=VALUE

Falsche Syntax:

msiexec /i PROPERTY=VALUE A:\Example.msi

Eigenschaftenwerte, bei denen es sich um Literalzeichenfolgen handelt, müssen in Anführungszeichen eingeschlossen werden. Fügen Sie den gesamten Leerraum in der Zeichenfolge zwischen den Markierungen ein.

msiexec /i A:\Example.msi PROPERTY="Eingebetteter Leerraum"

Um eine öffentliche Eigenschaft über die Befehlszeile zu löschen, legen Sie ihren Wert auf eine leere Zeichenfolge fest.

msiexec /i A:\Example.msi PROPERTY=""

Für Textabschnitte, die durch Literalanführungszeichen getrennt sind, schließen Sie den Abschnitt mit einem zweiten Paar Anführungszeichen ein.

msiexec /i A:\Example.msi PROPERTY="Eingebetteter ""Anführungszeichen"" Leerraum"

Das folgende Beispiel zeigt eine komplexe Befehlszeile.

msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" and ""Gizmos."""

Das folgende Beispiel zeigt Ankündigungsoptionen. Beachten Sie, dass bei Optionen nicht die Groß-/Kleinschreibung beachtet wird.

msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt

Das folgende Beispiel zeigt, wie Sie eine neue Instanz eines Produkts installieren, das angekündigt werden soll. Dieses Produkt ist so konzipiert, dass es mehrere Instanztransformationen unterstützt.

msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt

Das folgende Beispiel zeigt, wie Sie eine Instanz eines Produkts patchen, das über mehrere Instanztransformationen installiert wurde.

msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb

Wenn Sie Patches auf ein bestimmtes Produkt anwenden, können die Optionen „/i“ und „/p“ nicht zusammen in einer Befehlszeile angegeben werden. In diesem Fall können Sie Patches wie folgt auf ein Produkt anwenden.

msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb

Die Eigenschaft PATCH kann nicht in einer Befehlszeile festgelegt werden, wenn die Option „/p“ verwendet wird. Wenn die PATCH-Eigenschaft bei Verwendung der Option „/p“ festgelegt ist, wird der Wert der PATCH-Eigenschaft ignoriert und überschrieben.