Amorçage du téléchargement Internet

  • Article

Avec Windows Installer, un exécutable de démarrage configurable (Setup.exe) et un outil de configuration (Msistuff.exe) sont inclus dans les composants SDK de Windows pour les développeurs d'installateurs Windows. En utilisant Msistuff.exe pour configurer les ressources dans Setup.exe, les développeurs peuvent facilement créer une installation Web d'un package Windows Installer.

La version minimale du programme d'installation requise par l'exécutable d'amorçage est la version 2.0 de Windows Installer. Les applications peuvent obtenir la version du programme d'installation en utilisant DllGetVersion. Pour plus d'informations, voir Déterminer la version du programme d'installation de Windows.

L'exécutable d'amorçage fourni avec le SDK Windows Installer effectue les opérations suivantes :

  • Il appelle WinVerifyTrust pour vérifier la signature numérique du fichier .msi. La version 2.0 de Windows Installer et les versions ultérieures fournissent un paquet d'interface sujet (SIP) pour permettre la signature des packages de Windows Installer.
  • Si nécessaire, mettez à jour la version de Windows Installer sur la machine.

Les ressources suivantes de Setup.exe peuvent être affichées ou configurées à l'aide de Msistuff.exe.

ID de ressource Description
ISETUPPROPNAME_BASEURL L'emplacement de l'URL de base de Setup.exe. Si aucune valeur n'est spécifiée, l'emplacement de Setup.exe est par défaut un support amovible. Seules les installations basées sur l'URL sont soumises à une vérification avec WinVerifyTrust. La barre oblique de fin d'URL est facultative. Cette ressource est facultative.
ISETUPPROPNAME_DATABASE Le nom du fichier .msi. Il s'agit d'un chemin d'accès relatif au fichier .msi spécifié par rapport à l'emplacement du programme Setup.exe. Cette ressource est obligatoire si la ressource ISETUPPROPNAME_PATCH n'est pas spécifiée. ISETUPPROPNAME_DATABASE et ISETUPPROPNAME_PATCH ne peuvent pas être spécifiés tous les deux. Seul l'un des deux peut être spécifié.
ISETUPPROPNAME_OPERATION Le type d'opération à effectuer. Les valeurs possibles sont INSTALL, MINPATCH, MAJPATCH et INSTALLUPD. La valeur INSTALL correspond à la première installation du package. La valeur MINPATCH indique que le correctif spécifié dans la propriété PATCH est un petit correctif ou une mise à jour mineure. La valeur MAJPATCH indique que le correctif spécifié dans la propriété PATCH est un correctif de mise à jour majeure. INSTALLUPD indique qu'il peut s'agir d'une première installation ou d'une mise à jour. L'utilisation de la valeur INSTALLUPD permet au système d'amorçage de vérifier la présence du produit. Si le produit est présent, l'indicateur de mise en cache du package est activé et une réinstallation est effectuée ; dans le cas contraire, une installation normale est effectuée. Notez que INSTALLUPD ne doit être utilisé que pour les packages de mise à niveau mineurs et de petite taille, pour lesquels le code du produit ne change pas. Dans le cas d'une mise à niveau majeure, il n'est pas nécessaire de procéder à une réinstallation, car le code du produit change, ce qui revient à créer un tout nouveau produit. La création de la table de mise à niveau ainsi que les actions FindRelatedProducts, MigrateFeatureStates et RemoveExistingProducts gèrent la mise à niveau du produit d'origine. L'option INSTALL est donc suffisante. Si cette ressource est manquante, l'opération INSTALL est supposée si la propriété ISETUPPROPNAME_DATABASE est authentifiée. Dans le cas contraire, l'opération MINPATCH est supposée si la propriété ISETUPPROPNAME_PATCH est authentifiée. Il s’agit d’une valeur facultative.
ISETUPPROPNAME_PRODUCTNAME Nom du produit. Il s'agit du nom utilisé dans le texte de la bannière de l'interface utilisateur téléchargée. Cette ressource est facultative. S'il est omis, le nom est par défaut "le produit".
ISETUPPROPNAME_MINIMUM_MSI La version minimale de Windows Installer requise. Si la version minimale de Windows Installer n'est pas installée sur l'ordinateur, le programme Instmsi.exe approprié est appelé pour mettre à niveau Windows Installer. La valeur de cette propriété a le même format que la valeur PID_PAGECOUNT. Pour plus d'informations, reportez-vous à la propriété Résumé du nombre de pages. Cette valeur doit être au moins égale à 200, valeur qui identifie la version 2.0 du programme d'installation de Windows. Cette ressource est obligatoire.
ISETUPPROPNAME_INSTLOCATION L'emplacement de l'URL de base des exécutables de mise à niveau de Windows Installer. Cette ressource peut être omise. Si cette valeur est omise, l'emplacement par défaut des exécutables de mise à niveau est l'emplacement de Setup.exe.
ISETUPPROPNAME_INSTMSIA Nom de la version ANSI de l'exécutable de mise à niveau de Windows Installer. Il s'agit d'un chemin d'accès relatif à la version ANSI d'Instmsi.exe par rapport à l'emplacement spécifié par ISETUPPROPNAME_INSTLOCATION. Cette ressource est obligatoire.
ISETUPPROPNAME_INSTMSIW Nom de la version Unicode de l'exécutable de mise à niveau de Windows Installer. Il s'agit d'un chemin relatif vers la version Unicode de Instmsi.exe par rapport à l'emplacement spécifié par ISETUPPROPNAME_INSTLOCATION. Cette ressource est obligatoire.
ISETUPPROPNAME_PATCH Le nom du fichier .msp. Il s'agit d'un chemin d'accès relatif au fichier .msp spécifié par rapport à l'emplacement du programme Setup.exe. Cette ressource est requise si la ressource ISETUPPROPNAME_DATABASE n'est pas spécifiée. ISETUPPROPNAME_DATABASE et ISETUPPROPNAME_PATCH ne peuvent pas être spécifiés tous les deux. Seul l'un des deux peut être spécifié.
ISETUPPROPNAME_PROPERTIES Les chaînes PROPERTY=VALUE. Il s'agit des appaires PROPERTY=VALUE à inclure dans la ligne de commande. Cette option est facultative.

 

Par exemple, les valeurs ISETUPPROPNAME_BASEURL et ISETUPPROPNAME_DATABASE suivantes seraient utilisées pour les emplacements de package hypothétiques suivants.

Emplacement réel du package Valeurs de ressources
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 Omit ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = product1.msi
e:\setup\product1.msi (L'emplacement actuel de Setup.exe est e:\setup.exe.)
 Omit ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = Setup\product1.msi

 

Paramètres de la ligne de commande de Setup.exe

Le tableau suivant répertorie les options de commande pouvant être utilisées avec le fichier Setup.exe fourni avec les composants Windows SDK pour les développeurs de programmes d'installation Windows. Lorsqu'il est invoqué sans aucune option de ligne de commande, Setup.exe adopte par défaut le comportement spécifié via les ressources configurées. Les options de la ligne de commande s'excluent mutuellement - une seule d'entre elles peut être utilisée à la fois.

Option Utilisation Signification
/a setup.exe /a Lance une installation administrative. Si la propriété ISETUPPROPNAME_DATABASE est configurée dans Setup.exe, cette option peut être utilisée pour effectuer une installation administrative du produit. Cette option de ligne de commande n'est pas prise en charge si la ressource ISETUPPROPNAME_PATCH est configurée.
/a setup.exe /a <chemin d'accès complet à une installation administrative existante> Si la propriété ISETUPPROPNAME_PATCH est configurée dans Setup.exe, cette option peut être utilisée pour patcher une installation administrative existante du produit. Cette option de ligne de commande n'est pas prise en charge si la ressource ISETUPPROPNAME_DATABASE est configurée.
/v setup.exe /v <chemin complet d'un fichier> Vérifie la signature du fichier à l'aide de WinVerifyTrust. Aucune interface utilisateur n'est affichée lorsque cette option est utilisée. Dans ce cas, le résultat de la vérification de la confiance est la valeur de retour obtenue lors de l'exécution de Setup.exe.
/?   Affiche une boîte de dialogue d'aide indiquant les arguments valides. Remarque : la boîte de dialogue d'aide est également affichée si des arguments non valides sont fournis.

 

Pour plus d'informations, consultez l'exemple d'installation d'un programme d'installation Windows basé sur une URL.