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 du KIT de développement logiciel (SDK) Windows pour les développeurs Windows Installer. 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 de démarrage est Windows Installer version 2.0. Les applications peuvent obtenir la version du programme d’installation à l’aide de DllGetVersion. Pour plus d’informations, consultez Détermination de la version de Windows Installer

L’exécutable de démarrage fourni avec le Kit de développement logiciel (SDK) Windows Installer effectue les opérations suivantes :

  • Appelle WinVerifyTrust pour vérifier la signature numérique du fichier .msi. Windows Installer version 2.0 et versions ultérieures fournit un package d’interface objet (SIP) pour activer la signature des packages Windows Installer.
  • Si nécessaire, met à niveau la version de Windows Installer sur l’ordinateur.

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

ID de ressource Description
ISETUPPROPNAME_BASEURL Emplacement d’URL de base de Setup.exe. Si aucune valeur n’est spécifiée, l’emplacement de Setup.exe par défaut sur le support amovible. Seules les installations basées sur une URL sont soumises à une case activée avec WinVerifyTrust. La barre oblique de fin de l’URL est facultative. Cette ressource est facultative.
ISETUPPROPNAME_DATABASE Nom du fichier .msi. Il s’agit d’un chemin relatif vers le fichier .msi spécifié par rapport à l’emplacement du programme Setup.exe. Cette ressource est requise si la ressource ISETUPPROPNAME_PATCH n’est pas spécifiée. ISETUPPROPNAME_DATABASE et ISETUPPROPNAME_PATCH ne peuvent pas être spécifiés. Un seul des deux peut être spécifié.
ISETUPPROPNAME_OPERATION Spécifiez le type d’opération à effectuer. Les valeurs possibles sont INSTALL, MINPATCH, MAJPATCH et INSTALLUPD. La valeur INSTALL équivaut à la première installation du package. La valeur MINPATCH indique que le correctif spécifié dans la propriété PATCH est un correctif de mise à niveau petit ou mineur. La valeur MAJPATCH indique que le correctif spécifié dans la propriété PATCH est un correctif de mise à jour majeur. INSTALLUPD indique que l’installation peut être une première installation ou une mise à jour. L’utilisation d’INSTALLUPD a la vérification d’amorçage de la présence du produit. Si le produit est présent, l’indicateur de package de recache est défini et une réinstallation est effectuée ; dans le cas contraire, une installation régulière est effectuée. Notez que INSTALLUPD ne doit être utilisé que pour les packages de mise à niveau petits et mineurs pour lesquels le code produit ne change pas. Dans une mise à niveau majeure, REINSTALL n’est pas nécessaire, car le code produit change, créant essentiellement un tout nouveau produit. La création de tables de mise à niveau, en plus des actions FindRelatedProducts, MigrateFeatureStates et RemoveExistingProducts, gère la mise à niveau du produit d’origine. Par conséquent, l’option INSTALL est suffisante. Si cette ressource est manquante, l’opération INSTALL est supposée si la propriété ISETUPPROPNAME_DATABASE est créée. Sinon, MINPATCH est supposé si la propriété ISETUPPROPNAME_PATCH est créée. Cette étape est facultative.
ISETUPPROPNAME_PRODUCTNAME Nom du produit. Il s’agit du nom utilisé dans le texte de la bannière dans l’interface utilisateur téléchargée. Cette ressource est facultative. En cas d’omission, le nom par défaut est « le produit ».
ISETUPPROPNAME_MINIMUM_MSI Version minimale de Windows Installer requise. Si la version minimale de Windows Installer n’est pas présente sur l’ordinateur, le Instmsi.exe approprié est installé 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, consultez Propriété Page Count Summary. Cette valeur doit être d’au moins 200, la valeur qui identifie Windows Installer version 2.0. Cette ressource est requise.
ISETUPPROPNAME_INSTLOCATION Emplacement d’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 relatif vers la version ANSI de Instmsi.exe par rapport à l’emplacement spécifié par ISETUPPROPNAME_INSTLOCATION. Cette ressource est requise.
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 requise.
ISETUPPROPNAME_PATCH 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. Un seul des deux peut être spécifié.
ISETUPPROPNAME_PROPERTIES Chaînes de la valeur de propriété. Il s’agit des paires PROPERTY=VALUE à inclure sur la ligne de commande. Cette option est facultative.

 

Par exemple, les valeurs ISETUPPROPNAME_BASEURL et ISETUPPROPNAME_DATABASE suivantes sont 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 en cours d’exécution de Setup.exe est e:\setup.exe.)
 Omit ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = Setup\product1.msi

 

paramètres de ligne de commande Setup.exe

Le tableau suivant répertorie les options de commande qui peuvent être utilisées avec le Setup.exe fourni avec les composants du Kit de développement logiciel (SDK) Windows pour les développeurs Windows Installer. Lorsqu’il est appelé sans options de ligne de commande, Setup.exe par défaut au comportement spécifié via les ressources configurées. Les options de ligne de commande s’excluent mutuellement. Une seule d’entre elles peut être utilisée à la fois.

Option Usage 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 corriger 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 chemin d’accès complet /v<à un fichier> Vérifie la signature sur le 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 d’approbation est la valeur de retour obtenue à partir 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 s’affiche également si des arguments non valides sont fournis.

 

Pour plus d’informations, consultez Exemple d’installation Windows Installer basé sur une URL.