Utiliser des paramètres de ligne de commande pour installer, mettre à jour et gérer Visual Studio

Lorsque vous installez Visual Studio par programmation ou à partir d’une invite de commandes, vous pouvez utiliser différents paramètres de ligne de commande pour contrôler ou personnaliser l’installation pour effectuer les actions suivantes :

• Démarrez l’installation sur le client avec certaines options et comportements préélectionnés.
• Automatisez le processus d’installation ou de mise à jour.
• Créez ou gérez une disposition réseau des fichiers produits pour l’installation ou la mise à jour des ordinateurs clients.

Les verbes et paramètres de ligne de commande suivants peuvent être utilisés avec les exécutables ou programmes suivants :

• Programme d’amorçage du programme d’installation, le petit fichier d’environ 1 Mo (par exemple, vs_enterprise.exe) qui lance le processus de téléchargement et l’installation initiale.
• Le programme d’installation de Visual Studio qui peut déjà être installé sur l’ordinateur et se trouve dans le dossier C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Vous devez lancer le programme d’installation à partir d’un répertoire différent dans lequel réside le programme d’installation. Le programme d’installation est généralement utilisé pour mettre à jour ou modifier des commandes.
• Avec une commande winget utilisant le commutateur --override de winget.
• Avec un package de mise à jour d’administrateur, disponible en téléchargement à partir du catalogue Microsoft Update, pour mettre à jour automatiquement votre configuration réseau. Vous trouverez plus d’informations dans l’article Mettre à jour ou modifier votre disposition.

Pas toutes les commandes ou paramètres fonctionnent dans chacune de ces situations, et toute mise en garde ou exception spéciale est documentée. En outre, dans certains scénarios, vous n’avez peut-être pas accès à tous ces exécutables décrits précédemment. Par exemple, les ordinateurs clients peuvent uniquement avoir le programme d’installation disponible pour l’exécution par programmation si Visual Studio a été installé via une disposition.

Pour obtenir les derniers programmes de démarrage système pour Visual Studio 2022 qui installent toujours la dernière version de la chaîne actuelle, téléchargez l’un des fichiers indiqués dans le tableau suivant. Vous pouvez également installer une version spécifique ou un canal spécifique de Visual Studio 2022, consultez la page Historique des versions de Visual Studio 2022. Cette page contient des liens vers les programme de démarrage système de version définitive pour chaque version de mise en production.

Édition	Programme d’amorçage
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Communauté Visual Studio 2022	vs_community.exe
Outils de génération Visual Studio 2022	vs_buildtools.exe

Conseil

Si vous avez précédemment téléchargé un fichier de programme d’amorçage et souhaitez vérifier la version qu’il installera, voici comment procéder. Dans Windows, ouvrez l’Explorateur de fichiers, cliquez avec le bouton droit sur le fichier de programme d’amorçage, choisissez Propriétés, puis choisissez l’onglet Détails. Le champ version du produit décrit le canal de et la version que le programme d’amorçage installera. Le numéro de version doit toujours être lu en tant que « dernière version de maintenance de ce qui est spécifié » et le canal est Actif, sauf indication explicite. Ainsi, un programme d’amorçage avec la version de produit LTSC 17.0 installe la dernière version de maintenance 17.0.x disponible sur le canal LTSC 17.0. Un programme de démarrage système avec une version de produit indiquant simplement Visual Studio 2022 installe la dernière version de Visual Studio 2022 sur le canal actuel.

Installer, mettre à jour, modifier, réparer, désinstaller et exporter des commandes et des paramètres de ligne de commande

Lors de l’appel du programme d’amorçage Visual Studio ou du programme d’installation pour installer le produit ou pour maintenir une configuration :

• Le premier paramètre est la commande (verbe) qui décrit l’opération à effectuer.
• Les paramètres de ligne de commande facultatifs suivants, tous précédés de deux tirets (--), définissent davantage la façon dont cette opération est censée se produire.

Tous les paramètres de ligne de commande Visual Studio ne respectent pas la casse, et vous trouverez des exemples supplémentaires dans la page Exemples de paramètres de ligne de commande.

Exemple de syntaxe : vs_enterprise.exe [command] <optional parameters>...

Commande	Description
(vide)	La commande par défaut installe le produit et elle est utilisée pour toutes les opérations de maintenance de disposition.
modify	Modifie un produit installé.
update	Met à jour un produit installé.
updateall	Met à jour tous les produits installés dans l’ordre séquentiel. Fonctionne avec des paramètres --quiet et --passive.
repair	Répare un produit installé.
uninstall	Désinstalle un produit installé.
export	Exporte la configuration d’installation dans un fichier *.vsconfig.

Important

Lorsque vous spécifiez plusieurs charges de travail ou composants ou langages distincts, vous devez répéter le commutateur de ligne de commande --add ou --remove pour chaque élément.

Paramètres	Description
--installPath <dir>	Pour la commande d’installation par défaut, ce paramètre est facultatif et décrit l’emplacement d’installation de l’instance sur l’ordinateur client. Pour d’autres commandes telles que la mise à jour ou la modification, ce paramètre est Obligatoire et indique le répertoire d’installation pour que l’instance agisse.
--productId <id>	facultatif : ID de l’instance de produit modifiée et utilisée avec --channelId. Le productID est similaire à « Microsoft.VisualStudio.Product.Enterprise ».
--channelUri	facultatif : lors d'une commande de mise à jour, vous pouvez passer une nouvelle --channelUri afin de modifier l’emplacement des paramètres de mise à jour. Il est recommandé d’associer un paramètre --installPath pour que cela soit clair, quelle instance de Visual Studio vous configurez. Consultez exemples de syntaxe de --channelUri
--channelId <id>	ID du canal, par exemple, VisualStudio.17.Release. Consultez exemples de syntaxe de --channelId. channelId est nécessaire pour les opérations de modification, en même temps que --productID ou --installPath.
--add <one or more workload or component IDs>	facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible spécifie un ou plusieurs ID de charge de travail ou de composant à ajouter. Les composants requis de l’artefact sont installés, mais pas les composants recommandés ou facultatifs. Vous pouvez contrôler d’autres composants globalement à l’aide de paramètres --includeRecommended et/ou --includeOptional. Pour inclure plusieurs charges de travail ou composants, répétez la commande --add (par exemple, --add Workload1 --add Workload2). Pour un contrôle plus fin, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeRecommended;includeOptional). Pour plus d’informations, consultez la page Charges de travail et ID de composant.
--all	facultatif : lors d’une commande d’installation ou de modification, ce paramètre entraîne l’installation de toutes les charges de travail et composants du produit.
--allWorkloads	facultatif : pendant une commande d’installation ou de modification, ce paramètre installe toutes les charges de travail et tous les composants, mais pas de composants recommandés ou facultatifs.
--includeRecommended	facultatif : pendant une commande d’installation ou de modification, ce paramètre inclut les composants recommandés pour toutes les charges de travail installées. Il n’inclut pas les composants facultatifs. Les charges de travail sont spécifiées avec --allWorkloads ou --add. Notez que, à l’aide du paramètre --includeRecommended, vous allez activer votre boîte de dialogue Paramètres de mise à jour pour « ajouter les composants recommandés pour les charges de travail installées lors de la mise à jour ». Consultez Personnaliser les paramètres de mise à jour pour modifier ce paramètre.
--includeOptional	facultatif : lors d’une commande d’installation ou de modification, ce paramètre inclut les composants facultatifs des charges de travail installées. Il n’inclut pas les composants recommandés. Les charges de travail sont spécifiées avec --allWorkloads ou --add.
--addProductLang <language-locale>	facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible spécifie les modules linguistiques de l’interface utilisateur qui doivent être installés avec le produit. S’il n’est pas présent, l’installation utilise le module linguistique correspondant aux paramètres régionaux de l’ordinateur. Pour plus d’informations, consultez la [liste des paramètres régionaux de langue]
--remove <one or more workload or component IDs>	facultatif : pendant une commande de modification, ce paramètre reproductible spécifie un ou plusieurs ID de charge de travail ou de composant à supprimer. Il complète et se comporte de la même façon que le paramètre --add.
Section (#list-of-language-locales) de cette page.
--removeProductLang <language-locale>	facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible détermine les modules linguistiques de l’interface utilisateur qui doivent être supprimés du produit. Il complète et se comporte de la même façon que le paramètre --addProductLang.
--in <path>	facultatif : URI ou chemin d’accès à un fichier réponse , qui peut contenir des paramètres de configuration.
--quiet	facultatif : utilisé avec n’importe quelle commande, ce paramètre empêche toute interface utilisateur d’être affichée pendant l’exécution de la commande. Non disponible pour une utilisation par programmation par les utilisateurs standard, quelle que soit la façon dont la stratégie AllowStandardUserControl est définie.
--passive, -p	facultatif : ce paramètre entraîne l’affichage de l’interface utilisateur de manière non interactive. Ce paramètre s’exclue mutuellement (et remplace en fait) le paramètre --quiet. Il n'est pas non plus possible de l'utiliser de manière programmatique par les utilisateurs standard, indépendamment de la façon dont la stratégie AllowStandardUserControl est définie.
--norestart	facultatif : ce paramètre doit être associé aux paramètres --passive ou --quiet. Pendant une commande d’installation, de mise à jour ou de modification, l’ajout du paramètre --norestart retarde tout redémarrage nécessaire.
--force	facultatif : ce paramètre force Visual Studio à fermer même si un processus Visual Studio est en cours d’utilisation. Forcer la fermeture de Visual Studio peut entraîner une perte de travail. Utilisez donc cette action avec précaution.
--installWhileDownloading	facultatif : lors d’une commande d’installation, de mise à jour ou de modification, ce paramètre permet à Visual Studio de télécharger et d’installer le produit en parallèle. C’est l’expérience par défaut.
--downloadThenInstall	facultatif : pendant une commande d’installation, de mise à jour ou de modification, ce paramètre force Visual Studio à télécharger tous les fichiers avant de les installer. Elle s’exclut mutuellement du paramètre --installWhileDownloading.
--nickname <name>	facultatif : pendant une commande d’installation, ce paramètre définit le surnom à attribuer à un produit installé. Le surnom ne peut pas dépasser 10 caractères.
--productKey	facultatif : pendant une commande d’installation, ce paramètre définit la clé de produit à utiliser pour un produit installé. La clé de produit est composée de 25 caractères alphanumériques au format xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	facultatif : lors d’une commande d’installation, de mise à jour ou de modification, ce paramètre, suivi de true ou de false, indique au programme d’installation de Visual Studio s’il faut supprimer tous les composants installés transférés vers un état hors support. Ce comportement s’applique à un seul événement. Si vous souhaitez rendre ce comportement persistant, appliquez ce paramètre à la commande modifySettings, décrite ultérieurement ou configurer la stratégie globale removeOOS. Utile pour aider à sécuriser la machine.
--config <path to *.vsconfig file>	facultatif : pendant une opération d’installation ou de modification, vous pouvez transmettre un fichier de configuration à l’aide du paramètre --config pour spécifier les charges de travail, les composants ou les extensions à ajouter en fonction d’un fichier de configuration d’installation précédemment enregistré. Cette opération est additive uniquement ; elle ne supprime rien qui n'est pas spécifié dans le fichier. En outre, les éléments spécifiés dans le fichier de configuration qui ne s’appliquent pas au produit ne sont pas ajoutés. Il est vivement recommandé de spécifier le chemin complet du fichier config. Pendant une opération d’exportation, ce paramètre détermine l’emplacement pour enregistrer le fichier de configuration d’installation.
--allowUnsignedExtensions	facultatif : lors d’une opération d’installation ou de modification exécutée dans un contexte --passive ou --quiet à l’aide d’un fichier --config, si des extensions sont spécifiées dans le fichier config, ce paramètre est nécessaire pour charger des extensions sans signature numérique.
--installerOnly	facultatif : pendant une opération d’installation ou de mise à jour, ce paramètre indique au programme d’installation de Visual Studio d’installer uniquement lui-même (le programme d’installation) et non le produit Visual Studio. Ses fonctionnalités sont équivalentes au paramètre --update, mais plus intuitives. Destiné à être utilisé pour la préparation et la préconfiguration des ordinateurs clients.
--help, --?, -h, -?	Affiche une version hors connexion de cette page.

Commande de disposition et paramètres de ligne de commande

Toutes les opérations de gestion de disposition, telles que la création ou la mise à jour d’une disposition, sont exécutées à l’aide de l’exe du programme de démarrage système et supposent que la commande est l’installation par défaut (vide). Toutes les opérations de gestion de disposition doivent commencer par le paramètre initial --layout requis. Le tableau suivant décrit les autres paramètres que vous pouvez utiliser pour créer ou mettre à jour une disposition à l’aide de la ligne de commande.

paramètres de disposition	Description
--layout <dir>	Spécifie un répertoire pour créer ou mettre à jour un cache d’installation hors connexion. Pour plus d’informations, consultez Créer une installation basée sur le réseau de 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 avec une ou plusieurs langues spécifiées. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.
--add <one or more workload or component IDs>	facultatif : un ou plusieurs identifiants de charge de travail ou de composant à ajouter. Les composants requis de l’artefact sont installés, mais pas les composants recommandés ou facultatifs. Vous pouvez contrôler plus de composants globalement à l’aide de --includeRecommended et/ou de --includeOptional. Pour un contrôle plus fin, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeOptional). Pour plus d’informations, consultez la page Charges de travail et ID de composant. Remarque: si --add est utilisé, seules les charges de travail et les composants spécifiés et leurs dépendances sont téléchargés. Si --add n’est pas spécifié, l’ensemble des charges de travail et des composants est téléchargé sur la disposition.
--includeRecommended	facultatif : inclut les composants recommandés pour toutes les charges de travail installées, mais pas les composants facultatifs. Les charges de travail sont spécifiées avec --allWorkloads ou --add.
--includeOptional	facultatif : inclut les composants recommandés et les composants facultatifs pour toutes les charges de travail incluses dans la mise en page. Les charges de travail sont spécifiées avec --add.
--wait	facultatif : le processus attend que l’installation soit terminée avant de retourner un code de sortie. wait est utile lorsqu'on automatise les installations et que l'on doit attendre la fin de l'installation pour traiter le code de retour. Le paramètre --wait ne peut être transmis qu’au programme de démarrage système ; le programme d’installation (setup.exe) ne le prend pas en charge. Il est utile lors de la mise à jour des agencements. Vous trouverez d’autres exemples ici.
--useLatestInstaller	Facultatif : fonctionnalité héritée applicable uniquement aux programme de démarrage système Visual Studio antérieurs à avril 2023. Tout ce qui est livré après avril 2023 utilise le dernier programme d’installation par défaut. Si ce paramètre est présent, la dernière version de Visual Studio Installer est incluse dans votre disposition, même si elle appartient à une version majeure plus récente du produit. Le dernier programme d’installation peut être utile si vous souhaitez tirer parti des nouvelles fonctionnalités ou des correctifs de bogues disponibles dans sa dernière version. Pour plus d’informations, reportez-vous à la documentation Configurer la mise en page pour utiliser toujours la dernière version de l'installateur.
--config <path to *.vsconfig file>	facultatif : s’il est présent, Visual Studio utilise le contenu du fichier de configuration pour configurer votre disposition. Veillez à spécifier le chemin complet du fichier config.
--noWeb	facultatif : le cas échéant, le programme d’installation de Visual Studio utilise les fichiers de votre répertoire de disposition pour installer Visual Studio, et il ne télécharge aucun package à partir du web. Si un utilisateur tente d’installer des composants qui ne sont pas dans la disposition, le programme d’installation échoue. N’utilisez pas ce paramètre si vous essayez de déployer une disposition hébergée sur un site web intranet interne. Pour plus d’informations, consultez Installer sur un client qui n’a pas accès à Internet. important : le paramètre --noWeb n’empêche pas Visual Studio Installer sur une machine cliente connectée à Internet de vérifier les mises à jour si le client est configuré pour examiner les serveurs hébergés par Microsoft pour les mises à jour. Dans ce cas, --noWeb empêche simplement le client de télécharger les packages de produits.
--verify	Vérification facultative : vérifiez le contenu d'une mise en page. Tous les fichiers endommagés ou manquants sont répertoriés.
--fix	facultatif : vérifiez le contenu d’une mise en page. Si des fichiers sont endommagés ou manquants, ils sont retéléchargés. L’accès à Internet est nécessaire pour corriger une disposition.
--clean <one or more paths to catalogs>	Facultatif : supprime les anciennes versions des composants d’une disposition mise à jour vers une version plus récente.

paramètres de disposition avancés	Description
--channelId <id>	facultatif : l'ID du canal pour l'instance à installer, représenté par VisualStudio.17.Release. channelId est requis pour la commande d’installation et ignoré pour d’autres commandes si --installPath est spécifié. Consultez syntax examples of --channelId.
--channelUri <uri>	facultatif : URI du manifeste de canal. Cette valeur régit l’emplacement source des mises à jour et la valeur initiale est configurée dans le fichier response.json de la disposition. Reportez-vous aux exemples de syntaxe de de --channelUri pour les valeurs possibles. Si les mises à jour ne sont pas souhaitées, --channelUri peut pointer vers un fichier inexistant (par exemple, --channelUri C:\doesntExist.chman). Ce paramètre peut être utilisé pour la commande d’installation ; d’autres commandes l’ignorent.
--installChannelUri <uri>	facultatif : URI du manifeste de canal à utiliser pour l’installation. L’URI spécifié par --channelUri (qui doit être spécifié lorsque --installChannelUri est spécifié) est utilisé pour détecter les mises à jour. Ce paramètre peut être utilisé pour la commande d’installation ; d’autres commandes l’ignorent.
--installCatalogUri <uri>	facultatif : URI du manifeste de catalogue à utiliser pour l’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. 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é. Ce paramètre peut être utilisé pour la commande d’installation ; d’autres commandes l’ignorent.
--productId <id>	facultatif : ID du produit pour l’instance installée. Ce paramètre est prérempli dans des conditions d’installation normales. Le productID est similaire à « Microsoft.VisualStudio.Product.Enterprise ».
--arch all	facultatif : Par défaut, les configurations sont créées avec uniquement des binaires du produit x64. Pour inclure des fichiers binaires ARM pour les charges de travail applicables en même temps que les fichiers binaires x64 dans une disposition, utilisez le paramètre --arch all ou --arch *. Pour créer une disposition de fichiers binaires ARM uniquement, utilisez --arch arm64
--keepLayoutVersion	Facultatif : appliquez des modifications à la disposition sans mettre à jour la version du produit incluse dans la disposition.
--locale <language-locale>	facultatif : modifiez la langue d’affichage de l’interface utilisateur pour le programme d’installation lui-même. Ce paramètre est conservé. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page.
--cache	Facultatif : le cas échéant, les packages sont conservés après leur installation pour les réparations ultérieures. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, les réparations ou les modifications suivantes. La stratégie par défaut consiste à mettre en cache les packages. Cette opération est ignorée pour la commande de désinstallation. Découvrez comment désactiver ou déplacer le cache de package pour plus d’informations.
--nocache	facultatif : s’il est présent, les packages sont supprimés après avoir été installés ou réparés. Ils seront téléchargés à nouveau uniquement si nécessaire et supprimés à nouveau après l’utilisation. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, les réparations ou les modifications suivantes. La stratégie par défaut consiste à mettre en cache les packages. Cette opération est ignorée pour la commande de désinstallation. Découvrez comment désactiver ou déplacer le cache de package pour plus d’informations.
--noUpdateInstaller	facultatif : s’il est présent, empêche le programme d’installation de se mettre à jour lorsque le mode silencieux est spécifié. Le programme d’installation échouera la commande et retournera un code de sortie différent de zéro si noUpdateInstaller est spécifié avec un silence lorsqu’une mise à jour du programme d’installation est requise.
--path <name>=<path>	facultatif : utilisé pour spécifier des chemins d’installation personnalisés pour l’installation. Les noms de chemins pris en charge sont partagés, mis en cache et installés.
--path cache=<path>	facultatif : utilise l’emplacement que vous spécifiez pour télécharger les fichiers d’installation. Cet emplacement ne peut être défini que la première fois que Visual Studio est installé. Exemple : --path cache="C:\VS\cache"
--path shared=<path>	facultatif : contient des fichiers partagés pour les installations côte à côte de Visual Studio. Certains outils et kits SDK s’installent sur un emplacement sur ce lecteur, tandis que d’autres peuvent remplacer ce paramètre et l’installer sur un autre lecteur. Exemple : --path shared="C:\VS\shared" important : cela ne peut être défini qu’une seule fois et la première fois que Visual Studio est installé.
--path install=<path>	facultatif : équivalent à –-installPath. Plus précisément, --installPath "C:\VS" et --path install="C:\VS" sont équivalents. Une seule de ces commandes peut être utilisée à la fois.

Commande ModifySettings et paramètres de ligne de commande

Vous pouvez modifier les paramètres de mise à jour et configurer par programmation l’emplacement source des mises à jour d’une instance donnée de Visual Studio à l’aide du programme d’installation ou du programme d’amorçage sur l’ordinateur client, puis en passant la commande modifySettings et le canal de mise à jour souhaité.

Commande	Description
modifySettings	Verbe utilisé pour modifier les paramètres de mise à jour d’une instance particulière de Visual Studio.

Paramètres modifySettings	Description
--installPath <dir>	recommandé à utiliser pour spécifier l’instance de Visual Studio à utiliser.
--newChannelUri	obligatoire : URI du manifeste du canal. Cette valeur spécifie où se trouve l’emplacement source suivant les mises à jour. Reportez-vous aux exemples de syntaxe de , concernant --channelUri, pour connaître les valeurs possibles. Si les mises à jour ne sont pas souhaitées, --channelUri peut pointer vers un fichier inexistant (par exemple, --channelUri C:\doesntExist.chman).
--channelUri	URI de l’ancien manifeste du canal. Peut être utilisé si --installPath n’est pas connu. Doit être utilisé conjointement avec productID pour identifier l’instance appropriée sur laquelle agir.
--productId <id>	Doit être utilisé si --channelUri est spécifié et est utilisé pour identifier l’instance appropriée à agir. Le productID est similaire à « Microsoft.VisualStudio.Product.Enterprise ».
--includeRecommended	facultatif : lors d’une commande modifySettings, ce paramètre (qui doit avoir le mot true ou false immédiatement après celui-ci) indique au programme d’installation de Visual Studio de désactiver la fonctionnalité « ajouter les composants recommandés pour les charges de travail installées lors de la mise à jour » dans la boîte de dialogue Paramètre de mise à jour.
--quiet	facultatif : ce paramètre empêche toute interface utilisateur d’être affichée pendant l’exécution de la commande. Non disponible pour une utilisation par programmation par utilisateurs standard.
--removeOos true	Facultatif : lors d’une commande modifySettings, ce paramètre (qui doit contenir le mot true ou false immédiatement après) indique au programme Visual Studio Installer de supprimer (ou de ne pas supprimer) de manière permanente tous les composants installés qui sont passés à un état de non prise en charge. Utile pour aider à sécuriser la machine.

Exemples de syntaxe :

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Commande de retour en arrière et paramètres de ligne de commande

À compter de Visual Studio 2022, vous pouvez restaurer une mise à jour par programmation à l’aide du programme d’installation sur l’ordinateur client et en passant la commande de restauration en même temps que l’instance de chemin d’installation.

Commande	Description
rollback	Commande pour restaurer une instance particulière de Visual Studio vers la mise à jour précédemment installée. Cette commande ne fonctionnera pas si le DisableRollback est activé.

paramètres de restauration	Description
--installPath <dir>	recommandé à utiliser pour spécifier l’instance de Visual Studio à utiliser.

Exemples de syntaxe :

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Paramètres de ligne de commande et de commande de la mise à jour de l’administrateur

Vous pouvez télécharger une mise à jour administrateur à partir du catalogue Microsoft Update et l’utiliser pour mettre à jour votre installation cliente ou votre disposition.

Mise à jour d’une disposition

Si vous mettez à jour une disposition vers une version particulière de Visual Studio, téléchargez simplement la mise à jour administrateur sur l’ordinateur qui héberge la disposition, ouvrez une invite de commandes sur cet ordinateur et exécutez une commande comme suit :

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Mise à jour d’un client

Sur le client, si vous téléchargez la mise à jour administrateur dans votre répertoire d’installation sur votre ordinateur client, vous pouvez simplement double-cliquer sur le fichier pour appliquer la mise à jour. Vous pouvez également ouvrir une fenêtre de commande et passer certains des paramètres ci-dessous pour modifier le comportement par défaut.

Configuration de la mise à jour d’administrateur dans SCCM

Si vous déployez la mise à jour de l’administrateur via Microsoft Endpoint Manager (SCCM), vous pouvez modifier le package pour ajuster le comportement à l’aide des paramètres ci-dessous. Vous pouvez également contrôler les paramètres via un fichier de configuration sur l’ordinateur client. Pour plus d’informations, consultez Méthodes de configuration d’une mise à jour d’administrateur

Notez que tous les paramètres de mise à jour de l'administrateur sont exécutés par défaut dans le contexte « mise à jour », sauf si le verbe de mise en page est spécifié.

paramètres de mise à jour d’administrateur	Description
--installerUpdateArgs [optional parameters]	Ce paramètre fonctionne comme un « tableau direct » de paramètres spécifiques qui sont pertinents pour les scénarios de mise à jour d’administrateur. Les paramètres facultatifs activés à cet effet sont les suivants : --quiet: il s’agit de l’expérience par défaut pour les mises à jour d’administrateur et est répertoriée ici pour la complétivité. --passive: ce paramètre remplace le paramètre --quiet. Elle entraîne l’affichage de l’interface utilisateur de manière non interactive. --norestart: ce paramètre doit être utilisé conjointement avec --quiet ou --passive et il provoque le retard des redémarrages nécessaires. --noWeb: ce paramètre empêche Visual Studio de vérifier sur Internet les mises à jour du produit. --force: ce paramètre force Visual Studio à fermer même si Visual Studio est en cours d’utilisation. Utilisez ce paramètre avec précaution, car il peut entraîner une perte de travail. Ce paramètre ne doit être utilisé que lorsque la mise à jour d’administrateur est exécutée dans le contexte utilisateur ; elle est ignorée si la mise à jour d’administrateur est exécutée dans le contexte système. --installWhileDownloading: ce paramètre permet à Visual Studio de télécharger et d’installer le produit en parallèle. Il s’agit de l’expérience par défaut pour les mises à jour d’administrateur et est répertoriée ici pour l’exhaustivité. --keepWindowsUpdateOn: ce paramètre empêche le programme d’installation de désactiver l’agent Windows Update sur le client. Vous devez utiliser ce paramètre si vous importez une mise à jour d’administrateur à partir du catalogue dans SCCM. Vous devrez peut-être également définir le délai d'expiration du package SCCM sur une durée supérieure à la valeur par défaut de 10 minutes. La modification du type de déploiement SCCM comme Obligatoire rend ce paramètre inutile. --downloadThenInstall: ce paramètre force Visual Studio à télécharger tous les fichiers avant de les installer. Elle s’exclut mutuellement du paramètre --installWhileDownloading.
--checkPendingReboot	La mise à jour est abandonnée s’il existe un redémarrage en attente sur l’ordinateur, quelle que soit l’application qui l’a peut-être provoqué. La valeur par défaut consiste à ne pas vérifier les redémarrages en attente.

Exemple de syntaxe pour passer des paramètres à une mise à jour d’administrateur :

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Supprimer les paramètres de commande de canal et de ligne de commande

Les canaux disponibles pour la mise à jour à partir de, sont mis en cache sur le client et, au fil du temps, ils peuvent s’encombrer. Vous pouvez supprimer manuellement les canaux de mise à jour en ouvrant Visual Studio Installer, en basculant vers l’onglet Disponible et en cliquant sur le X situé dans le coin supérieur droit de la carte de produit. Vous pouvez supprimer par programme des canaux (par exemple, des emplacements de disposition plus anciens) à l’aide de la commande removeChannel. Vous pouvez exécuter vswhere par programme sur l’ordinateur client pour déterminer les canaux mis en cache sur l’ordinateur client.

Commande	Description
removeChannel	Commande pour supprimer un canal de l’ordinateur client.

paramètres removeChannel	Description
--channelUri	Obligatoire L’URI de l’ancien manifeste de chaîne.
--quiet	facultatif Ce paramètre empêche toute interface utilisateur d’être affichée pendant l’exécution de la commande.
--passive	Facultatif Ce paramètre remplace le paramètre --quiet. Elle entraîne l’affichage de l’interface utilisateur de manière non interactive.

Exemple de syntaxe :

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Utiliser winget pour installer ou modifier Visual Studio

Vous pouvez utiliser l’outil Gestionnaire de package Windows « winget » pour installer, modifier ou mettre à jour Visual Studio par programmation sur votre ordinateur, ainsi que d’autres packages gérés par winget.

Par défaut, winget installe simplement la charge de travail Visual Studio Core.

winget install --id Microsoft.VisualStudio.2022.Community

Toutefois, si vous souhaitez personnaliser l’installation et spécifier des charges de travail et des composants supplémentaires à acquérir lors de l’installation initiale, vous pouvez utiliser le commutateur --override de winget en même temps que la commande install de winget, et transmettre un fichier vsconfig exporté qui contient les charges de travail et les composants à ajouter :

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

Bien sûr, vous pouvez également inclure simplement des composants directement pendant l’installation initiale, comme suit :

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Si Visual Studio est déjà installé sur votre ordinateur, il est possible d’utiliser la commande winget configure avec le fournisseur DSC Visual Studio PowerShell, un fichier yaml et un fichier .vsconfig pour ajouter des composants à une installation existante de Visual Studio. La commande configure de Winget agit essentiellement comme une opération de « modification » de Visual Studio. Consultez comment créer un fichier de configuration WinGet pour apprendre à créer une configuration winget.

Il n’est pas possible d’utiliser le commutateur --override ou le fournisseur Visual Studio DSC en même temps que la commande upgrade de winget, car upgrade agit essentiellement comme une opération « mise à jour » de Visual Studio et installe la dernière version des composants que vous avez déjà sélectionnée. Vous ne pouvez pas ajouter de composants via une mise à jour/mise à niveau. Vous devez utiliser le configure du winget pour ajouter des composants.

Notez que les opérations visual Studio Installer nécessitent actuellement des privilèges d’administrateur. Winget vous invite donc à élever vos privilèges si nécessaire pour terminer la commande. En outre, il n’est actuellement pas possible d’utiliser winget pour installer plusieurs éditions (c’est-à-dire des références SKU différentes) ou plusieurs instances de la même référence SKU en même temps sur une machine cliente. Enfin, Visual Studio doit être fermé si vous souhaitez le configurer (modifier) pour ajouter des composants ou le mettre à niveau vers la dernière version.

Liste des ID de charge de travail et des ID de composant

Pour obtenir la liste des identifiants de charge de travail et de composant triés par produit Visual Studio, consultez la page des charges de travail et de composants Visual Studio .

Liste des localisations linguistiques

Paramètres régionaux de langue	Language
Cs-cz	Tchèque
De-de	Allemand
En-us	Anglais
Es-es	Espagnol
Fr-fr	Français
It-it	Italien
Ja-jp	Japonais
Ko-kr	Coréen
Pl-pl	Polonais
Pt-br	Portugais - Brésil
Ru-ru	Russe
Tr-tr	Turc
Zh-cn	Chinois - Simplifié
Zh-tw	Chinois - Traditionnel

Codes d’erreur

Selon le résultat de l’opération, la variable d’environnement %ERRORLEVEL% est définie sur l’une des valeurs suivantes :

Valeur	Résultat
0	Opération terminée avec succès
740	Élévation requise
1001	Le processus d’installation de Visual Studio est en cours d’exécution
1003	Visual Studio est en cours d’utilisation
1602	L’opération a été annulée
1618	Une autre installation en cours d’exécution
1641	L’opération s’est terminée avec succès et le redémarrage a été lancé
3010	L’opération s’est terminée correctement, mais l’installation nécessite un redémarrage avant de pouvoir être utilisée
5003	Échec du bootstrapper à télécharger le programme d’installation
5004	L’opération a été annulée
5005	Erreur d’analyse de la ligne de commande du programme de démarrage système
5007	Opération bloquée : l’ordinateur ne répond pas aux exigences
8001	Échec de la vérification de l’ordinateur ARM
8002	Échec de la vérification préalable du téléchargement en arrière-plan
8003	Échec sélectionnable non pris en charge
8004	Échec du répertoire cible
8005	Vérification de l’échec des charges utiles sources
8006	Processus Visual Studio en cours d’exécution
8010	Système d’exploitation non pris en charge. Reportez-vous à la configuration requise
-1073720687	Échec de connectivité
-1073741510	Microsoft Visual Studio Installer a été arrêté (par l’utilisateur ou le processus externe)
Autre (par exemple : -1, 1, 1603)	Une condition d’échec s’est produite - Pour plus d’informations, consultez les journaux

Chaque opération génère plusieurs fichiers journaux dans le répertoire %TEMP% qui indiquent la progression de l’installation. Triez le dossier par date et recherchez les fichiers commençant par dd_bootstrapper, dd_clientet dd_setup pour le programme d’amorçage, l’application d’installation et le moteur d’installation, respectivement.

Support ou résolution des problèmes

Parfois, les choses peuvent mal tourner. Si votre installation de Visual Studio échoue, consultez résoudre les problèmes d’installation et de mise à niveau de Visual Studio pour obtenir des instructions pas à pas.

Voici quelques options de support supplémentaires :

• Utilisez l'option de support par conversation d'installation (disponible uniquement en anglais) pour les problèmes liés à l'installation.
• Signalez des problèmes de produit à nous à l’aide de l’outil Signaler un problème qui apparaît à la fois dans Visual Studio Installer et dans l’IDE Visual Studio. Si vous êtes administrateur informatique et que vous n'avez pas installé Visual Studio, vous pouvez soumettre des commentaires aux administrateurs informatiques.
• Suggérer une fonctionnalité, suivre les problèmes de produit et trouver des réponses dans le Visual Studio Developer Community.

Contenu connexe

• exemples de paramètres de ligne de commande pour l’installation de Visual Studio
• Créer une installation hors connexion de Visual Studio
• Automatiser l’installation de Visual Studio avec un fichier réponse
• ID de charge de travail et de composant Visual Studio