Freigeben über

Internetdownload-Bootstrapping

  • Artikel

Mit Windows Installer ist eine konfigurierbare ausführbare Bootstrap-Datei (Setup.exe) und ein Konfigurationstool (Msistuff.exe) in den Windows SDK-Komponenten für Windows Installer-Entwickler enthalten. Mithilfe von Msistuff.exe zum Konfigurieren der Ressourcen in Setup.exe können Entwickler problemlos eine Webinstallation eines Windows Installer-Pakets erstellen.

Die für die ausführbare Bootstrapdatei erforderliche Mindestinstallationsversion ist Windows Installer Version 2.0. Anwendungen können die Installationsprogrammversion mithilfe von DllGetVersion abrufen. Weitere Informationen finden Sie unter Bestimmen der Windows Installer-Version.

Die mit dem Windows Installer SDK bereitgestellte ausführbare Bootstrapdatei führt Folgendes aus:

  • Ruft WinVerifyTrust auf, um die digitale Signatur der .msi-Datei zu überprüfen. Windows Installer, Version 2.0 und höher, stellt ein Subject Interface Package (SIP) bereit, um das Signieren von Windows Installer-Paketen zu ermöglichen.
  • Bei Bedarf wird die Version von Windows Installer auf dem Computer aktualisiert.

Die folgenden Ressourcen von Setup.exe können mit Msistuff.exe angezeigt oder konfiguriert werden.

Ressourcen-ID Beschreibung
ISETUPPROPNAME_BASEURL Der Basis-URL-Speicherort von Setup.exe. Wenn kein Wert angegeben ist, wird als Speicherort von Setup.exe standardmäßig ein Wechselmedium verwendet. Nur URL-basierte Installationen unterliegen einer Überprüfung mit WinVerifyTrust. Der abschließende Schrägstrich in der URL ist optional. Diese Ressource ist optional.
ISETUPPROPNAME_DATABASE Der Name der .msi-Datei. Dies ist ein relativer Pfad zur .msi-Datei, die relativ zum Speicherort des Setup.exe-Programms angegeben wurde. Diese Ressource ist erforderlich, wenn die Ressource ISETUPPROPNAME_PATCH nicht angegeben ist. ISETUPPROPNAME_DATABASE und ISETUPPROPNAME_PATCH können nicht beide angegeben werden. Es kann nur eines von beiden angegeben werden.
ISETUPPROPNAME_OPERATION Die Art der auszuführenden Operation. Mögliche Werte sind INSTALL, MINPATCH, MAJPATCH und INSTALLUPD. Der INSTALL-Wert entspricht der erstmaligen Installation des Pakets. Der MINPATCH-Wert gibt an, dass es sich bei dem in der PATCH-Eigenschaft angegebenen Patch um einen kleinen oder geringfügigen Upgradepatch handelt. Der MAJPATCH-Wert gibt an, dass der in der PATCH-Eigenschaft angegebene Patch ein großer Updatepatch ist. INSTALLUPD gibt an, dass die Installation zum ersten Mal oder ein Update sein könnte. Die Verwendung von INSTALLUPD ermöglicht die Bootstrap-Prüfung auf das Vorhandensein des Produkts. Wenn das Produkt vorhanden ist, wird das Recache-Paketflag gesetzt und eine Neuinstallation durchgeführt; andernfalls wird eine reguläre Installation ausgeführt. Beachten Sie, dass INSTALLUPD nur für kleine und geringfügige Upgradepakete verwendet werden sollte, bei denen sich der Produktcode nicht ändert. Bei einem größeren Upgrade ist eine NEUINSTALLATION nicht erforderlich, da sich der Produktcode ändert und im Wesentlichen ein völlig neues Produkt erstellt wird. Die Upgrade-Tabellenerstellung übernimmt zusätzlich zu den Aktionen FindRelatedProducts, MigrateFeatureStates und RemoveExistingProducts das Upgrade des Originalprodukts. Daher reicht die INSTALL-Option aus. Wenn diese Ressource fehlt, wird vom INSTALL-Vorgang ausgegangen, wenn die Eigenschaft ISETUPPROPNAME_DATABASE erstellt wurde. Andernfalls wird von MINPATCH ausgegangen, wenn die ISETUPPROPNAME_PATCH-Eigenschaft erstellt wird. Dies ist ein optionaler Wert.
ISETUPPROPNAME_PRODUCTNAME Der Name des Produkts. Dies ist der Name, der im Bannertext der heruntergeladenen Benutzeroberfläche verwendet wird. Diese Ressource ist optional. Wenn er ausgelassen wird, lautet der Name standardmäßig „das Produkt“.
ISETUPPROPNAME_MINIMUM_MSI Die Mindestversion von Windows Installer ist erforderlich. Wenn die Mindestversion von Windows Installer nicht auf dem Computer installiert ist, wird die entsprechende Instmsi.exe aufgerufen, um das Windows Installer-Upgrade durchzuführen. Der Wert dieser Eigenschaft hat das gleiche Format wie der PID_PAGECOUNT-Wert. Weitere Informationen finden Sie unter der Eigenschaft Page Count Summary. Dieser Wert muss mindestens 200 sein, der Wert, der die Windows Installer-Version 2.0 identifiziert. Diese Ressource ist erforderlich.
ISETUPPROPNAME_INSTLOCATION Der Basis-URL-Speicherort der ausführbaren Dateien des Windows Installer-Upgrades. Diese Ressource kann weggelassen werden. Wenn dieser Wert nicht angegeben wird, ist der Standardspeicherort der ausführbaren Upgradedatei der Speicherort von Setup.exe.
ISETUPPROPNAME_INSTMSIA Der Name der ANSI-Version der ausführbaren Datei des Windows Installer-Upgrades. Dies ist ein relativer Pfad zur ANSI-Version von Instmsi.exe relativ zu dem durch ISETUPPROPNAME_INSTLOCATION angegebenen Speicherort. Diese Ressource ist erforderlich.
ISETUPPROPNAME_INSTMSIW Der Name der Unicode-Version der ausführbaren Datei des Windows Installer-Upgrades. Dies ist ein relativer Pfad zur Unicode-Version von Instmsi.exe relativ zu dem durch ISETUPPROPNAME_INSTLOCATION angegebenen Speicherort. Diese Ressource ist erforderlich.
ISETUPPROPNAME_PATCH Der Name der .msp-Datei. Dies ist ein relativer Pfad zur .msp-Datei, die relativ zum Speicherort des Setup.exe-Programms angegeben wurde. Diese Ressource ist erforderlich, wenn die Ressource ISETUPPROPNAME_DATABASE nicht angegeben ist. ISETUPPROPNAME_DATABASE und ISETUPPROPNAME_PATCH können nicht beide angegeben werden. Es kann nur eines von beiden angegeben werden.
ISETUPPROPNAME_PROPERTIES Die Zeichenfolge PROPERTY=VALUE. Dies sind die PROPERTY=VALUE-Paare, die in die Befehlszeile aufgenommen werden sollen. Diese Option ist optional.

 

Beispielsweise würden die folgenden ISETUPPROPNAME_BASEURL- und ISETUPPROPNAME_DATABASE-Werte für die folgenden hypothetischen Paketspeicherorte verwendet.

Tatsächlicher Paketspeicherort Ressourcenwerte
https://www.blueyonderairlines.com/Products/Product1/product1.msi ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = product1.msi
https://www.blueyonderairlines.com/Products/Product1/product1.msi ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = ../Products1/product1.msi
e:\product1.msi Lassen Sie ISETUPPROPNAME_BASEURL aus. ISETUPPROPNAME_DATABASE = product1.msi
e:\setup\product1.msi (Der aktuelle Speicherort von Setup.exe ist e:\setup.exe.)
 Lassen Sie ISETUPPROPNAME_BASEURL aus. ISETUPPROPNAME_DATABASE = Setup\product1.msi

 

Setup.exe-Befehlszeilenparameter

In der folgenden Tabelle sind die Befehlsoptionen aufgeführt, die mit Setup.exe verwendet werden können, die mit den Windows SDK-Komponenten für Windows Installer-Entwickler bereitgestellt wird. Wenn Setup.exe ohne Befehlszeilenoptionen aufgerufen wird, verhält es sich standardmäßig so, wie es in den konfigurierten Ressourcen angegeben ist. Die Befehlszeilenoptionen schließen sich gegenseitig aus – es kann immer nur eine davon gleichzeitig verwendet werden.

Option Verbrauch Bedeutung
/a setup.exe /a Initiiert eine Administratorinstallation. Wenn die ISETUPPROPNAME_DATABASE-Eigenschaft in Setup.exe konfiguriert ist, kann diese Option verwendet werden, um eine Administratorinstallation des Produkts auszuführen. Diese Befehlszeilenoption wird nicht unterstützt, wenn die ISETUPPROPNAME_PATCH-Ressource konfiguriert ist.
/a setup.exe /a <Vollständiger Pfad zu einer vorhandenen Administratorinstallation> Wenn die ISETUPPROPNAME_PATCH-Eigenschaft in Setup.exe konfiguriert ist, kann diese Option verwendet werden, um eine vorhandene Administratorinstallation des Produkts zu patchen. Diese Befehlszeilenoption wird nicht unterstützt, wenn die ISETUPPROPNAME_DATABASE-Ressource konfiguriert ist.
/v setup.exe /v <Vollständiger Pfad zu einer Datei> Überprüft die Signatur in der Datei mithilfe von WinVerifyTrust. Wenn diese Option verwendet wird, wird keine Benutzeroberfläche angezeigt. In diesem Fall ist das Ergebnis der Vertrauensüberprüfung der Rückgabewert, der aus der Ausführung von Setup.exe abgerufen wird.
/?   Zeigt ein Hilfedialogfeld an, das die gültigen Argumente angibt. Hinweis: Das Hilfedialogfeld wird auch angezeigt, wenn ungültige Argumente angegeben werden.

 

Weitere Informationen finden Sie unter Ein URL-basiertes Installationsbeispiel für Windows Installer.