Utiliser les paramètres de ligne de commande pour installer Visual StudioUse command-line parameters to install Visual Studio

Lorsque vous installez Visual Studio à partir d’une invite de commandes, vous pouvez utiliser divers paramètres de ligne de commande pour contrôler ou personnaliser l’installation.When you install Visual Studio from a command prompt, you can use a variety of command-line parameters to control or customize the installation. À partir de la ligne de commande, vous pouvez effectuer les actions suivantes :From the command line, you can perform the following actions:

  • Démarrer l’installation avec certaines options présélectionnées.Start the install with certain options preselected.
  • Automatiser le processus d’installation.Automate the installation process.
  • Créer un cache (disposition) des fichiers d’installation pour une utilisation ultérieure.Create a cache (layout) of the installation files for later use.

Les options de ligne de commande sont utilisées en conjonction avec le bootstrapper d’installation, qui est le petit fichier (1 Mo) qui initie le processus de téléchargement.The command-line options are used in conjunction with the setup bootstrapper, which is the small (1 MB) file that initiates the download process. Le programme d’amorçage est le premier exécutable qui est lancé quand vous effectuez un téléchargement à partir du site Visual Studio.The bootstrapper is the first executable that is launched when you download from the Visual Studio site.

Pour obtenir un bootstrapper pour Visual Studio 2017, consultez la page de téléchargement des versions précédentes de Visual Studio pour plus de détails sur la façon de le faire.To get a bootstrapper for Visual Studio 2017, see the Visual Studio previous versions download page for details on how to do so.

Utilisez les liens suivants pour obtenir un lien direct vers le programme d’amorçage de la version la plus récente de l’édition du produit que vous installez :Use the following links to get a direct link to the latest release bootstrapper for the product edition that you're installing:

Votre fichier bootstrapper doit correspondre ou être similaire à l’un des noms de fichiers suivants :Your bootstrapper file should match or be similar to one of the following file names:

  • vs_enterprise.exevs_enterprise.exe
  • vs_professional.exevs_professional.exe
  • vs_community.exevs_community.exe

Conseil

Si vous avez déjà téléchargé un fichier bootstrapper et que vous souhaitez vérifier sa version, voici comment.If you previously downloaded a bootstrapper file and want to verify its version, here's how. Dans Windows, ouvrez File Explorer, cliquez à droite sur le fichier bootstrapper, choisissez les propriétés, choisissez l’onglet Détails, puis consultez le numéro de version produit.In Windows, open File Explorer, right-click the bootstrapper file, choose Properties, choose the Details tab, and then view the Product version number. Pour correspondre à ce nombre à une sortie de Visual Studio, voir le Visual Studio construire des numéros et la page de dates de sortie.To match that number to a release of Visual Studio, see the Visual Studio build numbers and release dates page.

Paramètres de ligne de commandeCommand-line parameters

Les paramètres de ligne de commande Visual Studio ne respectent pas la casse.Visual Studio command-line parameters are case-insensitive.

Syntaxe : vs_enterprise.exe [command] <options>...Syntax: vs_enterprise.exe [command] <options>...

Remplacez le vs_enterprise.exe cas échéant pour l’édition produit que vous installez.Replace vs_enterprise.exe as appropriate for the product edition you're installing. (Alternativement, vous vs_installer.exepouvez utiliser .)(Alternatively, you can use vs_installer.exe.)

Conseil

Pour obtenir des exemples supplémentaires sur l’utilisation de la ligne de commande afin d’installer Visual Studio, consultez la page Exemples de paramètres de ligne de commande.For more examples of how to use the command line to install Visual Studio, see the Command-line parameter examples page.

CommandeCommand DescriptionDescription
(vide)(blank) Installe le produit.Installs the product.
modify Modifie un produit installé.Modifies an installed product.
update Met à jour un produit installé.Updates an installed product.
repair Répare un produit installé.Repairs an installed product.
uninstall Désinstalle un produit installé.Uninstalls an installed product.
export Nouveau dans la version 15.9: Sélection d’installation d’exportations vers un fichier de configuration d’installation.New in version 15.9: Exports installation selection to an installation configuration file. Remarque: Ne peut être utilisé qu’avec vs_installer.exe.Note: Can only be used with vs_installer.exe.
CommandeCommand DescriptionDescription
(vide)(blank) Installe le produit.Installs the product.
modify Modifie un produit installé.Modifies an installed product.
update Met à jour un produit installé.Updates an installed product.
repair Répare un produit installé.Repairs an installed product.
uninstall Désinstalle un produit installé.Uninstalls an installed product.
export Exporte la sélection de l’installation dans un fichier de configuration d’installation.Exports installation selection to an installation configuration file. Remarque: Ne peut être utilisé qu’avec vs_installer.exe.Note: Can only be used with vs_installer.exe.

Options d’installationInstall options

Option d’installationInstall option DescriptionDescription
--installPath <dir> Répertoire d’installation de l’instance à installer.The installation directory for the instance to act upon. Pour la commande d’installation, cette option est facultative et il s’agit de l’emplacement où l’instance doit être installée.For the install command, this is Optional and is where the instance will be installed. Pour les autres commandes, cette option est requise et il s’agit de l’emplacement où l’instance précédente a été installée.For other commands, this is Required and is where the previously installed instance was installed.
--addProductLang <language-locale> Facultatif : lors d’une installation ou d’une modification, cette option détermine les modules linguistiques de l’interface utilisateur qui sont installés sur le produit.Optional: During an install or modify operation, this determines the UI language packs that are installed to the product. Elle peut apparaître plusieurs fois sur la ligne de commande pour ajouter plusieurs modules linguistiques.It can appear multiple times on the command line to add multiple language packs. Si elle est absente, l’installation utilise les paramètres régionaux de l’ordinateur.If not present, the installation uses the machine locale. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--removeProductLang <language-locale> Facultatif : lors d’une installation ou d’une modification, cette option détermine les modules linguistiques de l’interface utilisateur qui doivent être supprimés du produit.Optional: During an install or modify operation, this determines the UI language packs that are to be removed from the product. Elle peut apparaître plusieurs fois sur la ligne de commande pour ajouter plusieurs modules linguistiques.It can appear multiple times on the command line to add multiple language packs. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--add <one or more workload or component IDs> Facultatif : un ou plusieurs ID de charge de travail ou composant à ajouter.Optional: One or more workload or component IDs to add. Les composants obligatoires de l’artefact sont installés, mais pas les composants recommandés ni facultatifs.The required components of the artifact are installed, but not the recommended or optional components. Vous pouvez contrôler globalement les autres composants à l’aide des options --includeRecommended et/ou --includeOptional.You can control additional components globally using --includeRecommended and/or --includeOptional. Pour inclure plusieurs charges de travail ou composants, répétez la commande --add (par exemple, --add Workload1 --add Workload2).To include multiple workloads or components, repeat the --add command (for example, --add Workload1 --add Workload2). Pour un contrôle plus précis, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeRecommended;includeOptional).For finer-grained control, you can append ;includeRecommended or ;includeOptional to the ID (for example, --add Workload1;includeRecommended or --add Workload2;includeRecommended;includeOptional). Pour plus d’informations, consultez la page ID de charge de travail et de composant.For more information, see the Workload and component IDs page. Vous pouvez répéter cette option si nécessaire.You can repeat this option as necessary.
--remove <one or more workload or component IDs> Optionnel: Une ou plusieurs charges de travail ou composants à supprimer.Optional: One or more workload or component IDs to remove. Pour plus d’informations, consultez notre page ID de charge de travail et de composant.For more information, see our Workload and component IDs page. Vous pouvez répéter cette option si nécessaire.You can repeat this option as necessary.
--in <path> Facultatif: L’URI ou le chemin vers un fichier de réponse.Optional: The URI or path to a response file.
--all Facultatif : indique s’il faut installer tous les composants et charges de travail d’un produit.Optional: Whether to install all workloads and components for a product.
--allWorkloads Facultatif : installe toutes les charges de travail et tous les composants, mais n’installe pas les composants recommandés ou facultatifs.Optional: Installs all workloads and components, no recommended or optional components.
--includeRecommended Optionnel: Inclut les composants recommandés pour toute charge de travail qui est installée, mais pas les composants optionnels.Optional: Includes the recommended components for any workloads that are installed, but not the optional components. Les charges de travail sont spécifiées avec --allWorkloads ou --add.The workloads are specified either with --allWorkloads or --add.
--includeOptional Optionnel: Inclut les composants optionnels pour toute charge de travail qui est installée, mais pas les composants recommandés.Optional: Includes the optional components for any workloads that are installed, but not the recommended components. Les charges de travail sont spécifiées avec --allWorkloads ou --add.The workloads are specified either with --allWorkloads or --add.
--quiet, -q Optionnel: N’affichez aucune interface utilisateur lors de l’exécution de l’installation.Optional: Don't display any user interface while performing the installation.
--passive, -p Optionnel: Affichez l’interface utilisateur, mais ne demandez aucune interaction de l’utilisateur.Optional: Display the user interface, but don't request any interaction from the user.
--norestart Facultatif: Si --passive vous --quiet êtes présent, les commandes avec ou ne redémarreront pas automatiquement la machine (si nécessaire).Optional: If present, commands with --passive or --quiet won't automatically restart the machine (if necessary). Option ignorée si ni --passive ni --quiet ne sont spécifiés.This is ignored if neither --passive nor --quiet are specified.
--nickname <name> Optionnel: Cela définit le surnom à attribuer à un produit installé.Optional: This defines the nickname to assign to an installed product. Le surnom ne peut pas être plus de 10 caractères.The nickname can't be longer than 10 characters.
--productKey Facultatif: Cela définit la clé du produit à utiliser pour un produit installé.Optional: This defines the product key to use for an installed product. Il est composé de 25 caractères alphanumériques soit dans le format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx ou xxxxxxxxxxxxxxxxxxxxxxxxx.It's composed of 25 alphanumeric characters either in the format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx or xxxxxxxxxxxxxxxxxxxxxxxxx.
--help, --?, -h, -? Permet d’afficher une version hors connexion de cette page.Display an offline version of this page.
--config <path> Facultatif et nouveauté de la version 15.9 : pendant une opération d’installation ou de modification, cette option détermine les charges de travail et composants à ajouter en fonction d’un fichier de configuration d’installation déjà enregistré.Optional and New in 15.9: During an install or modify operation, this determines the workloads and components to add based on a previously saved installation configuration file. Cette opération est additive et elle n’enlèvera aucune charge de travail ou composant si elle n’est pas présente dans le fichier.This operation is additive and it won't remove any workload or component if they aren't present in the file. En outre, les articles qui ne s’appliquent pas au produit ne seront pas ajoutés.Also, items that don't apply to the product won't be added. Pendant une opération d’exportation, cette option détermine l’emplacement auquel enregistrer le fichier de configuration d’installation.During an export operation, this determines the location to save the installation configuration file.
Option d’installationInstall option DescriptionDescription
--installPath <dir> Répertoire d’installation de l’instance à installer.The installation directory for the instance to act upon. Pour la commande d’installation, cette option est facultative et il s’agit de l’emplacement où l’instance doit être installée.For the install command, this is Optional and is where the instance will be installed. Pour les autres commandes, cette option est requise et il s’agit de l’emplacement où l’instance précédente a été installée.For other commands, this is Required and is where the previously installed instance was installed.
--addProductLang <language-locale> Facultatif : lors d’une installation ou d’une modification, cette option détermine les modules linguistiques de l’interface utilisateur qui sont installés sur le produit.Optional: During an install or modify operation, this determines the UI language packs that are installed to the product. Elle peut apparaître plusieurs fois sur la ligne de commande pour ajouter plusieurs modules linguistiques.It can appear multiple times on the command line to add multiple language packs. Si elle est absente, l’installation utilise les paramètres régionaux de l’ordinateur.If not present, the installation uses the machine locale. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--removeProductLang <language-locale> Facultatif : lors d’une installation ou d’une modification, cette option détermine les modules linguistiques de l’interface utilisateur qui doivent être supprimés du produit.Optional: During an install or modify operation, this determines the UI language packs that are to be removed from the product. Elle peut apparaître plusieurs fois sur la ligne de commande pour ajouter plusieurs modules linguistiques.It can appear multiple times on the command line to add multiple language packs. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--add <one or more workload or component IDs> Facultatif : un ou plusieurs ID de charge de travail ou composant à ajouter.Optional: One or more workload or component IDs to add. Les composants obligatoires de l’artefact sont installés, mais pas les composants recommandés ni facultatifs.The required components of the artifact are installed, but not the recommended or optional components. Vous pouvez contrôler globalement les autres composants à l’aide des options --includeRecommended et/ou --includeOptional.You can control additional components globally using --includeRecommended and/or --includeOptional. Pour inclure plusieurs charges de travail ou composants, répétez la commande --add (par exemple, --add Workload1 --add Workload2).To include multiple workloads or components, repeat the --add command (for example, --add Workload1 --add Workload2). Pour un contrôle plus précis, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeRecommended;includeOptional).For finer-grained control, you can append ;includeRecommended or ;includeOptional to the ID (for example, --add Workload1;includeRecommended or --add Workload2;includeRecommended;includeOptional). Pour plus d’informations, consultez la page ID de charge de travail et de composant.For more information, see the Workload and component IDs page. Vous pouvez répéter cette option si nécessaire.You can repeat this option as necessary.
--remove <one or more workload or component IDs> Optionnel: Une ou plusieurs charges de travail ou composants à supprimer.Optional: One or more workload or component IDs to remove. Pour plus d’informations, consultez notre page ID de charge de travail et de composant.For more information, see our Workload and component IDs page. Vous pouvez répéter cette option si nécessaire.You can repeat this option as necessary.
--in <path> Facultatif: L’URI ou le chemin vers un fichier de réponse.Optional: The URI or path to a response file.
--all Facultatif : indique s’il faut installer tous les composants et charges de travail d’un produit.Optional: Whether to install all workloads and components for a product.
--allWorkloads Facultatif : installe toutes les charges de travail et tous les composants, mais n’installe pas les composants recommandés ou facultatifs.Optional: Installs all workloads and components, no recommended or optional components.
--includeRecommended Optionnel: Inclut les composants recommandés pour toute charge de travail qui est installée, mais pas les composants optionnels.Optional: Includes the recommended components for any workloads that are installed, but not the optional components. Les charges de travail sont spécifiées avec --allWorkloads ou --add.The workloads are specified either with --allWorkloads or --add.
--includeOptional Optionnel: Inclut les composants optionnels pour toute charge de travail qui est installée, mais pas les composants recommandés.Optional: Includes the optional components for any workloads that are installed, but not the recommended components. Les charges de travail sont spécifiées avec --allWorkloads ou --add.The workloads are specified either with --allWorkloads or --add.
--quiet, -q Optionnel: N’affichez aucune interface utilisateur lors de l’exécution de l’installation.Optional: Don't display any user interface while performing the installation.
--passive, -p Optionnel: Affichez l’interface utilisateur, mais ne demandez aucune interaction de l’utilisateur.Optional: Display the user interface, but don't request any interaction from the user.
--norestart Facultatif: Si --passive vous --quiet êtes présent, les commandes avec ou ne redémarreront pas automatiquement la machine (si nécessaire).Optional: If present, commands with --passive or --quiet won't automatically restart the machine (if necessary). Option ignorée si ni --passive ni --quiet ne sont spécifiés.This is ignored if neither --passive nor --quiet are specified.
--nickname <name> Optionnel: Cela définit le surnom à attribuer à un produit installé.Optional: This defines the nickname to assign to an installed product. Le surnom ne peut pas être plus de 10 caractères.The nickname can't be longer than 10 characters.
--productKey Facultatif: Cela définit la clé du produit à utiliser pour un produit installé.Optional: This defines the product key to use for an installed product. Il est composé de 25 caractères alphanumériques soit dans le format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx ou xxxxxxxxxxxxxxxxxxxxxxxxx.It's composed of 25 alphanumeric characters either in the format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx or xxxxxxxxxxxxxxxxxxxxxxxxx.
--help, --?, -h, -? Permet d’afficher une version hors connexion de cette page.Display an offline version of this page.
--config <path> Optionnel: Lors d’une opération d’installation ou de modification, cela détermine les charges de travail et les composants à ajouter en fonction d’un fichier de configuration d’installation précédemment enregistré.Optional: During an install or modify operation, this determines the workloads and components to add based on a previously saved installation configuration file. Cette opération est additive et elle n’enlèvera aucune charge de travail ou composant si elle n’est pas présente dans le fichier.This operation is additive and it won't remove any workload or component if they aren't present in the file. En outre, les articles qui ne s’appliquent pas au produit ne seront pas ajoutés.Also, items that don't apply to the product won't be added. Pendant une opération d’exportation, cette option détermine l’emplacement auquel enregistrer le fichier de configuration d’installation.During an export operation, this determines the location to save the installation configuration file.

Important

Lorsque vous spécifiez plusieurs charges de travail et plusieurs composants, vous devez répéter le commutateur de ligne de commande --add ou --remove pour chaque élément.When specifying multiple workloads and components, you must repeat the --add or --remove command-line switch for each item.

Options de dispositionLayout options

Options de mise en pageLayout options DescriptionDescription
--layout <dir> Spécifie un répertoire pour créer un cache d’installation hors connexion.Specifies a directory to create an offline install cache. Pour plus d’informations, consultez Créer une installation réseau de Visual Studio.For more information, see Create a network-based installation of Visual Studio.
--lang <one or more language-locales> Facultatif : utilisé avec --layout pour préparer un cache d’installation hors connexion avec des packages de ressources correspondant à la langue ou aux langues spécifiées.Optional: Used with --layout to prepare an offline install cache with resource packages with the specified language(s). Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--add <one or more workload or component IDs> Facultatif : un ou plusieurs ID de charge de travail ou composant à ajouter.Optional: One or more workload or component IDs to add. Les composants obligatoires de l’artefact sont installés, mais pas les composants recommandés ni facultatifs.The required components of the artifact are installed, but not the recommended or optional components. Vous pouvez contrôler globalement les autres composants à l’aide des options --includeRecommended et/ou --includeOptional.You can control additional components globally using --includeRecommended and/or --includeOptional. Pour un contrôle plus précis, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeOptional).For finer-grained control, you can append ;includeRecommended or ;includeOptional to the ID (for example, --add Workload1;includeRecommended or --add Workload2;includeOptional). Pour plus d’informations, consultez la page ID de charge de travail et de composant.For more information, see the Workload and component IDs page.
Remarque : Si --add est utilisé, seuls les composants et les charges de travail spécifiés ainsi que leurs dépendances sont téléchargés.Note: If --add is used, only the specified workloads and components and their dependencies are downloaded. Si --add elle n’est pas spécifiée, toutes les charges de travail et les composants sont téléchargés sur la mise en page.If --add isn't specified, all workloads and components are downloaded to the layout.
--includeRecommended Optionnel: Inclut les composants recommandés pour toute charge de travail qui est installée, mais pas les composants optionnels.Optional: Includes the recommended components for any workloads that are installed, but not the optional components. Les charges de travail sont spécifiées avec --allWorkloads ou --add.The workloads are specified either with --allWorkloads or --add.
--includeOptional Facultatif : inclut les composants recommandés et facultatifs pour toutes les charges de travail contenues dans la disposition.Optional: Includes the recommended and optional components for any workloads being included in the layout. Les charges de travail sont spécifiées avec --add.The workloads are specified with --add.
--keepLayoutVersion Nouveautés de la version 15.3, facultatif : application des modifications à la disposition sans mettre à jour la version de la disposition.New in 15.3, optional: Apply changes to the layout without updating the version of the layout.
--verify Nouveautés de la version 15.3, facultatif : vérification du contenu d’une disposition.New in 15.3, optional: Verify the contents of a layout. Tous les fichiers endommagés ou manquants sont listés.Any corrupt or missing files are listed.
--fix Nouveautés de la version 15.3, facultatif : vérification du contenu d’une disposition.New in 15.3, optional: Verify the contents of a layout. Si des fichiers sont corrompus ou manquants, ils sont rechargés.If any files are corrupt or missing, they're redownloaded. Un accès à Internet est obligatoire pour corriger une disposition.Internet access is required to fix a layout.
--clean <one or more paths to catalogs> Nouveautés de la version 15.3, facultatif : suppression des anciennes versions des composants d’une disposition qui a été mise à jour vers une version plus récente.New in 15.3, optional: Removes old versions of components from a layout that has been updated to a newer version.
Options d’installation avancéesAdvanced install options DescriptionDescription
--channelId <id> Facultatif : ID de canal pour l’instance à installer.Optional: The ID of the channel for the instance to be installed. Ceci est nécessaire pour la commande d’installation, et ignoré pour d’autres commandes si --installPath elle est spécifiée.This is required for the install command, and ignored for other commands if --installPath is specified.
--channelUri <uri> Optionnel: L’URI du manifeste de canal.Optional: The URI of the channel manifest. Si les mises à --channelUri jour ne sont pas souhaitées, peut indiquer un fichier inexistant (par exemple, --channelUri C: 'doesntExist.chman).If updates aren't wanted, --channelUri can point to a non-existent file (for example, --channelUri C:\doesntExist.chman). Cela peut être utilisé pour la commande d’installation; il est ignoré pour d’autres commandes.This can be used for the install command; it's ignored for other commands.
--installChannelUri <uri> Optionnel: L’URI du canal manifeste à utiliser pour l’installation.Optional: The URI of the channel manifest to use for the installation. L’URI spécifié par --channelUri (qui doit être spécifié en même temps que --installChannelUri) est utilisé pour détecter les mises à jour.The URI specified by --channelUri (which must be specified when --installChannelUri is specified) is used to detect updates. Cela peut être utilisé pour la commande d’installation; il est ignoré pour d’autres commandes.This can be used for the install command; it's ignored for other commands.
--installCatalogUri <uri> Optionnel: L’URI du catalogue manifeste à utiliser pour l’installation.Optional: The URI of the catalog manifest to use for the installation. Si spécifié, le gestionnaire de canal tente de télécharger le manifeste de catalogue à partir de cet URI avant d’utiliser l’URI du manifeste de canal d’installation.If specified, the channel manager attempts to download the catalog manifest from this URI before using the URI in the install channel manifest. Ce paramètre est utilisé pour prendre en charge l’installation hors connexion, où le cache de disposition est créé avec le catalogue de produits déjà téléchargé.This parameter is used to support offline install, where the layout cache will be created with the product catalog already downloaded. Cela peut être utilisé pour la commande d’installation; il est ignoré pour d’autres commandes.This can be used for the install command; it's ignored for other commands.
--productId <id> Facultatif : ID de produit pour l’instance à installer.Optional The ID of the product for the instance that will be installed. Ceci est pré-peuplé dans des conditions normales d’installation.This is pre-populated in normal installation conditions.
--wait Facultatif : le processus attend la fin de l’installation pour retourner un code de sortie.Optional: The process will wait until the install is completed before returning an exit code. Cela est utile lorsque vous automatisez des installations et que vous devez attendre la fin de l’installation pour gérer le code de retour de cette installation.This is useful when automating installations where one needs to wait for the install to finish to handle the return code from that install.
--locale <language-locale> Facultatif : permet de changer la langue d’affichage de l’interface utilisateur pour le programme d’installation proprement dit.Optional: Change the display language of the user interface for the installer itself. Ce paramètre est conservé.Setting will be persisted. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--cache Nouveauté de la version 15.2, facultatif : le cas échéant, les packages sont conservés après leur installation pour les réparations ultérieures.New in 15.2, optional: If present, packages will be kept after being installed for subsequent repairs. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, réparations ou modifications ultérieures.This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. La stratégie par défaut consiste à mettre les packages en cache.The default policy is to cache packages. Option ignorée pour la commande de désinstallation.This is ignored for the uninstall command. Pour plus d’informations, consultez Désactiver ou déplacer le cache du package.Read how to disable or move the package cache for more information.
--nocache Nouveautés de la version 15.2, facultatif : le cas échéant, les packages sont supprimés après avoir été installés ou réparés.New in 15.2, optional: If present, packages will be deleted after being installed or repaired. Ils ne seront téléchargés à nouveau que si nécessaire et supprimés à nouveau après utilisation.They'll be downloaded again only if needed and deleted again after use. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, réparations ou modifications ultérieures.This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. La stratégie par défaut consiste à mettre les packages en cache.The default policy is to cache packages. Option ignorée pour la commande de désinstallation.This is ignored for the uninstall command. Pour plus d’informations, consultez Désactiver ou déplacer le cache du package.Read how to disable or move the package cache for more information.
--noUpdateInstaller Nouveautés de la version 15.2, facultatif : Le cas échéant, empêche le programme d’installation de se mettre à jour quand le mode silencieux est spécifié.New in 15.2, optional: If present, prevents the installer from updating itself when quiet is specified. Le programme d’installation ne parvient pas à exécuter la commande et retourne un code de sortie différent de zéro si noUpdateInstaller est spécifié avec le mode silencieux quand une mise à jour du programme d’installation est obligatoire.The installer will fail the command and return a non-zero exit code if noUpdateInstaller is specified with quiet when an installer update is required.
--noWeb Nouveau en 15.3, facultatif: Si présent, visual Studio configure utilise les fichiers de votre répertoire de mise en page pour installer Visual Studio.New in 15.3, optional: If present, Visual Studio setup uses the files in your layout directory to install Visual Studio. Si un utilisateur tente d’installer des composants qui ne sont pas dans la mise en page, la configuration échoue.If a user tries to install components that aren't in the layout, setup fails. Pour plus d’informations, consultez Déploiement à partir d’une installation réseau.For more information, see Deploying from a network installation.

Important: Ce commutateur n’empêche pas la configuration Visual Studio de vérifier les mises à jour.Important: This switch doesn't stop Visual Studio setup from checking for updates. Pour plus d’informations, consultez Contrôler les mises à jour applicables aux déploiements de Visual Studio à partir du réseau.For more information, see Control updates to network-based Visual Studio deployments.
--path <name>=<path> Nouveautés de la version 15.7, facultatif : permet de spécifier des chemins d’installation personnalisés pour l’installation.New in 15.7, optional: Used to specify custom install paths for the installation. Les noms de chemin pris en charge sont shared, cache et install.Supported path names are shared, cache, and install.
--path cache=<path> Nouveautés de la version 15.7, facultatif : utilise l’emplacement que vous spécifiez pour télécharger les fichiers d’installation.New in 15.7, optional: Uses the location you specify to download installation files. Cet emplacement peut être défini uniquement pendant la première installation de Visual Studio.This location can only be set the first time that Visual Studio is installed. Exemple : --path cache="C:\VS\cache"Example: --path cache="C:\VS\cache"
--path shared=<path> Nouveautés de la version 15.7, facultatif : contient des fichiers partagés pour les installations de Visual Studio côte à côte.New in 15.7, optional: Contains shared files for side-by-side Visual Studio installations. Certains outils et kits SDK effectuent l’installation à un emplacement sur ce lecteur, tandis que d’autres peuvent l’effectuer sur un autre lecteur en passant outre ce paramétrage.Some tools and SDKs install to a location on this drive, while some others might override this setting and install to another drive. Exemple : --path shared="C:\VS\shared"Example: --path shared="C:\VS\shared"

Important : Ceci ne peut être défini qu’une seule fois, lors de la première installation de Visual Studio.Important: This can be set only once and on the first time that Visual Studio is installed.
--path install=<path> Nouveautés de la version 15.7, facultatif : équivaut à –-installPath.New in 15.7, optional: Equivalent to –-installPath. En particulier, les options --installPath "C:\VS" et --path install="C:\VS" sont équivalentes.Specifically, --installPath "C:\VS" and --path install="C:\VS" are equivalent. Une seule de ces commandes peut être utilisée à la fois.Only one of these commands can be used at a time.
Options de mise en pageLayout options DescriptionDescription
--layout <dir> Spécifie un répertoire pour créer un cache d’installation hors connexion.Specifies a directory to create an offline install cache. Pour plus d’informations, consultez Créer une installation réseau de Visual Studio.For more information, see Create a network-based installation of Visual Studio.
--lang <one or more language-locales> Facultatif : utilisé avec --layout pour préparer un cache d’installation hors connexion avec des packages de ressources correspondant à la langue ou aux langues spécifiées.Optional: Used with --layout to prepare an offline install cache with resource packages with the specified language(s). Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--add <one or more workload or component IDs> Facultatif : un ou plusieurs ID de charge de travail ou composant à ajouter.Optional: One or more workload or component IDs to add. Les composants obligatoires de l’artefact sont installés, mais pas les composants recommandés ni facultatifs.The required components of the artifact are installed, but not the recommended or optional components. Vous pouvez contrôler globalement les autres composants à l’aide des options --includeRecommended et/ou --includeOptional.You can control additional components globally using --includeRecommended and/or --includeOptional. Pour un contrôle plus précis, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeOptional).For finer-grained control, you can append ;includeRecommended or ;includeOptional to the ID (for example, --add Workload1;includeRecommended or --add Workload2;includeOptional). Pour plus d’informations, consultez la page ID de charge de travail et de composant.For more information, see the Workload and component IDs page.
Remarque : Si --add est utilisé, seuls les composants et les charges de travail spécifiés ainsi que leurs dépendances sont téléchargés.Note: If --add is used, only the specified workloads and components and their dependencies are downloaded. Si --add elle n’est pas spécifiée, toutes les charges de travail et les composants sont téléchargés sur la mise en page.If --add isn't specified, all workloads and components are downloaded to the layout.
--includeRecommended Optionnel: Inclut les composants recommandés pour toute charge de travail qui est installée, mais pas les composants optionnels.Optional: Includes the recommended components for any workloads that are installed, but not the optional components. Les charges de travail sont spécifiées avec --allWorkloads ou --add.The workloads are specified either with --allWorkloads or --add.
--includeOptional Facultatif : inclut les composants recommandés et facultatifs pour toutes les charges de travail contenues dans la disposition.Optional: Includes the recommended and optional components for any workloads being included in the layout. Les charges de travail sont spécifiées avec --add.The workloads are specified with --add.
--keepLayoutVersion Optionnel: Appliquer des modifications à la mise en page sans mettre à jour la version de la mise en page.Optional: Apply changes to the layout without updating the version of the layout.
--verify Optionnel: Vérifier le contenu d’une mise en page.Optional: Verify the contents of a layout. Tous les fichiers endommagés ou manquants sont listés.Any corrupt or missing files are listed.
--fix Optionnel: Vérifier le contenu d’une mise en page.Optional: Verify the contents of a layout. Si des fichiers sont corrompus ou manquants, ils sont rechargés.If any files are corrupt or missing, they're redownloaded. Un accès à Internet est obligatoire pour corriger une disposition.Internet access is required to fix a layout.
--clean <one or more paths to catalogs> Optionnel: Supprime les anciennes versions des composants d’une mise en page qui a été mise à jour à une version plus récente.Optional: Removes old versions of components from a layout that has been updated to a newer version.
Options d’installation avancéesAdvanced install options DescriptionDescription
--channelId <id> Facultatif : ID de canal pour l’instance à installer.Optional: The ID of the channel for the instance to be installed. Ceci est nécessaire pour la commande d’installation, et ignoré pour d’autres commandes si --installPath elle est spécifiée.This is required for the install command, and ignored for other commands if --installPath is specified.
--channelUri <uri> Optionnel: L’URI du manifeste de canal.Optional: The URI of the channel manifest. Si les mises à --channelUri jour ne sont pas souhaitées, peut indiquer un fichier inexistant (par exemple, --channelUri C: 'doesntExist.chman).If updates aren't wanted, --channelUri can point to a non-existent file (for example, --channelUri C:\doesntExist.chman). Cela peut être utilisé pour la commande d’installation; il est ignoré pour d’autres commandes.This can be used for the install command; it's ignored for other commands.
--installChannelUri <uri> Optionnel: L’URI du canal manifeste à utiliser pour l’installation.Optional: The URI of the channel manifest to use for the installation. L’URI spécifié par --channelUri (qui doit être spécifié en même temps que --installChannelUri) est utilisé pour détecter les mises à jour.The URI specified by --channelUri (which must be specified when --installChannelUri is specified) is used to detect updates. Cela peut être utilisé pour la commande d’installation; il est ignoré pour d’autres commandes.This can be used for the install command; it's ignored for other commands.
--installCatalogUri <uri> Optionnel: L’URI du catalogue manifeste à utiliser pour l’installation.Optional: The URI of the catalog manifest to use for the installation. Si spécifié, le gestionnaire de canal tente de télécharger le manifeste de catalogue à partir de cet URI avant d’utiliser l’URI du manifeste de canal d’installation.If specified, the channel manager attempts to download the catalog manifest from this URI before using the URI in the install channel manifest. Ce paramètre est utilisé pour prendre en charge l’installation hors connexion, où le cache de disposition est créé avec le catalogue de produits déjà téléchargé.This parameter is used to support offline install, where the layout cache will be created with the product catalog already downloaded. Cela peut être utilisé pour la commande d’installation; il est ignoré pour d’autres commandes.This can be used for the install command; it's ignored for other commands.
--productId <id> Facultatif : ID de produit pour l’instance à installer.Optional The ID of the product for the instance that will be installed. Ceci est pré-peuplé dans des conditions normales d’installation.This is pre-populated in normal installation conditions.
--wait Facultatif : le processus attend la fin de l’installation pour retourner un code de sortie.Optional: The process will wait until the install is completed before returning an exit code. Cela est utile lorsque vous automatisez des installations et que vous devez attendre la fin de l’installation pour gérer le code de retour de cette installation.This is useful when automating installations where one needs to wait for the install to finish to handle the return code from that install.
--locale <language-locale> Facultatif : permet de changer la langue d’affichage de l’interface utilisateur pour le programme d’installation proprement dit.Optional: Change the display language of the user interface for the installer itself. Ce paramètre est conservé.Setting will be persisted. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.For more information, see the List of language locales section on this page.
--cache Facultatif: Si vous êtes présent, les colis seront conservés après avoir été installés pour des réparations ultérieures.Optional: If present, packages will be kept after being installed for subsequent repairs. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, réparations ou modifications ultérieures.This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. La stratégie par défaut consiste à mettre les packages en cache.The default policy is to cache packages. Option ignorée pour la commande de désinstallation.This is ignored for the uninstall command. Pour plus d’informations, consultez Désactiver ou déplacer le cache du package.Read how to disable or move the package cache for more information.
--nocache Optionnel: Si vous êtes présent, les paquets seront supprimés après avoir été installés ou réparés.Optional: If present, packages will be deleted after being installed or repaired. Ils ne seront téléchargés à nouveau que si nécessaire et supprimés à nouveau après utilisation.They'll be downloaded again only if needed and deleted again after use. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, réparations ou modifications ultérieures.This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. La stratégie par défaut consiste à mettre les packages en cache.The default policy is to cache packages. Option ignorée pour la commande de désinstallation.This is ignored for the uninstall command. Pour plus d’informations, consultez Désactiver ou déplacer le cache du package.Read how to disable or move the package cache for more information.
--noUpdateInstaller Optionnel: Si présent, empêche l’installateur de se mettre à jour lorsqu’il est calme.Optional: If present, prevents the installer from updating itself when quiet is specified. Le programme d’installation ne parvient pas à exécuter la commande et retourne un code de sortie différent de zéro si noUpdateInstaller est spécifié avec le mode silencieux quand une mise à jour du programme d’installation est obligatoire.The installer will fail the command and return a non-zero exit code if noUpdateInstaller is specified with quiet when an installer update is required.
--noWeb Optionnel: Si vous êtes présent, visual Studio configure utilise les fichiers de votre répertoire de mise en page pour installer Visual Studio.Optional: If present, Visual Studio setup uses the files in your layout directory to install Visual Studio. Si un utilisateur tente d’installer des composants qui ne sont pas dans la mise en page, la configuration échoue.If a user tries to install components that aren't in the layout, setup fails. Pour plus d’informations, consultez Déploiement à partir d’une installation réseau.For more information, see Deploying from a network installation.

Important: Ce commutateur n’empêche pas la configuration Visual Studio de vérifier les mises à jour.Important: This switch doesn't stop Visual Studio setup from checking for updates. Pour plus d’informations, consultez Contrôler les mises à jour applicables aux déploiements de Visual Studio à partir du réseau.For more information, see Control updates to network-based Visual Studio deployments. Nouveau en 16.3.5: Ce commutateur prévient les erreurs et améliore les performances avec des installations et des mises à jour hors ligne.New in 16.3.5: This switch prevents errors and improves performance with offline installs and updates.
--path <name>=<path> Optionnel: Utilisé pour spécifier des voies d’installation personnalisées pour l’installation.Optional: Used to specify custom install paths for the installation. Les noms de chemin pris en charge sont shared, cache et install.Supported path names are shared, cache, and install.
--path cache=<path> Optionnel: Utilise l’emplacement que vous spécifiez pour télécharger des fichiers d’installation.Optional: Uses the location you specify to download installation files. Cet emplacement peut être défini uniquement pendant la première installation de Visual Studio.This location can only be set the first time that Visual Studio is installed. Exemple : --path cache="C:\VS\cache"Example: --path cache="C:\VS\cache"
--path shared=<path> Optionnel: Contient des fichiers partagés pour des installations de Visual Studio côte à côte.Optional: Contains shared files for side-by-side Visual Studio installations. Certains outils et kits SDK effectuent l’installation à un emplacement sur ce lecteur, tandis que d’autres peuvent l’effectuer sur un autre lecteur en passant outre ce paramétrage.Some tools and SDKs install to a location on this drive, while some others might override this setting and install to another drive. Exemple : --path shared="C:\VS\shared"Example: --path shared="C:\VS\shared"

Important : Ceci ne peut être défini qu’une seule fois, lors de la première installation de Visual Studio.Important: This can be set only once and on the first time that Visual Studio is installed.
--path install=<path> Optionnel: –-installPathÉquivalent à .Optional: Equivalent to –-installPath. En particulier, les options --installPath "C:\VS" et --path install="C:\VS" sont équivalentes.Specifically, --installPath "C:\VS" and --path install="C:\VS" are equivalent. Une seule de ces commandes peut être utilisée à la fois.Only one of these commands can be used at a time.

Liste des ID de charge de travail et de composantList of workload IDs and component IDs

Pour obtenir la liste des ID de charge de travail et de composant triés par produit Visual Studio, consultez la page ID de charge de travail et de composant Visual Studio.For a list of workload and component IDs sorted by Visual Studio product, see the Visual Studio workload and component IDs page.

Liste des paramètres régionaux de langueList of language locales

Paramètres régionaux de langueLanguage-locale LangueLanguage
Cs-czCs-cz TchèqueCzech
De-deDe-de AllemandGerman
En-usEn-us AnglaisEnglish
Es-esEs-es EspagnolSpanish
Fr-frFr-fr FrançaisFrench
It-itIt-it ItalienItalian
Ja-jpJa-jp JaponaisJapanese
Ko-krKo-kr CoréenKorean
Pl-plPl-pl PolonaisPolish
Pt-brPt-br Portugais - BrésilPortuguese - Brazil
Ru-ruRu-ru RusseRussian
Tr-trTr-tr TurcTurkish
Zh-cnZh-cn Chinois - simplifiéChinese - Simplified
Zh-twZh-tw Chinois - traditionnelChinese - Traditional

Codes d’erreurError codes

En fonction du résultat de l’opération, la variable d’environnement %ERRORLEVEL% a l’une des valeurs suivantes :Depending on the result of the operation, the %ERRORLEVEL% environment variable is set to one of the following values:

ValeurValue RésultatResult
00 Opération effectuée avec succèsOperation completed successfully
16021602 Opération annuléeOperation was canceled
16411641 Opération achevée avec succès, le redémarrage a été lancéOperation completed successfully, and reboot was initiated
30103010 Opération effectuée avec succès, mais l’installation nécessite un redémarrage avant de pouvoir être utiliséeOperation completed successfully, but install requires reboot before it can be used
50035003 Le programme d’amorçage a échoué à télécharger le programme d’installationBootstrapper failed to download installer
50045004 Opération annuléeOperation was canceled
50055005 Erreur d’analyse de la ligne de commande du programme d’amorçageBootstrapper command-line parse error
50075007 L’opération a été bloquée - l’ordinateur ne répond pas à la configuration requiseOperation was blocked - the computer does not meet the requirements
-1073741510-1073741510 Microsoft Visual Studio Installer a été arrêté (par l’utilisateur ou par un processus externe)Microsoft Visual Studio Installer was terminated (by the user or external process)
AutresOther
(par exemple :(for example:
-1, 1, 1603)-1, 1, 1603)
Une condition d’échec s’est produite - Pour plus d’informations, consultez les journauxFailure condition occurred - check the logs for more information

Chaque opération génère plusieurs fichiers journaux dans le répertoire %TEMP%, qui indiquent la progression de l’installation.Each operation generates several log files in the %TEMP% directory that indicate the progress of the installation. Triez le dossier par date et recherchez les fichiers commençant par dd_bootstrapper, dd_client et dd_setup pour le programme d’amorçage, l’application du programme d’installation et le moteur d’installation, respectivement.Sort the folder by date and look for files that begin with dd_bootstrapper, dd_client, and dd_setup for the bootstrapper, the installer app, and the setup engine, respectively.

Obtenir de l’aideGet support

Parfois, des problèmes peuvent se produire.Sometimes, things can go wrong. Si votre installation de Visual Studio échoue, consultez Résolution des problèmes d’installation et de mise à niveau de Visual Studio pour obtenir une aide pas à pas.If your Visual Studio installation fails, see Troubleshoot Visual Studio installation and upgrade issues for step-by-step guidance.

Nous offrons également une option de support par chat sur les installations (en anglais uniquement) pour les problèmes liés à l’installation.We also offer an installation chat (English only) support option for installation-related issues.

Voici d’autres options de support :Here are a few more support options:

Voir aussiSee also