Instmsi.exe
„Instmsi.exe“ ist das verteilbare Paket für die Installation von Windows Installer 2.0 und früheren Versionen von Windows Installer. Die verteilbaren Dateien für Windows Installer 3.0 und höher finden Sie unter Verteilbare Dateien für Windows Installer.
Weitere Informationen dazu, welche Windows Installer-Version mit Ihrem Betriebssystem ausgeliefert wurde, finden Sie unter Veröffentlichte Windows Installer-Versionen.
Einige verteilbare Dateien sollten unter bestimmten Betriebssystemversionen nicht ausgeführt werden. In der folgenden Tabelle wird beschrieben, welche Instmsi-Datei mit welchem Betriebssystem kompatibel ist.
| Installation dieser Windows Installer-Version durch „Instmsi.exe“ | Ausführung von „Instmsi.exe“ unter diesen Betriebssystemen möglich | Ausführung von „Instmsi.exe“ unter diesen Betriebssystemen nicht zulässig |
|---|---|---|
| Windows Installer 1.0 | Windows 95, Windows 98, Windows NT 4.0+SP3 | Windows Me, Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer 1.1 | Windows 95, Windows 98, Windows NT 4.0+SP3 | Windows Me, Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer 1.2 | Windows 95, Windows 98, Windows Me, Windows NT 4.0+SP3 | Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer 2.0 | Windows 95, Windows 98, Windows Me, Windows NT 4.0+SP6, Windows 2000 | Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
Beispielsweise sollte eine Anwendung, die Windows Installer 1.1 verteilt, überprüfen, ob das Betriebssystem Windows NT 4.0 SP3 oder Windows 98/95 ist, bevor sie das verteilbare Paket ausführt. Anwendungen, die das verteilbare Paket verwenden, sollten auch sicherstellen, dass unter Windows 98/95 die ANSI-Version des Windows Installers und unter Windows NT oder Windows 2000 die Unicode-Version installiert ist. Beachten Sie, dass einige Anwendungen die Unicode-Version in „InstMsiW“ umbenennen.
Syntax
instmsi: Optionen
Befehlszeilenoptionen
Bei Befehlszeilenoptionen wird die Groß-/Kleinschreibung nicht beachtet.
| Option | BESCHREIBUNG |
|---|---|
| /q | Zur Verwendung durch Anwendungen, die den Windows Installer im Rahmen einer Bootstrappinganwendung verteilen. Benutzer*innen wird keine Benutzeroberfläche angezeigt. Die Bootstrappinganwendung muss den Rückgabecode überprüfen, um zu ermitteln, ob ein Neustart erforderlich ist, um die Installation des Windows Installers abzuschließen. |
| /t | Nur für Debuggingzwecke verwendet. |
| /c:"msiinst /delayreboot" | Die Option für einen verzögerten Neustart. Verhindert, dass „Instmsi“ Benutzer*innen zum Neustart auffordert, auch wenn Dateien ersetzt werden mussten, die während der Installation verwendet wurden. Beim Aufruf von „Instmsi“ mit dieser Option wird ERROR_SUCCESS_REBOOT_REQUIRED zurückgegeben, wenn verwendete Dateien ersetzt werden mussten. Wenn verwendete Dateien nicht ersetzt werden mussten, wird ERROR_SUCCESS zurückgegeben. Verfügbar mit „Instmsi“ für Windows Installer 2.0 oder höher. Weitere Informationen zu verzögerten Neustarts finden Sie im Abschnitt „Hinweise“. |
| /c:"msiinst /delayrebootq" | Die Version der Option für einen verzögerten Neustart im stillen Modus. Benutzer*innen wird keine Benutzeroberfläche angezeigt. Abgesehen davon ist das Verhalten mit der vorherigen Option identisch. Verfügbar mit „Instmsi“ für Windows Installer 2.0 oder höher. Weitere Informationen zu verzögerten Neustarts finden Sie im Abschnitt „Hinweise“. |
| /? | Zeigt die Hilfe an. |
Bemerkungen
Bootstrapping-Anwendungen, die „Instmsi.exe“ verwenden, um den Windows Installer mit einer anderen Anwendung zu installieren, erfordern möglicherweise einen zusätzlichen Systemneustart. Dabei kann es sich um einen weiteren Neustart handeln, der zusätzlich zu allen Neustarts ausgeführt wird, die zum Installieren der Anwendung erforderlich sind.
Die Option für einen verzögerten Neustart wird nur beim Entwickeln von Setups empfohlen, bei denen ein zusätzlicher Neustart durch die Verwendung von „Instmsi.exe“ mit einer Setupanwendung vermieden werden soll, die in Verwendung befindliche Dateien installiert.
Entwickler*innen sollten ihre Setupanwendung folgendermaßen einrichten, um die Option für einen verzögerten Neustart zu verwenden. Diese Option ist nicht mit Instmsi.exe Versionen verfügbar, die Windows Installer-Versionen vor 2.0 installieren:
Verwenden der Option für einen verzögerten Neustart
Rufen Sie „Instmsi.exe“ mit einer der Befehlszeilenoptionen für einen verzögerten Neustart auf.
Behandeln Sie die Rückgabe von ERROR_SUCCESS oder ERROR_SUCCESS_REBOOT_REQUIRED als Erfolg.
Rufen Sie aus dem InstallerLocation-Wert den Pfad zu dem Ordner ab, der die neu installierten Windows Installer-Binärdateien enthält:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Installer
Dieser Wert ist vom Typ REG_SZ.
Legen Sie das aktuelle Verzeichnis auf den in Schritt 3 abgerufenen Pfad fest.
Rufen Sie „Msiexec“ für das Paket der Anwendung auf, und führen Sie einen anderen für die Anwendung spezifischen Setupcode aus. Wenn die Setupanwendung MsiInstallProduct verwendet, muss die Anwendung die MSI.DLL-Datei aus dem in Schritt 3 abgerufenen Speicherort laden.
Hinweis
Anwendungen, die LoadLibrary für die neue MSI.DLL-Datei an dem in Schritt 3 abgerufenen Speicherort aufrufen, müssen sicherstellen, dass im Prozess noch keine ältere Version von „MSI.DLL“ geladen wurde. Wenn im Prozess bereits eine ältere Version von „MSI.DLL“ geladen wurde, muss sie vor dem LoadLibrary-Aufruf für die neue MSI.DLL-Datei aus dem Prozessadressraum entladen werden.
Wenn Schritt 5 keinen Neustart erfordert und „Instmsi.exe“ in Schritt 1 ERROR_SUCCESS_REBOOT_REQUIRED zurückgegeben hat, fordern Sie Benutzer*innen zum Neustart auf, um die Einrichtung der Windows Installer-Binärdateien im System abzuschließen. Wenn jedoch in Schritt 5 ein Neustart erfolgt, sind keine zusätzlichen Schritte erforderlich.
„Instmsi.exe“ ist nur in den Windows SDK-Komponenten für Windows Installer-Entwickler verfügbar.
Zugehörige Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für