Options de ligne de commande du programme d’installation de Windows

Les options de ligne de commande suivantes sont disponibles pour le programme d’installation de Windows (setup.exe). À compter de Windows 10 version 1607, vous pouvez utiliser un fichier setupconfig comme alternative au passage de paramètres au programme d’installation de Windows sur une ligne de commande. Pour plus d’informations, consultez Vue d’ensemble de l’automatisation du programme d’installation de Windows.


/1394Debug

Active le débogage du noyau sur un port IEEE 1394 (FireWire) pendant que Windows est en cours d’exécution et pendant la passe de configuration WindowsPE du programme d’installation de Windows.

Syntaxe
/1394Debug:<channel> [BaudRate:<baudrate>]


Exemples

setup /1394debug:1 /baudrate:115200


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
La valeur par défaut de <channel> est 1. <baudrate> spécifie la vitesse (en bauds) à utiliser lorsque Windows transfère des données pendant le débogage. La valeur par défaut est 19 200, mais elle peut également être définie sur 57 600 ou 115 200.


/AddBootMgrLast

Indique au programme d’installation de Windows d’ajouter le Gestionnaire de démarrage Windows comme dernière entrée dans l’ordre de démarrage du microprogramme UEFI.

Syntaxe
/AddBootMgrLast


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 et d’une version ultérieureNon
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option est prise en charge uniquement sur les PC UEFI exécutant Windows PE 4.0 ou une version ultérieure.


/Auto

Effectue une mise à niveau automatisée vers une version plus récente de Windows.


Syntaxe
/Auto {Clean | DataOnly | Upgrade}


Paramètres

Paramètre Description
NettoyerEffectue une nouvelle installation de Windows.
DataOnlyEffectue une mise à niveau de Windows, en enregistrant uniquement les données (et non les applications). Si l’option d’installation « données uniquement » n’est pas disponible en raison de vérifications de compatibilité, le programme d’installation de Windows se ferme en mode silencieux et enregistre un code de sortie.
Mise à niveauEffectue une mise à niveau de Windows en enregistrant les applications et les données. Si l’option d’installation de mise à niveau n’est pas disponible ou si l’utilisateur doit résoudre un problème de compatibilité d’application, le programme d’installation de Windows se ferme en mode silencieux et enregistre un code de sortie.

À compter de Windows 11, version 22H2, la spécification de l’option Upgrade nécessite que le support d’installation possède le même langage d’interface utilisateur par défaut du système que l’appareil cible. Dans les versions antérieures de Windows, vous pouviez effectuer certains déploiements inter-langages (par exemple, en-US vers en-GB), mais ces types de mises à niveau ne sont plus autorisés.
NoAutoEitNon utilisé à partir de Windows 10. Dans Windows 8.1, si une erreur est trouvée, le programme d’installation de Windows ne se ferme pas, mais s’arrête et reste sur l’écran d’installation de Windows jusqu’à ce que l’utilisateur résolve le problème. L’installation à partir de ce point est assistée.
PerformDUNon utilisé à partir de Windows 10. Dans Windows 8.1, le programme d’installation de Windows recherche les mises à jour dynamiques pour le programme d’installation de Windows


Exemples

setup /auto clean
setup /auto dataonly
setup /auto upgrade


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Lorsque /Auto est utilisé, un fichier sans assistance ne peut pas être utilisé. Lorsque /Auto est utilisé, le programme d’installation de Windows utilise ei.cfg et vérifie les problèmes de compatibilité avant de démarrer l’installation. Si ei.cfg est mal formé, le programme d’installation de Windows se ferme silencieusement et enregistre un code de sortie. Consultez les codes de sortie du programme d’installation de Windows ci-dessous. Lorsque /Auto est utilisé, seules les personnalisations suivantes de l’image Windows sont prises en charge. Il ne s’agit pas d’une modification de la stratégie de prise en charge du programme d’installation de Windows, mais plutôt d’une clarification :

  • Application d’une mise à jour cumulative (qualité)
  • Application de mises à jour à la pile de maintenance, nécessaire pour terminer la mise à jour des fonctionnalités (consultez Mises à jour de la pile de maintenance pour plus d’informations)
  • Application de mises à jour aux fichiers binaires Setup.exe ou à d’autres fichiers utilisés par le programme d’installation pour les mises à jour des fonctionnalités
  • Applications de mises à jour pour le « système d’exploitation sécurisé » (SafeOS) utilisé pour l’environnement de récupération Windows
  • Ajout ou suppression de langages
  • Ajout ou suppression de Fonctionnalités à la demande

Pour plus de clarté, lorsque /Auto est utilisé, le programme d’installation de Windows ne prend pas en charge les mises à niveau ni les nouvelles installations vers une image Windows qui a été personnalisée en ajoutant / supprimant / modifiant des applications, des paramètres et des pilotes.

Lorsque /Auto est utilisé, le programme d’installation de Windows est mis à niveau à l’aide de l’image Windows \sources\install.wim. À l’aide de Dism /Export-Image, cette image peut être utilisée comme image source pour exporter une nouvelle image à l’aide de l’option /Compress:recovery. Cette image exportée doit être nommée install.esd pour que le programme d’installation de Windows l’utilise, au lieu d’install.wim. Vous devez également supprimer install.wim de \sources. Vous devez exporter vers install.esd uniquement si vous souhaitez réduire la taille de l’image Windows. L’image exportée sera plus petite, mais ne sera pas montable.

À compter de Windows 11, /Auto n’acceptera pas ni ne supprimera le contrat de licence utilisateur final. Voir /EULA.


/BitLocker

Spécifie l’état BitLocker pendant les mises à niveau.

Syntaxe
/BitLocker {AlwaysSuspend | TryKeepActive | ForceKeepActive}


Paramètres

Paramètre Description
AlwaysSuspendBitLocker est toujours suspendu pendant une mise à niveau.
TryKeepActiveTente une mise à niveau sans suspendre BitLocker. Si la mise à niveau échoue, le programme d’installation de Windows suspendra BitLocker et terminera la mise à niveau. Il s’agit du comportement par défaut si l’option /BitLocker n’est pas spécifiée.
ForceKeepActiveActive la mise à niveau sans suspendre BitLocker. Si la mise à niveau ne peut pas être terminée, car BitLocker est actif, la mise à niveau échouera.


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui

/BusParams

Spécifie l’adresse PCI d’un port de débogage 1394, USB ou NET.

Syntaxe
/BusParams:<bus.device.function>


Exemples

setup /busparams:0.29.7


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Les numéros de bus, d’appareilet de fonction doivent être au format décimal. Pour plus d’informations, consultez Configuration du débogage du noyau avec USB 2.0.


/ConfigFile

Spécifie l’emplacement du fichier setupconfig.

Syntaxe
/ConfigFile:<location>


Paramètres

Paramètre Description
<location>Chemin d’accès au fichier local ou chemin d’accès réseau UNC à un dossier qui contient le fichier de configuration du programme d’installation de Windows.


Exemples

setup /ConfigFile:\\server\share\


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Si vous incluez une option sur la ligne de commande et la même option dans le fichier setupconfig, l’option et la valeur du fichier setupconfig sont prioritaires.


/CompactOS

Spécifie s’il faut utiliser la fonctionnalité Compact OS pour économiser de l’espace sur le disque dur.

Syntaxe
/CompactOS {Enable | Disable}


Paramètres

Paramètre Description
ActiverLe programme d’installation de Windows installe Windows à l’aide de fichiers système compressés.
DésactiverLe programme d’installation de Windows installe Windows à l’aide de fichiers système non compressés.


Exemples

setup /compactos enable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Par défaut, le programme d’installation de Windows détermine s’il faut utiliser cette fonctionnalité automatiquement. Pour en savoir plus sur Compact OS, consultez Compact OS, instanciation unique et optimisation d’image.


/Compat

Indique au programme d’installation de Windows comment gérer les analyses et les messages de compatibilité.

Syntaxe
/Compat {IgnoreWarning | ScanOnly}


Paramètres

Paramètre Description
IgnoreWarningLe programme d’installation de Windows termine l’installation, ignorant les messages de compatibilité révocables.
ScanOnlyLe programme d’installation de Windows s’exécute via des analyses de compatibilité, puis quitte (sans terminer l’installation) avec un code de sortie pour indiquer si des problèmes de compatibilité sont présents. Le programme d’installation de Windows retourne 0xC1900210 si aucun problème n’est détectés. Le programme d’installation de Windows retourne 0xC1900208 si des problèmes de compatibilité sont détectés.


Exemples

setup /compat ignorewarning


Cette commande fonctionne avec d’autres commutateurs. Pour exécuter le programme d’installation de Windows en arrière-plan sans aucune interface utilisateur :

setup /auto upgrade /quiet /compat scanonly


Pour ignorer les exclusions de responsabilité courantes dans l’interface utilisateur, par exemple, les modifications linguistiques :

setup /auto upgrade /quiet /compat scanonly /compat ignorewarning


Souvent, un professionnel de l’informatique examinera le code XML compat si le programme d’installation de Windows détecte des problèmes de compatibilité. Utilisez /CopyLogs pour collecter les journaux d’installation de Windows :

setup /auto upgrade /quiet /compat scanonly /compat ignorewarning /copylogs C:\Temp\Logfiles.log


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui, uniquement avec /Compat IgnoreWarning


Remarques
Cette option est disponible à partir de Windows 10 et les versions ultérieures.

Si vous lancez le programme d’installation de Windows avec /Compat ScanOnly :

  • Si aucun problème de compatibilité n’est détecté, il retourne MOSETUP_E_COMPAT_SCANONLY (0xC1900210)
  • Si des problèmes de compatibilité actionnables sont détectés, comme des applications, il retourne MOSETUP_E_COMPAT_INSTALLREQ_BLOCK (0xC1900208)
  • S’il constate que l’option Mig-Choice sélectionnée n’est pas disponible, il retourne MOSETUP_E_COMPAT_MIGCHOICE_BLOCK (0xC1900204)
  • S’il trouve que l’ordinateur n’est pas éligible pour Windows 10 ou une version ultérieure, il retourne MOSETUP_E_COMPAT_SYSREQ_BLOCK (0xC1900200)
  • S’il trouve que la machine n’a pas suffisamment d’espace libre pour l’installer, il retourne MOSETUP_E_INSTALLDISKSPACE_BLOCK (0xC190020E)


/CopyLogs

Le programme d’installation de Windows copiera ou chargera les journaux compressés en cas de défaillance à l’emplacement spécifié, en supposant que l’ordinateur ou l’utilisateur disposent d’autorisations et d’un accès réseau à l’emplacement.

Syntaxe
/CopyLogs <location>


Paramètres

Paramètre Description
<location>Chemin d’accès au fichier local ou chemins d’accès réseau UNC.


Exemples

setup /copylogs \\server\share\


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Les paramètres acceptés sont les chemins d’accès aux fichiers locaux et les chemins d’accès réseau UNC. L’exécution s’exécute dans le contexte système, de sorte qu’elle n’a peut-être pas les autorisations nécessaires pour copier vers des emplacements nécessitant des autorisations utilisateur.


Debug/

Active le débogage du noyau sur un port COM (Communications) lorsque Windows est en cours d’exécution et pendant la passe de configuration WindowsPE du programme d’installation de Windows.

Syntaxe
/Debug:<port> [BaudRate:<baudrate>]


Paramètres

Paramètre Description
<port>Spécifie le port de débogage. La valeur par défaut est 1.
<baudrate>Spécifie la vitesse (en bauds) à utiliser lorsque Windows transfère des données pendant le débogage. Le paramètre par défaut est 19 200, mais il peut également être défini sur 57 600 ou 115 200.


Exemples

setup /debug:1 /baudrate:115200


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon

/DiagnosticPrompt

Spécifie que l’invite de commandes est disponible pendant le programme d’installation de Windows.

Syntaxe
/DiagnosticPrompt {Enable | Disable}


Paramètres

Paramètre Description
ActiverL’invite de commandes est accessible en appuyant sur Maj+F10 pendant l’installation de Windows.
DésactiverL’invite de commandes n’est pas disponible pendant l’installation de Windows. L’invite de commandes ne sera pas disponible hors connexion ni pendant l’exécution des phases OOBE. Il s’agit du paramètre par défaut.


Exemples

setup /diagnosticprompt enable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10 version 1703.


/DynamicUpdate

Spécifie si le programme d’installation de Windows devra effectuer des opérations de mise à jour dynamique (recherche, téléchargement et installation des mises à jour).

Syntaxe
/DynamicUpdate {Enable | Disable | NoDrivers | NoLCU | NoDriversNoLCU}


Paramètres

Paramètre Description
ActiverLes opérations de mise à jour dynamique sont effectuées.
DésactiverLes opérations de mise à jour dynamique ne sont pas effectuées.
NoDriversLes opérations de mise à jour dynamique sont effectuées à l’exception de l’acquisition du pilote.
NoDriversNoLCULes opérations de mise à jour dynamique sont effectuées à l’exception de l’acquisition du pilote et des mises à jour cumulatives les plus récentes.
NoLCULes opérations de mise à jour dynamique sont effectuées à l’exception de l’acquisition des mises à jour cumulatives les plus récentes.


Exemples

setup /auto upgrade /dynamicupdate disable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui pour les mises à jour de fonctionnalités basées sur Microsoft Update (MU) ; Oui pour les mises à jour de fonctionnalités basées sur la plateforme mise à jour unifiée (UUP) uniquement lorsque /DynamicUpdate NoDrivers est spécifié


Remarques
NoDrivers, NoLCU et NoDriversNoLCU sont nouveaux pour Windows 10, version 2004. Lorsque NoDrivers, NoLCU ou NoDriversNoLCU sont spécifiés, les opérations de mise à jour dynamique sont effectuées, mais l’acquisition des pilotes et/ou de la mise à jour cumulative la plus récente ne seront pas effectuées. /DynamicUpdate peut être utilisé avec /SkipFinalize pour contrôler les opérations de mise à jour dynamique ; /DynamicUpdate est ignoré lorsqu’il est utilisé avec /Finalize.


/EMSPort

Active ou désactive les services de gestion des urgences (Emergency Management Services/EMS) pendant le programme d’installation de Windows et une fois le système d’exploitation du serveur installé.

Syntaxe
/EMSPort: {COM1 | COM2 | UseBIOSSettings | Off} [/EMSBaudRate:<baudrate>]


Paramètres

Paramètre Description
COM1Active EMS sur COM1. Pris en charge uniquement pour les systèmes x86.
COM2Active EMS sur COM2. Pris en charge uniquement pour les systèmes x86.
UseBIOSSettingsUtilise le paramètre spécifié par le BIOS. Pour les systèmes x86, Windows utilise la valeur de la table SPCR (Serial Port Console Redirection). Si aucun chemin d’accès de table SPCR ou d’appareil de console EFI n’est spécifié dans le BIOS, Windows désactive EMS.
DésactivéDésactive EMS. Si EMS est désactivé dans le programme d’installation de Windows, vous pouvez l’activer ultérieurement en modifiant les paramètres de démarrage.
<baudrate>Spécifie la vitesse (en bauds) à utiliser lorsque Windows transfère des données pendant le débogage. La valeur par défaut est 19 200, mais elle peut également être définie sur 57 600 ou 115 200.


Exemples

setup /emsport:COM1 /emsbaudrate:115200


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


/EULA

Instructions du programme d’installation de Windows pour supprimer l’expérience utilisateur du contrat de licence utilisateur final du programme d’installation de Windows.installation de Windows.

Syntaxe
/EULA accept


Exemples

setup /auto upgrade /quiet /eula accept


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est nouvelle à partir de Windows 11. Spécifier /EULA accept indique au programme d’installation de Windows que le contrat de licence utilisateur final a été accepté. À compter de Windows 11, l’acceptation du EULA Windows est requise avant que l’installation du programme d’installation de Windows ne commence. En spécifiant /EULA accept, vous acceptez que lorsque vous appliquez ce système d’exploitation soit (1) la licence Windows applicable a été achetée par le biais d’une licence en volume, soit (2) que vous acceptez les termes du contrat de licence logiciel Microsoft approprié. Le programme d’installation de Windows retourne une erreur MOSETUP_E_EULA_ACCEPT_REQUIRED (0xC190010E) si /EULA accept n’est pas spécifié et (1) /Quiet est spécifié, ou (2) si le programme d’installation de Windows est démarré lorsque l’interaction utilisateur n’est pas prise en charge. Pour en savoir plus sur les licences, consultez les Termes du contrat de licence Microsoft.


/Finalize

Instructions du programme d’installation de Windows pour terminer les opérations de mise à jour démarrées précédemment sur le système d’exploitation de bas niveau, suivies d’un redémarrage immédiat pour démarrer la phase hors connexion.

Syntaxe
/Finalize


Exemples

setup /auto upgrade /finalize


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option est nouvelle pour Windows 10 version 2004. /Finalize ne doit pas être spécifié avec l’option /NoReboot. Le programme d’installation de Windows retourne une erreur MOSETUP_E_FINALIZE_RESUME_FAILURE (0xC1900132) si /Finalize est appelé et que l’appareil n’est pas dans l’état approprié pour reprendre après l’exécution de /SkipFinalize. Voir /SkipFinalize.


/ImageIndex

Instructions du programme d’installation de Windows sur l’image du système d’exploitation à installer à partir de install.wim, si plusieurs images peuvent être applicables.

Syntaxe
/ImageIndex <index>


Exemples

setup.exe /auto upgrade /quiet /compat ignorewarning /imageindex 2 /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui pour les mises à jour de fonctionnalités basées sur Microsoft Update (MU) ; Non pour les mises à jour des fonctionnalités basées sur la plateforme mise à jour unifiée (UUP)


Remarques
Si plusieurs images sont applicables, le programme d’installation de Windows invite l’utilisateur à en sélectionner une. Si plusieurs images sont applicables et que le programme d’installation de Windows est appelé avec /Quiet, le programme d’installation de Windows échoue avec l’erreur MOSETUP_E_NO_MATCHING_INSTALL_IMAGE (0xC1900215). Cela peut se produire lorsque la clé de produit spécifiée à l’aide de /PKey s’applique à plusieurs images du système d’exploitation.


/InstallDrivers

Ajoute des pilotes de style .inf à la nouvelle installation de Windows 10.

Syntaxe
/InstallDrivers <location>


Paramètres

Paramètre Description
<location>Chemin d’accès de fichier local ou chemin d’accès réseau UNC à un dossier qui contient des fichiers .inf.


Exemples

setup.exe /auto upgrade /installdrivers C:\Fabrikam\drivers /noreboot


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est nouvelle à partir de Windows 10. Le pilote .inf peut se trouver dans un dossier à l’emplacement spécifié. La commande sera récursive via l’emplacement spécifié.


/InstallFrom

Spécifie un autre fichier Install.wim à utiliser pendant le programme d’installation de Windows.

Syntaxe
/InstallFrom<path>


Paramètres

Paramètre Description
<path>Chemin d’accès du fichier .wim à installer.


Exemples

setup /installfrom D:\custom.wim

Cette option est également utilisée avec des fichiers image fractionnés (.swm). Sélectionner le premier fichier image fractionné dans la série

setup /installfrom D:\install.swm


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cela vous permet d’utiliser un seul environnement de préinstallation pour installer plusieurs versions d’images Windows. Par exemple, vous pouvez utiliser une version 32 bits du programme d’installation de Windows pour déployer une image Windows 64 bits. Vous pouvez également utiliser un fichier de réponses pour les déploiements multiplateformes. Pour plus d’informations, consultez « Création d’un WIM pour plusieurs types d’architecture » dans Plateformes prises en charge par le programme d’installation de Windows et déploiements multiplateformes


/InstallLangPacks

Ajoute des modules linguistiques (lp.cab) à la nouvelle installation de Windows 10 ou version ultérieure.

Syntaxe
/InstallLangPacks <location>


Paramètres

Paramètre Description
<location>Chemin d’accès de fichier local ou chemin d’accès réseau UNC à un dossier qui contient des fichiers .inf.


Exemples

setup /auto upgrade /installlangpacks C:\Fabrikam\Languages\French /noreboot


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui pour les mises à jour de fonctionnalités basées sur Microsoft Update (MU) ; Non pour les mises à jour des fonctionnalités basées sur la plateforme mise à jour unifiée (UUP)


Remarques
Cette option est nouvelle à partir de Windows 10. Les modules linguistiques peuvent se trouver dans un dossier à l’<emplacement>spécifié. La commande installe tous les fichiers lp.cab et toutes les fonctionnalités de langage, comme la reconnaissance vocale, dans le dossier et les sous-dossiers à l’<emplacement> spécifié. Les fonctionnalités de langage peuvent dépendre d’autres fonctionnalités de langage. Par exemple, la conversion de texte par synthèse vocale dépend du composant de base du même langage. Les fonctionnalités de langage ne doivent pas être renommées dans l’<emplacement>. Consultez Fonctionnalités de langage et de région à la demande (Features on Demand/FOD). Dans Windows 10, version 1903 et ultérieures, les échecs d’installation entraîneront l’échec et la restauration du programme d’installation de Windows.


/m

Indique au programme d’installation de Windows de copier d’autres fichiers à partir d’un autre emplacement. Cette option indique au programme d’installation de Windows d’examiner d’abord l’emplacement secondaire et, si des fichiers sont présents, de les utiliser au lieu des fichiers de l’emplacement par défaut.

Syntaxe
/m:<folder_name>


Paramètres

Paramètre Description
<folder_name>Nom et emplacement du dossier qui contient les fichiers de remplacement et qui peut être n’importe quel emplacement de lecteur local. Les chemins d'accès UNC ne sont pas pris en charge.


Exemples
Pour copier un fichier C:\Program Files\Messenger\Msmsgs.exe mis à jour dans l’installation de Windows, créez la structure de dossiers suivante sur la source d’installation Pro\Sources$OEM$$Progs\Messenger\Msmsgs.exe à l’aide de la commande d’installation :

Pro\sources\setup.exe /m


Si vous remplacez un fichier protégé par la protection des fichiers Windows, vous devez également copier le fichier mis à jour vers les sources locales à installer avec Windows. Par exemple, vous pouvez copier le fichier dans le dossier C:\Windows\i386. Le nom de fichier doit être identique au nom utilisé dans le programme d’installation de Windows. Par exemple, ajoutez la structure de fichiers et de dossiers suivante à votre répertoire $OEM$ : Pro\sources$OEM$$$\i386\msmsgs.ex_. Si vous utilisez des fichiers qui ne se trouvent pas sur un partage d’installation, vous devez spécifier le nom du dossier. Dans cet exemple, le <folder_name> est C:\additional_files, où C:\additional_files est votre répertoire $OEM$ personnalisé. Par exemple : C:\additional_files$$\i386\msmsgs.ex_.

setup /m:C:\additional_files

Si vous modifiez les ressources dans vos fichiers de remplacement, vous devez ajouter les fichiers d’interface utilisateur multi-langage (Multilanguage User Interface/MUI) mis à jour à l’installation.


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Vous devez savoir où les fichiers seront installés sur l’installation de Windows. Tous les fichiers supplémentaires doivent être copiés dans un dossier $OEM$ dans vos sources d’installation ou dans le <folder_name>. La structure $OEM$ fournit une représentation du disque d’installation de destination :

  • $OEM$\$1 correspond à %SYSTEMDRIVE%, qui peut être le lecteur C.
  • $OEM$\$$ correspond à %WINDIR%, qui peut être C:\windows.
  • $OEM$\$progs correspond au répertoire des fichiers programme.
  • $OEM$\$docs correspond au dossier Mes documents de l’utilisateur.


/MigNEO

Indique au programme d’installation de Windows d’effectuer une mise à niveau de Windows sans optimisations de phase hors connexion supplémentaires.

Syntaxe
/MigNEO Disable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui uniquement avec /Auto Upgrade | DataOnly
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui uniquement avec /Auto Upgrade | DataOnly


Remarques
NEO signifie objectif non événement (Non-event Objective), un effort multiversion pour réduire le temps hors connexion de la mise à jour des fonctionnalités, y compris un redémarrage unique pour la plupart des utilisateurs. Cette option est disponible à partir de Windows 10, version 1803 et versions ultérieures.


/MigrateDrivers

Indique au programme d’installation de Windows s’il faut migrer les pilotes depuis l’installation existante pendant la mise à niveau.

Syntaxe
/MigrateDrivers {All | None}


Exemples

setup /auto upgrade /migratedrivers all
setup /auto upgrade /migratedrivers none /installdrivers N:\NewDrivers


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Vous pouvez spécifier All ou None. Par défaut, le programme d’installation de Windows détermine quel est le meilleur pour chaque pilote individuel en fonction du choix d’installation. Vous pouvez utiliser ce commutateur avec /InstallDrivers, bien que cela ne soit pas obligatoire.


/NetDebug

Active le débogage du noyau sur le réseau.

Syntaxe
/NetDebug:hostip=<w.x.y.z>,port=<n>,key=<q.r.s.t>[,nodhcp][,busparams=<n.o.p>]


Paramètres

Paramètre Description
<w.x.y.z>Adresse IP de l’ordinateur hôte.
<n>Port de l’ordinateur hôte.
<q.r.s.t>Mot de passe pour configurer une connexion sécurisée.
<n.o.p>Numéro de bus, numéro d’appareil et numéro de fonction d’un adaptateur pour un périphérique de bus PCI spécifique.


Exemples

setup /netdebug:hostip=10.125.4.86,port=50000,key=0.0.0.0
setup /netdebug:hostip=10.125.4.86,port=50000,key=abcdefg.123.hijklmnop.456,nodhcp
setup /netdebug:hostip=10.1.4.8,port=50000,key=dont.use.previous.keys,busparams=1.5.0


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Utilisez hostip pour identifier l’adresse IP de l’ordinateur hôte. Utilisez port pour identifier le port. Le port de début par défaut est 49152 et le port de fin par défaut est 65535. Utilisez key pour fournir un mot de passe afin de configurer une connexion sécurisée. Utilisez nodhcp pour éviter d’utiliser une connexion DHCP. (facultatif). Utilisez busparams pour sélectionner le numéro de bus, le numéro d’appareil et le numéro de fonction d’un adaptateur pour un périphérique de bus PCI spécifique. (facultatif). Pour plus d’informations, consultez Configurer manuellement le débogage en mode noyau sur un câble réseau.


/NoReboot

Indique au programme d’installation de Windows de ne pas redémarrer l’ordinateur une fois la phase de bas niveau du programme d’installation de Windows terminée.

Syntaxe
/NoReboot


Exemples

setup /noreboot


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option est nouvelle pour Windows 10. L’option /NoReboot vous permet d’exécuter des commandes supplémentaires avant le redémarrage de Windows. Cette option supprime uniquement le premier redémarrage. L’option ne supprime pas les redémarrages suivants.


/PKey

Fournit le programme d’installation de Windows avec la clé de produit spécifique.

Syntaxe
/PKey <product key>


Exemples

setup.exe /auto upgrade /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est nouvelle à partir de Windows 10.


/Priority

Indique au programme d’installation de Windows d’augmenter la priorité de thread de basse à normale pour les mises à jour des fonctionnalités via Windows Update.

Syntaxe
/Priority {Normal | Low}


Paramètres

Paramètre Description
NormalLe programme d’installation de Windows s’exécutera avec une priorité de thread normale.
 FaibleLe programme d’installation de Windows s’exécute avec une priorité de thread basse.


Exemples

setup.exe /auto upgrade /skipfinalize /priority low


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10, version 1709 et ultérieures. La priorité Low est nouvelle pour Windows 10, version 2004. Les installations basées sur des supports s’exécutent déjà en priorité Normal par défaut, mais peuvent être réduites à une priorité Low.


/PostOOBE

Une fois le programme d’installation de Windows terminé, exécutez un script.

Syntaxe
/PostOOBE<location> [\setupcomplete.cmd]


Paramètres

Paramètre Description
<location>Chemin d’accès de fichier local ou chemin d’accès réseau UNC vers un fichier nommé setupcomplete.cmd ou vers un dossier qui contient setupcomplete.cmd.


Exemples

setup.exe /auto upgrade /postoobe C:\Fabrikam\setupcomplete.cmd


Chemin d’accès au dossier qui contient un script portant le nom setupcomplete.cmd. setupcomplete.cmd est copié dans $Windows.~BT, pour être exécuté après OOBE.

setup.exe /auto upgrade /postoobe C:\Fabrikam


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10.


/PostRollback

Indique au programme d’installation de Windows d’exécuter un script si la mise à jour des fonctionnalités ne parvient pas à s’installer et restaure les modifications, ou si l’utilisateur choisit de désinstaller la mise à jour des fonctionnalités et de revenir à une version précédente de Windows.

Syntaxe
/PostRollback <location> [/PostRollbackContext {system | user}]


Paramètres

Paramètre Description
<location>Chemin d’accès de fichier local ou chemin d’accès réseau UNC à un fichier nommé setuprollback.cmd ou à un dossier qui contient setuprollback.cmd.


Exemples

setup.exe /auto upgrade /postrollback C:\Fabrikam\setuprollback.cmd
setup.exe /postrollback C:\Fabrikam\setuprollback.cmd /postrollbackcontext user
setup.exe /auto upgrade /postrollback \server\share


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10. L’option/PostRollbackContext est disponible dans Windows 10, version 1803 et ultérieures. L’option /PostRollbackContext vous permet de spécifier si le script s’exécute dans le contexte du compte système ou du compte de l’utilisateur connecté. Par défaut, les mises à jour depuis les supports exécutent setuprollback.cmd dans le contexte User, ce qui nécessite que le premier utilisateur qui se connecte après la mise à niveau dispose de droits d’administrateur. Pour les mises à jour depuis Windows Update, setuprollback.cmd s’exécute dans le contexte System, quel que soient les droits du premier utilisateur connecté. Le programme d’installation de Windows copiera setuprollback.cmd vers $Windows.~BT, pour être exécuté après OOBE.


/Quiet

Cette instruction supprimera toute expérience utilisateur du programme d’installation de Windows, y compris l’expérience utilisateur de restauration.

Syntaxe
/Quiet


Exemples

setup /auto upgrade /quiet


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option est disponible à partir de Windows 10.


/ReflectDrivers

Spécifie le chemin d’accès à un dossier qui contient des pilotes de chiffrement pour un ordinateur sur lequel le chiffrement tiers est activé.

Syntaxe
/ReflectDrivers <location>


Paramètres

Paramètre Description
<location>Chemin d’accès de fichier local ou chemin d’accès réseau UNC à un dossier qui contient des fichiers .inf.


Exemples

setup /auto upgrade /quiet /reflectdrivers C:\Fabrikam\drivers


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10, version 1607. Assurez-vous que <location> contient uniquement un ensemble minimal de pilotes de chiffrement. Avoir plus de pilotes que nécessaire peut avoir un impact négatif sur les scénarios de mise à niveau.


/ResizeRecoveryPartition

Spécifie s’il est OK de redimensionner la partition Windows Recovery Environment (Windows RE) existante ou d’en créer une nouvelle lors de l’installation.

Syntaxe
/ResizeRecoveryPartition {Enable | Disable}


Paramètres

>
Paramètre Description
ActiverPendant l’installation, Windows peut redimensionner la partition d’outils Windows RE existante ou en créer une nouvelle si nécessaire.
DésactiverWindows ne redimensionne pas la partition existante des outils Windows RE ni n’en crée une nouvelle lors de l’installation.


Exemples

setup /resizerecoverypartition disable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Pour en savoir plus sur les partitions Windows RE, consultez Partitions de disque dur basées sur UEFI/GPT et Partitions de disque dur basées sur BIOS/MBR.


/ShowOOBE

Spécifie si l’utilisateur est tenu de terminer de manière interactive l’expérience OOBE (Out Of Box Experience).

Syntaxe
/ShowOOBE {Full | None}


Paramètres

Paramètre Description
ComplèteExige que l’utilisateur termine de manière interactive l’expérience OOBE (Out Of Box Experience).
AucunIgnore OOBE et sélectionne les paramètres par défaut.


Exemples

setup.exe /auto upgrade /showoobe full


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10.


/SkipFinalize

Configuration des instructions de démarrage des opérations de mise à jour sur le système d’exploitation de bas niveau, sans lancer de redémarrage pour démarrer la phase hors connexion.

Syntaxe
/SkipFinalize


Exemples

setup /auto upgrade /quiet /priority low /skipfinalize


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option est disponible à partir de Windows 10, version 2004. /SkipFinalize préparera la mise à jour sans validation. Cela permet de terminer la validation à l’aide de /Finalize, suivie d’un redémarrage immédiat de l’appareil. Il s’agit de l’approche recommandée pour attendre la mise à jour, car l’option /NoReboot valide les modifications, mais supprime le premier redémarrage pour autoriser des tâches supplémentaires. /SkipFinalize n’indique pas automatiquement au programme d’installation de Windows de s’exécuter en mode silencieux sur le système d’exploitation de bas niveau pendant l’utilisation de l’ordinateur. Utilisez /Quiet pour supprimer l’expérience utilisateur du programme d’installation de Windows et /Priority Low pour empêcher un impact de l’utilisateur. /SkipFinalize n’appelle pas de redémarrage et l’option /NoReboot n’est donc pas requise. Voir /Finalize.


/Telemetry

Spécifie si le programme d’installation de Windows doit capturer et signaler les données d’installation.

Syntaxe
/Telemetry {Enable | Disable}


Paramètres

Paramètre Description
ActiverLe programme d’installation de Windows capture et signale les données d’installation.
DésactiverLe programme d’installation de Windows ne capture pas et ne signale pas les données d’installation.


Exemples

setup /telemetry disable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


/TempDrive

Indique au programme d’installation de Windows de placer des fichiers d’installation temporaires sur la partition spécifiée.

Syntaxe
/TempDrive <drive_letter>


Paramètres

Paramètre Description
<drive_letter>Partition sur laquelle copier les fichiers d’installation pendant le programme d’installation de Windows.


Exemples

setup /tempdrive H


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10, version 1607. Pour une mise à niveau, l’option /TempDrive affecte uniquement le placement des fichiers temporaires. Le système d’exploitation est mis à niveau dans la partition à partir de laquelle vous exécutez le fichier setup.exe.


/Unattend

Vous permet d’utiliser un fichier de réponses avec le programme d’installation de Windows.

Syntaxe
/Unattend:<answer_file>


Paramètres

Paramètre Description
<answer_file>Chemin d’accès du fichier et nom de fichier du fichier de réponse du programme d’installation de Windows sans assistance.


Exemples

setup /unattend:\\server\share\unattend.xml


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Il s’agit d’une installation sans assistance. Vous devez spécifier une valeur pour <answer_file>. Le programme d’installation de Windows applique les valeurs dans le fichier de réponses pendant l’installation. Lorsque /Unattend est utilisé, /Auto ne peut pas être utilisé.


/Uninstall

Détermine si Windows devra inclure des contrôles qui permettent à l’utilisateur de revenir au système d’exploitation précédent.

Syntaxe
/Uninstall {Enable | Disable}


Paramètres

Paramètre Description
ActiverLe programme d’installation de Windows inclut des contrôles qui permettent à l’utilisateur de revenir au système d’exploitation précédent.
DésactiverLe programme d’installation de Windows n’inclut pas de contrôles qui permettent à l’utilisateur de revenir au système d’exploitation précédent.


Exemples

setup /uninstall disable


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPENon
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Oui
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésOui


Remarques
Cette option est disponible à partir de Windows 10.


/USBDebug

Configure le débogage sur un port USB.

Syntaxe
/USBDebug :<hostname>


Paramètres

Paramètre Description
<hostname>Nom de l’ordinateur à déboguer.


Exemples

setup /usbdebug:testmachine01


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Les données de débogage sont efficaces au redémarrage suivant.


/WDSDiscover

Spécifie que le client des Services de déploiement Windows (Windows Deployment Services/WDS) doit être en mode découverte.

Syntaxe
/WDSDiscover


Exemples
Pour démarrer le client WDS en mode de découverte dynamique, exécutez la commande suivante :

setup /wds /wdsdiscover


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option n’est plus disponible à partir de Windows 11, version 21H2. Si vous ne spécifiez pas /WDSServer, WDS recherche un serveur.


/WDSServer

Spécifie le nom du serveur des Services de déploiement Windows (WDS) auquel le client doit se connecter.

Syntaxe
/WDSServer:<servername>


Paramètres

Paramètre Description
<servername>Nom du serveur des Services de déploiement Windows.


Exemples
Pour démarrer le client des Services de déploiement Windows en mode de découverte statique, exécutez la commande suivante :

setup /wds /wdsdiscover /wdsserver:MyWDSServer


Applicabilité

Configuration Applicable
Setup.exe démarré à partir de WinPEOui
Setup.exe démarré à partir de Windows 10 ou d’une version ultérieure Non
Les fichiers setupconfig.ini utilisés pour les mises à jour des fonctionnalitésNon


Remarques
Cette option n’est plus disponible à partir de Windows 11, version 21H2. Pour utiliser ce paramètre, vous devez également utiliser l’option /WDSDiscover. <servername> peut être une adresse IP, un nom NetBIOS ou un nom de domaine complet (Fully Qualified Domain Name/FQDN).

Codes de sortie du programme d’installation de Windows

Nom du code de sortie Valeur du code de sortie Description
CONX_SETUP_EXITCODE_CONTINUE_REBOOT0x3Cette mise à niveau a réussi.
CONX_SETUP_EXITCODE_RESUME_AT_COMPAT_REPORT0x5La vérification de compatibilité a détecté des problèmes qui nécessitent d’être résolus avant que la mise à niveau puisse continuer.
CONX_SETUP_EXITCODE_AUTO_INSTALL_FAIL0x7L’option d’installation (mise à niveau ou données uniquement) n’était pas disponible.


États du programme d’installation de Windows

Fichiers d’ID de produit et de configuration de l’édition d’installation de Windows (EI.cfg et PID.txt)

Fichiers journaux d’installation de Windows et journaux des événements