Options de ligne de commande

Le programme exécutable qui interprète les packages et installe les produits est Msiexec.exe. Notez que Msiexec définit également un niveau d’erreur sur le retour qui correspond aux codes d’erreur système. Les options de ligne de commande ne respectent pas la casse.

Les options de ligne de commande du tableau suivant sont disponibles avec Windows Installer 3.0 et versions antérieures. Les options de ligne de commande du programme d’installation standard sont également disponibles à partir de Windows Installer 3.0.

Option Paramètres Signification
/I Package|ProductCode Installe ou configure un produit.
/f [p|o|e|d|c|a|u|m|s|v] Package|ProductCode Répare un produit. Cette option ignore toutes les valeurs de propriété entrées sur la ligne de commande. La liste d’arguments par défaut pour cette option est « omus ». Cette option partage la même liste d’arguments que la propriété REINSTALLMODE.
p - Réinstalle uniquement si le fichier est manquant.
o - Réinstalle si le fichier est manquant ou si une version antérieure est installée.
e - Réinstalle si le fichier est manquant ou si une version égale ou antérieure est installée.
d - Réinstalle si le fichier est manquant ou si une autre version est installée.
c - Réinstalle si le fichier est manquant ou si la somme de contrôle stockée ne correspond pas à la valeur calculée. Répare uniquement les fichiers qui ont msidbFileAttributesChecksum dans la colonne Attributes de la table File.
a - Force la réinstallation de tous les fichiers.
u - Réécrit toutes les entrées de Registre spécifiques à l’utilisateur requises.
m - Réécrit toutes les entrées de Registre spécifiques à l’ordinateur requises.
s - Remplace tous les raccourcis existants.
v - S’exécute à partir de la source et met à nouveau en cache le package local. N’utilisez pas l’option de réinstallation v pour la première installation d’une application ou d’une fonctionnalité.
/a Package Option d’installation administrative. Installe un produit sur le réseau.
/x Package|ProductCode Désinstalle un produit.
/j [u|m]Packageor
[u|m]Package/tListe de transformations
or
[u|m]Package/gLanguageID
Publie un produit. Cette option ignore toutes les valeurs de propriété entrées sur la ligne de commande.
u - Publie auprès de l’utilisateur actuel.
m - Publie à tous les utilisateurs de l’ordinateur.
g - Identificateur de langue.
t - Applique la transformation au package publié.
/L [i|w|e|a|r|u|c|m|o|p|v|x|+|!| *] Fichier journal Écrit les informations de journalisation dans un fichier journal au niveau du chemin d’accès existant spécifié. Le chemin d’accès à l’emplacement du fichier journal doit déjà exister. Le programme d’installation ne crée pas la structure de répertoires pour le fichier journal. Les indicateurs indiquent les informations à consigner. Si aucun indicateur n’est spécifié, la valeur par défaut est « iwearmo ».
i - Messages d’état.
w - Avertissements récupérables.
e - Tous les messages d'erreur.
a - Démarrage des actions.
r - Enregistrements spécifiques à certaines actions.
u - Requêtes de l'utilisateur.
c - Paramètres initiaux de l’interface utilisateur.
m - Mémoire insuffisante ou informations de sortie irrécupérables.
o - Messages d’espace disque insuffisant.
p - Propriétés du terminal.
v – Mode documenté.
x - Informations de débogage supplémentaires. Windows Installer 2.0 : non pris en charge. L’option x est disponible avec Windows Installer version 3.0.3790.2180 et versions ultérieures.

+ - Ajoutez au fichier existant.
! - Videz chaque ligne dans le journal.
« * » - caractère générique, consignez toutes les informations à l’exception des options v et x. Pour inclure les options v et x, spécifiez « /l*vx ».

Remarque :
Pour plus d’informations sur toutes les méthodes disponibles pour définir le mode de journalisation, consultez Journalisation normale dans la section Journalisation Windows Installer


/m filename

Remarque :
La longueur du nom de fichier ne doit pas dépasser huit caractères.


Génère un fichier .mif d’état SMS. Doit être utilisé avec les options d’installation (-i), de suppression (-x), d’installation administrative (-a) ou de réinstallation (-f). Le ISMIF32.DLL est installé dans le cadre de SMS et doit se trouver sur le chemin.
Les champs du fichier mif d’état sont remplis avec les informations suivantes :
Fabricant - Auteur
Produit - Numéro de révision
Version - Sujet
Paramètres régionaux - Modèle
Numéro de série - non défini
Installation - définie par ISMIF32.DLL sur « DateTime »
InstallStatus - « Réussite » ou « Échec »
Description - Messages d’erreur dans l’ordre suivant : 1) Messages d’erreur générés par le programme d’installation. 2) Ressource de Msi.dll si l’installation n’a pas pu démarrer ou si l’utilisateur n’a pas pu quitter. 3) Fichier de message d’erreur système. 4) Message mis en forme : « Erreur du programme d’installation %i », où %i est une erreur renvoyée par Msi.dll.
/p PatchPackage[;patchPackage2 ] Applique un correctif. Pour appliquer un correctif à une image d’administration installée, vous devez combiner les options suivantes :
/p <PatchPackage>[;p atchPackage2 ] /a \<Package>
/q n|b|r|f Définit le niveau de l’interface utilisateur.
q , qn - Aucune interface utilisateur
qb - Interface utilisateur de base. Utilisez qb! pour masquer le bouton Annuler .
qr : interface utilisateur réduite sans boîte de dialogue modale affichée à la fin de l’installation.
qf : interface utilisateur complète et toutes les boîtes de dialogue FatalError, UserExit ou Exit modales créées à la fin.
qn+ : aucune interface utilisateur à l’exception d’une boîte de dialogue modale affichée à la fin.
qb+ - Interface utilisateur de base avec une boîte de dialogue modale affichée à la fin. La zone modale ne s’affiche pas si l’utilisateur annule l’installation. Utilisez qb+! ou qb!+ pour masquer le bouton Annuler .
qb- - Interface utilisateur de base sans boîtes de dialogue modales. Notez que /qb+- n’est pas un niveau d’interface utilisateur pris en charge. Utilisez qb-! ou qb!- pour masquer le bouton Annuler .
Notez que le ! est disponible avec Windows Installer 2.0 et fonctionne uniquement avec l’interface utilisateur de base. Elle n’est pas valide avec l’interface utilisateur complète.
/? ou /h Affiche les informations de copyright pour Windows Installer.
/y module Appelle la fonction système DllRegisterServer pour auto-inscrire les modules passés sur la ligne de commande. Spécifiez le chemin d’accès complet à la DLL. Par exemple, pour MY_FILE.DLL dans le dossier actif, vous pouvez utiliser :
msiexec /y .\MY_FILE.DLL
Cette option est utilisée uniquement pour les informations de Registre qui ne peuvent pas être ajoutées à l’aide des tables de Registre du fichier .msi.
/Z module Appelle la fonction système DllUnRegisterServer pour annuler l’inscription des modules passés sur la ligne de commande. Spécifiez le chemin d’accès complet à la DLL. Par exemple, pour MY_FILE.DLL dans le dossier actif, vous pouvez utiliser :
msiexec /z .\MY_FILE.DLL
Cette option est utilisée uniquement pour les informations de Registre qui ne peuvent pas être supprimées à l’aide des tables de Registre du fichier .msi.
/c Publie une nouvelle instance du produit. Cette option doit être utilisée en conjonction avec /t. Disponible à partir de la version de Windows Installer fournie avec Windows Server 2003 et Windows XP avec Service Pack 1 (SP1).
/n ProductCode Spécifie une instance particulière du produit. Permet d’identifier une instance installée à l’aide de la prise en charge de plusieurs instances via des transformations de modification de code de produit. Disponible à partir de la version de Windows Installer fournie avec Windows Server 2003 et Windows XP avec SP1.

Les options /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y et /z ne doivent pas être utilisées ensemble. La seule exception à cette règle est que la mise à jour corrective d’une installation administrative nécessite l’utilisation de /p et /a. Les options /t, /c et /g doivent être utilisées uniquement avec /j. Les options /l et /q peuvent être utilisées avec /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a et /p. L’option /n peut être utilisée avec /i, /f, /x et /p.

Pour installer un produit à partir de A:\Example.msi, installez-le comme suit :

msiexec /i A:\Example.msi

Seules les propriétés publiques peuvent être modifiées à l’aide de la ligne de commande. Tous les noms de propriété sur la ligne de commande sont interprétés en majuscules, mais la valeur conserve le respect de la casse. Si vous entrez MyProperty sur une ligne de commande, le programme d’installation remplace la valeur de MYPROPERTY et non la valeur de MyProperty dans la table Propriété. Pour plus d’informations, voir Questions fréquentes sur les propriétés.

Pour installer un produit avec PROPERTY défini sur VALUE, utilisez la syntaxe suivante sur la ligne de commande. Vous pouvez placer la propriété n’importe où, sauf entre une option et son argument.

Syntaxe correcte :

msiexec /i A:\Example.msi PROPERTY=VALUE

Syntaxe incorrecte :

msiexec /i PROPERTY=VALUE A:\Example.msi

Les valeurs de propriété qui sont des chaînes littérales doivent être placées entre guillemets. Incluez tous les espaces blancs dans la chaîne entre les marques.

msiexec /i A:\Example.msi PROPERTY="Embedded White Space"

Pour effacer une propriété publique à l’aide de la ligne de commande, définissez sa valeur sur une chaîne vide.

msiexec /i A:\Example.msi PROPERTY=""

Pour les sections de texte séparées par des guillemets littéraux, placez la section d’une deuxième paire de guillemets.

msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" White Space"

L’exemple suivant montre une ligne de commande compliquée.

msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" and ""Gizmos."""

L’exemple suivant montre les options de publication. Elles ne tiennent pas compte des majuscules.

msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt

L’exemple suivant vous montre comment installer une nouvelle instance d’un produit à publier. Ce produit est créé pour prendre en charge plusieurs transformations d’instance.

msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt

L’exemple suivant montre comment corriger une instance d’un produit qui est installée à l’aide de plusieurs transformations d’instance.

msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb

Lorsque vous appliquez des correctifs à un produit spécifique, les options /i et /p ne peuvent pas être spécifiées ensemble dans une ligne de commande. Dans ce cas, vous pouvez appliquer des correctifs à un produit comme suit.

msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb

La propriété PATCH ne peut pas être définie dans une ligne de commande lorsque l’option /p est utilisée. Si la propriété PATCH est définie lorsque l’option /p est utilisée, la valeur de la propriété PATCH est ignorée et remplacée.