Instmsi.exe
Instmsi.exe ist das verteilbare Paket für die Installation von Windows Installer 2.0 und frühere Versionen von Windows Installer. Siehe Windows Installer Redistributables für die Redistributables für Windows Installer 3.0 und höheren Versionen.
Weitere Informationen dazu, welche Version von Windows Installer mit Ihrem Betriebssystem ausgeliefert wurde, finden Sie unter Veröffentlichte Versionen von Windows Installer.
Einige Redistributables sollten nicht für bestimmte Versionen des Betriebssystems ausgeführt werden. In der folgenden Tabelle wird beschrieben, welche Instmsi mit welchem Betriebssystem kompatibel ist.
| Wenn Instmsi.exe diese Version von Windows Installer installiert | Instmsi.exe kann auf diesen Betriebssystemen ausgeführt werden. | Instmsi.exe darf nicht auf diesen Betriebssystemen ausgeführt werden. |
|---|---|---|
| Windows Installer-Version 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-Version 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-Version 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-Version 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 Version 1.1 weiterverteilt, vor dem Ausführen des weiterverteilbaren Pakets überprüfen, ob es sich bei dem Betriebssystem um Windows NT 4.0 SP3 oder Windows 98/95 handelt. Bei Anwendungen, die das weiterverteilbare Paket verwenden, sollte außerdem sichergestellt werden, dass unter Windows 98/95 die ANSI-Version von Windows Installer 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 den Befehlszeilenoptionen wird die Groß- und Kleinschreibung beachtet.
| Option | Beschreibung |
|---|---|
| /q | Zur Verwendung durch Anwendungen, die den Windows Installer als Teil einer Bootstrapping-Anwendung neu verteilen. Dem Benutzer wird keine Benutzeroberfläche angezeigt. Die Bootstrapping-Anwendung sollte den Rückgabecode überprüfen, um zu ermitteln, ob ein Neustart erforderlich ist, um die Installation des Windows Installer abzuschließen. |
| /t | Wird nur zum Debuggen verwendet. |
| /c:"msiinst /delayreboot" | Die verzögerte Neustartoption. Verhindert, dass Instmsi den Benutzer zu einem Neustart auffordert, selbst wenn während der Installation verwendete Dateien ersetzt werden mussten. Wenn Instmsi mit dieser Option aufgerufen wird, wird ERROR_SUCCESS_REBOOT_REQUIRED zurückgegeben, wenn Dateien ersetzt werden müssen, die verwendet wurden. Wenn Dateien nicht ersetzt werden müssen, die verwendet wurden, 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 im Hintergrund der verzögerten Neustartoption. Dem Benutzer wird keine Benutzeroberfläche angezeigt. Andernfalls ist das Verhalten identisch mit der vorherigen Option. 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. |
Hinweise
Bei Bootstrapping-Anwendungen, die Instmsi.exe verwenden, um Windows Installer mit einer anderen Anwendung zu installieren, ist möglicherweise ein zusätzlicher Systemneustart erforderlich. Dies ist möglicherweise ein zusätzlicher Neustart zusätzlich zu den Neustarts, die zur Installation der Anwendung erforderlich sind.
Die Option des verzögerten Neustarts wird nur für Setup-Entwickler empfohlen, die einen zusätzlichen Neustart vermeiden möchten, der durch die Verwendung von Instmsi.exe mit einer Setup-Anwendung verursacht wird, die Dateien installiert, die gerade verwendet werden.
Entwickler sollten die folgenden Schritte in ihrer Setupanwendung ausführen, um die Verzögerte Neustartoption zu verwenden. Diese Option ist bei Instmsi.exe-Versionen, die Windows Installer-Versionen vor Version 2.0 installieren, nicht verfügbar:
So verwenden Sie die Option „Verzögerter Neustart“
Rufen Sie Instmsi.exe mit einer der Befehlszeilenoptionen für den verzögerten Neustart auf.
Behandeln Sie die Rückgabe von ERROR_SUCCESS oder ERROR_SUCCESS_REBOOT_REQUIRED als Erfolg.
Rufen Sie hier den Pfad zum Ordner ab, der die neu installierten Windows Installer-Binärdateien aus dem InstallerLocation-Wert enthält:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Installer
Dieser Wert ist vom Typ REG_SZ.
Legen Sie das aktuelle Verzeichnis auf den Pfad fest, der in Schritt 3 abgerufen wurde.
Rufen Sie Msiexec für das Paket der Anwendung auf, und führen Sie anderen Setupcode aus, der für die Anwendung spezifisch ist. Wenn die Setup-Anwendung MsiInstallProduct verwendet, muss die Anwendung die MSI.DLL aus dem in Schritt 3 erhaltenen Speicherort laden.
Hinweis
Anwendungen, die die LoadLibrary für die neue MSI.DLL in dem Speicherort aufrufen, der in Schritt 3 erhalten wurde, müssen sicherstellen, dass eine ältere Version der MSI.DLL noch nicht im Prozess geladen wurde. Wenn eine ältere Version der MSI.DLL innerhalb des Prozesses geladen wurde, muss sie vor dem Aufrufen von LoadLibrary für die neue MSI.DLL aus dem Prozessadressbereich entladen werden.
Wenn in Schritt (5) kein Neustart erforderlich ist und Instmsi.exe in Schritt (1) ERROR_SUCCESS_REBOOT_REQUIRED zurückgegeben hat, fordern Sie den Benutzer zu einem Neustart auf, um die Einrichtung der Windows Installer-Binärdateien auf dem System abzuschließen. Erfolgt jedoch im Schritt (5) ein Neustart, sind keine weiteren Schritte erforderlich.
Instmsi.exe ist in den Windows SDK-Komponenten für Windows Installer-Entwickler verfügbar.
Zugehörige Themen