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 Command-Line 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] Paquet|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 de 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 version différente 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 Attributs de la table Fichier . 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/tTransform List 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 - Annonce à 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 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 non fatals. e - Tous les messages d’erreur. a - Démarrage d’actions. r - Enregistrements spécifiques à l’action. u - Demandes de l’utilisateur. c - Paramètres d’interface utilisateur initiales. m - Informations de sortie insuffisantes ou irrécupérables. o - Messages d’espace disque insuffisants. p - Propriétés de terminal. v - Sortie détaillée. 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 ultérieures. + - Ajouter au fichier existant. ! - Videz chaque ligne dans le journal. « * » : caractère générique, journaliser toutes les informations à l’exception des options v et x. Pour inclure les options v et x, spécifiez « /l*vx ». [! Remarque] |
|
| /m | filename
[! Remarque] |
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 d’accès. Les champs du fichier mif d’état sont remplis avec les informations suivantes : Fabricant - Auteur Produit - Numéro de révision Version - Objet 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 quitter l’utilisateur. 3) Fichier de message d’erreur système. 4) Message mis en forme : « Erreur du programme d’installation %i », où %i est l’erreur retournée par Msi.dll. |
|
| /p | PatchPackage[;p atchPackage2 ] | Applique un correctif. Pour appliquer un correctif à une image administrative installée, vous devez combiner les options suivantes : /p <PatchPackage>[;p atchPackage2 ] /a \ Publie une nouvelle instance du produit. Doit être utilisé conjointement avec /t. Disponible à partir de la version du programme d’installation Windows 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 par le biais d’un code de modification de transformation de produit. Disponible à partir de la version 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 uniquement être utilisées 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 produit 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és sur la ligne de commande sont interprétés en majuscules, mais la valeur conserve la sensibilité de la casse. Si vous entrez MyProperty à une ligne de commande, le programme d’installation remplace la valeur de MYPROPERTY et non la valeur de MyProperty dans la table Property. Pour plus d’informations, consultez À propos des 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 du texte séparés par des guillemets littérals, placez la section avec 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" » et « "Gizmos."" »
L’exemple suivant montre les options d’annonce. Notez que les commutateurs ne respectent pas la casse.
msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt
L’exemple suivant 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 installé à 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.