Utiliser les 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 afin d’effectuer les actions suivantes :
- Démarrez l’installation sur le client avec certaines options et comportements présélectionnés.
- Automatisez le processus d’installation ou de mise à jour.
- Créez ou gérez une disposition réseau des fichiers produit 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.
- Programme d’installation de Visual Studio qui peut déjà être installé sur l’ordinateur et qui se trouve dans le dossier
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Vous devez lancer le programme d’installation par programmation à partir d’un répertoire autre que celui 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 administrateur, disponible en téléchargement à partir du catalogue Microsoft Update, pour mettre à jour par programmation votre disposition réseau. Vous trouverez plus d’informations dans l’article Mettre à jour ou modifier votre disposition.
Toutes les commandes ou paramètres ne fonctionnent pas dans chacune de ces situations, et toutes les mises en garde ou exceptions spéciales ne sont pas documentées. De plus, dans certains scénarios, vous pourriez ne pas avoir accès à tous ces exécutables décrits précédemment. Par exemple, les ordinateurs clients peuvent avoir le programme d’installation disponible uniquement pour l’exécution par programmation si Visual Studio a été installé par le biais d’une disposition.
Vous pouvez obtenir les programmes d’amorçage Visual Studio 2019 à partir du tableau suivant. Alternativement, si vous voulez une version spécifique de Visual Studio 2019, consultez la page Sorties de Visual Studio 2019. Cette page contient des liens vers les bootstrappers de version fixe pour votre version et édition choisies de Visual Studio.
| Édition | Programme d’amorçage |
|---|---|
| Visual Studio 2019 Enterprise version 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional version 16.11 | vs_professional.exe |
| Visual Studio 2019 Build Tools version 16.11 | vs_buildtools.exe |
Pour obtenir les derniers programmes d’amorçage 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. Pour installer une version spécifique ou un canal spécifique de Visual Studio 2022, vous pouvez également consulter la page Historique des versions de Visual Studio 2022. Cette page contient des liens vers les bootstrappers de version fixe pour chaque version de maintenance.
| Édition | Programme d’amorçage |
|---|---|
| Visual Studio 2022 Enterprise | vs_enterprise.exe |
| Visual Studio 2022 Professional | vs_professional.exe |
| Visual Studio 2022 Community | vs_community.exe |
| Visual Studio 2022 Build Tools | vs_buildtools.exe |
Conseil
Si vous avez précédemment téléchargé un fichier de programme d’amorçage et que vous souhaitez vérifier sa version, 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, choisissez l’onglet Détails, puis affichez le numéro de version du produit. Pour faire correspondre ce numéro à une version de Visual Studio, consultez le tableau situé en bas de la page Versions de Visual Studio 2019.
Conseil
Si vous avez précédemment téléchargé un fichier de programme d’amorçage et que vous souhaitez vérifier la version qu’il installe, 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 la chaîne et la version que le programme d’amorçage installera. Le numéro de version doit toujours être lu comme la « dernière version de maintenance de ce qui est spécifié », et le canal est Actuel, sauf indication explicite. Ainsi, un programme d’amorçage avec une version produit de LTSC 17.0 installe la dernière version de maintenance 17.0.x disponible sur la chaîne 17.0 LTSC. Un programme d’amorçage avec une version de produit indiquant simplement que Visual Studio 2022 installera la dernière version de Visual Studio 2022 sur la chaîne actuelle.
Les commandes installer, mettre à jour, modifier, réparer, désinstaller et exporter et paramètres de ligne de commande
Lors de l’invocation du bootstrapper de Visual Studio ou de l’installateur de manière programmatique pour installer le produit ou pour maintenir une disposition :
- Le premier paramètre est la commande (le verbe) qui décrit l’opération à effectuer.
- Les paramètres de ligne de commande optionnels suivants, tous précédés de deux tirets (--), définissent davantage comment 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.
Example de syntaxe : vs_enterprise.exe [command] <optional parameters>...
| Commande | Description |
|---|---|
| (vide) | La commande par défaut installe le produit et est utilisée pour toutes les opérations de maintenance de la 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 les 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 des charges de travail ou des composants et des 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 où l’instance est installée sur la machine cliente. Pour d’autres commandes telles que mettre à jour ou modifier, ce paramètre est Obligatoire et désigne le répertoire d’installation sur lequel l’instance doit agir. |
--productId <id> |
Facultatif : L’ID de l’instance de produit qui est modifiée, et utilisée avec --channelId. Le productID est quelque chose comme « Microsoft.VisualStudio.Product.Enterprise ». |
--channelUri |
Facultatif : Lors d’une commande de mise à jour, vous pouvez passer un nouveau --channelUri pour changer l’emplacement des paramètres de mise à jour. Recommandé de jumeler avec le paramètre --installPath pour qu’il soit explicite quelle instance de Visual Studio vous configurez. Voir exemples de syntaxe de --channelUri |
--channelId <id> |
L’ID du canal, par exemple, VisualStudio.17.Release. Voir exemples de syntaxe de --channelId. channelId est requis pour les opérations de modification, aux côtés de --productID ou --installPath. |
--add <one or more workload or component IDs> |
Optionnel : lors d’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 obligatoires de l’artefact sont installés, mais pas les composants recommandés ni facultatifs. Vous pouvez contrôler d’autres composants globalement en utilisant les 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 précis, 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 ID de charge de travail et de composant. |
--all |
Optionnel : 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 |
Optionnel : lors d’une commande d’installation ou de modification, ce paramètre installe toutes les charges de travail et tous les composants, mais aucun composant recommandé ou optionnel. |
--includeRecommended |
Facultatif : Lors d’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. Veuillez noter qu’en utilisant le paramètre --includeRecommended, vous activerez la boîte de dialogue Paramètres de mise à jour pour « ajouter des 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 optionnels pour toutes les 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> |
Optionnel : lors d’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 qui correspond aux paramètres régionaux de l’ordinateur. Pour plus d’informations, voir la section [Liste des locales de langue] |
--remove <one or more workload or component IDs> |
Optionnel : lors d’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. |
| (#liste-des-locales-de-langue) sur cette page. | |
--removeProductLang <language-locale> |
Optionnel : lors d’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> |
Optionnel : URI ou chemin d’accès à un fichier réponse, qui peut contenir des paramètres de configuration. |
--quiet |
Optionnel : utilisé avec n’importe quelle commande, ce paramètre empêche l’affichage d’une interface utilisateur pendant l’exécution de la commande. Non disponible pour utilisation programmatique par les utilisateurs standards indépendamment de la configuration de la politique AllowStandardUserControl. |
--passive, -p |
Optionnel : ce paramètre entraîne l’affichage de l’interface utilisateur de manière non interactive. Ce paramètre s’exclut mutuellement (et remplace en fait) le paramètre --quiet. Aussi non disponible pour utilisation programmatique par les utilisateurs standards indépendamment de la configuration de la politique AllowStandardUserControl. |
--norestart |
Optionnel : ce paramètre doit être associé aux paramètres --passive ou --quiet. Lors d’une commande d’installation, de mise à jour ou de modification, l’ajout du paramètre --norestart retarde tout redémarrage nécessaire. |
--force |
Optionnel : ce paramètre force Visual Studio à se fermer même si un processus Visual Studio est en cours d’utilisation. Le fait de forcer la fermeture de Visual Studio peut entraîner une perte de travail, utilisez donc ce paramètre avec précaution. |
--installWhileDownloading |
Optionnel : 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 |
Optionnel : lors d’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. Il s’exclut mutuellement du paramètre --installWhileDownloading. |
--nickname <name> |
Optionnel : lors d’une commande d’installation, ce paramètre définit le surnom à attribuer à un produit installé. La longueur du surnom ne peut pas dépasser 10 caractères. |
--productKey |
Optionnel : lors d’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 false, indique à l’installateur de Visual Studio s’il faut supprimer tous les composants installés passés à un état de non-support. Ce comportement s’applique à un événement unique. Si vous voulez rendre ce comportement persistant, appliquez ce paramètre à la commande modifySettings, décrite plus tard, ou configurez la politique globale removeOOS. Utile pour assurer la sécurité de la machine. |
--config <path to *.vsconfig file> |
Facultatif : Lors d’une opération d’installation ou de modification, vous pouvez passer un fichier de configuration en utilisant le paramètre --config pour spécifier les charges de travail, composants ou extensions à ajouter en fonction d’un fichier de configuration d’installation précédemment sauvegardé. Cette opération est uniquement additive ; elle ne supprime rien de ce qui n’est pas spécifié dans le fichier. De plus, 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 fortement recommandé de spécifier le chemin complet vers le fichier de configuration. Lors d’une opération d’exportation, ce paramètre détermine l’emplacement pour sauvegarder 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 de configuration, alors ce paramètre est nécessaire afin de charger des extensions sans signature numérique. |
--installerOnly |
Facultatif : Lors d’une opération d’installation ou de mise à jour, ce paramètre indique à l’installateur de Visual Studio d’installer uniquement lui-même (l’installateur) et non le produit Visual Studio. Sa fonctionnalité est équivalente au paramètre --update, mais plus intuitive. Destiné à être utilisé lors de la préparation et de 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’exécutable du bootstrapper 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 réseau de Visual Studio. |
--lang <one or more language-locales> |
Facultatif : Utilisé avec --layout pour préparer une cache d’installation hors ligne avec des paquets de ressources dans 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 ID de charge de travail ou composant à ajouter. Les composants obligatoires de l’artefact sont installés, mais pas les composants recommandés ni facultatifs. Vous pouvez contrôler plus de composants globalement en utilisant --includeRecommended et/ou --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). Pour plus d’informations, consultez la page ID de charge de travail et de composant. 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. 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 facultatifs pour toutes les charges de travail contenues dans la disposition. Les charges de travail sont spécifiées avec --add. |
--wait |
Facultatif : le processus attend la fin de l’installation pour retourner un code de sortie. wait est utile lors de l’automatisation des installations où il est nécessaire d’attendre la fin de l’installation pour gérer le code de retour de cette installation. Le paramètre --wait ne peut être passé que dans le bootstrapper ; l’installateur (setup.exe) ne le prend pas en charge. Il est utile lors de la mise à jour des dispositions. Vous trouverez d’autres exemples ici. |
--useLatestInstaller |
Facultatif: fonctionnalité héritée applicable uniquement aux programme d’amorçage 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 du Visual Studio Installer est incluse dans votre disposition, même si elle appartient à une version principale plus récente du produit. L’installateur le plus récent peut être utile si vous souhaitez profiter des nouvelles fonctionnalités ou des corrections de bogues disponibles dans sa dernière version. Pour plus d’informations, consultez la documentation Configurer la disposition pour toujours utiliser le dernier programme d’installation. |
--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 d’accès complet du fichier config. |
--noWeb |
Facultatif : s’il est présent, le programme d’installation de Visual Studio utilise les fichiers de votre répertoire de disposition pour installer Visual Studio et 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 un ordinateur client connecté à Internet de rechercher des mises à jour si le client est configuré pour rechercher des mises à jour sur les serveurs hébergés par Microsoft. Dans ce cas, --noWeb empêche simplement le client de télécharger les packages du produit. |
--verify |
Optionnel : vérification du contenu d’une disposition. Tous les fichiers endommagés ou manquants sont listés. |
--fix |
Optionnel : vérification du contenu d’une disposition. Si des fichiers sont corrompus ou manquants, ils sont retéléchargés. Un accès à Internet est obligatoire 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 : ID du canal pour l’instance à installer, par exemple VisualStudio.17.Release. channelId est requis pour la commande d’installation, et ignoré pour les autres commandes si --installPath est spécifié. Consultez les exemples de syntaxe de --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. Consultez les exemples de syntaxe de --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). Ce paramètre peut être utilisé pour la commande d’installation ; les 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é en même temps que --installChannelUri) est utilisé pour détecter les mises à jour. Ce paramètre peut être utilisé pour la commande d’installation ; les 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 supporter l’installation hors ligne, où la cache de disposition est créée avec le catalogue de produits déjà téléchargé. Ce paramètre peut être utilisé pour la commande d’installation ; les autres commandes l’ignorent. |
--productId <id> |
Facultatif : L’ID du produit pour l’instance qui est installée. Ce paramètre est pré-rempli dans des conditions d’installation normales. Le productID est quelque chose comme « Microsoft.VisualStudio.Product.Enterprise ». |
--arch all |
Optionnel : par défaut, les dispositions sont créées avec uniquement des fichiers binaires de produits 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 |
Optionnel : appliquez des modifications à la disposition sans mettre à jour la version du produit incluse dans la disposition. |
--locale <language-locale> |
Facultatif : permet de changer la langue d’affichage de l’interface utilisateur pour le programme d’installation proprement dit. Ce paramètre est conservé. Pour plus d’informations, consultez la section Liste des paramètres régionaux de langue de cette page. |
--cache |
Optionnel : 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, réparations ou modifications ultérieures. La stratégie par défaut consiste à mettre les packages en cache. Option ignorée pour la commande de désinstallation. Pour plus d’informations, consultez Désactiver ou déplacer le cache du package. |
--nocache |
Optionnel : le cas échéant, les packages sont supprimés après avoir été installés ou réparés. Ils seront à nouveau téléchargés uniquement si nécessaire et à nouveau supprimés après utilisation. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, réparations ou modifications ultérieures. La stratégie par défaut consiste à mettre les packages en cache. Option ignorée pour la commande de désinstallation. Pour plus d’informations, consultez Désactiver ou déplacer le cache du package. |
--noUpdateInstaller |
Optionnel : le cas échéant, empêche le programme d’installation de se mettre à jour quand le mode silencieux est spécifié. 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. |
--path <name>=<path> |
Optionnel : permet de spécifier des chemins d’installation personnalisés pour l’installation. Les noms de chemin pris en charge sont shared, cache et install. |
--path cache=<path> |
Optionnel : utilise l’emplacement que vous spécifiez pour télécharger les fichiers d’installation. Cet emplacement peut être défini uniquement pendant la première installation de Visual Studio. Exemple : --path cache="C:\VS\cache" |
--path shared=<path> |
Optionnel : contient des fichiers partagés pour les installations de Visual Studio côte à côte. 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. Exemple : --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. |
--path install=<path> |
Optionnel : équivaut à –-installPath. En particulier, les options --installPath "C:\VS" et --path install="C:\VS" sont équivalentes. Seule une 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 pour une instance donnée de Visual Studio en utilisant le programme d’installation ou le programme d’amorçage sur l’ordinateur client, puis en passant la commande modifySettings et la chaîne de mise à jour souhaitée.
| 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> |
Il est recommandé de l’utiliser pour spécifier l’instance de Visual Studio sur laquelle agir. |
--newChannelUri |
Obligatoire : URI du manifeste de chaîne. Cette valeur spécifie où se trouve l’emplacement source suivant les mises à jour. Consultez les exemples de syntaxe de --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 |
L’URI de l’ancien manifeste de chaîne. 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 sur laquelle agir. Le productID est quelque chose comme « Microsoft.VisualStudio.Product.Enterprise ». |
--includeRecommended |
Facultatif : lors d’une commande modifySettings, ce paramètre (qui doit être suivi du mot true ou false) indique au programme d’installation de Visual Studio de désactiver la fonctionnalité « ajouter des composants recommandés pour les charges de travail installées lors de la mise à jour » dans la boîte de dialogue Paramètres de mise à jour. |
--quiet |
Optionnel : ce paramètre empêche l’affichage d’une interface utilisateur pendant l’exécution de la commande. Non disponible pour une utilisation par programmation par utilisateurs standard. |
--removeOos true |
Optionnel : lors d’une commande d’installation modifySettings (qui doit avoir le mot true ou false immédiatement après) indique au programme d’installation de Visual Studio 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 assurer la sécurité de 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 restauration et paramètres de ligne de commande
À partir de Visual Studio 2022, vous pouvez annuler une mise à jour de manière programmée en utilisant le programme d'installation sur la machine cliente et en transmettant la commande d'annulation avec l'instance du chemin d'installation.
| Interface | Description |
|---|---|
rollback |
Commande permettant de restaurer une instance particulière de Visual Studio vers la mise à jour précédemment installée. Cette commande ne fonctionne pas si DisableRollback est activé. |
| paramètres de restauration | Description |
|---|---|
--installPath <dir> |
Il est recommandé de l’utiliser pour spécifier l’instance de Visual Studio sur laquelle agir. |
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 de l’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 administrateur sont exécutés par défaut dans le contexte « update », sauf si le verbe de disposition est spécifié.
| Paramètres de mise à jour de l’administrateur | Description |
|---|---|
--installerUpdateArgs [optional parameters] |
Ce paramètre fonctionne comme un « tableau intermédiaire » de paramètres spécifiques qui sont pertinents aux scénarios de mise à jour de l’administrateur. Les paramètres optionnels activés à cet effet sont les suivants : --quiet : il s’agit de l’expérience par défaut pour les mises à jour de l’administrateur et ce paramètre est répertorié ici à titre d’exhaustivité. --passive : Ce paramètre remplace le paramètre --quiet. Il entraîne l’affichage de l’interface utilisateur d’une manière non interactive. --norestart: ce paramètre doit être utilisé conjointement avec --quiet ou --passive et il entraîne 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 à se 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 de l’administrateur est exécutée dans le contexte utilisateur ; il est ignoré si la mise à jour de l’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 de l’administrateur et ce paramètre est répertorié ici à titre d’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 administrateur à partir du catalogue dans SCCM. Vous devrez peut-être également définir le délai d’expiration du package SCCM pour qu’il soit supérieur au délai de 10 minutes par défaut. La modification du type de déploiement SCCM sur Obligatoire rend ce paramètre inutile.--downloadThenInstall : ce paramètre force Visual Studio à télécharger tous les fichiers avant de les installer. Il s’exclut mutuellement du paramètre --installWhileDownloading. |
--checkPendingReboot |
La mise à jour est abandonnée en cas de redémarrage en attente sur l’ordinateur, quelle que soit l’application qui l’a provoqué. La valeur par défaut consiste à ne pas vérifier les redémarrages en attente. |
Exemple de syntaxe pour passer des paramètres dans une mise à jour administrateur :
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
Supprimer la commande de chaîne et les paramètres de ligne de commande
Les canaux à partir desquels les mises à jour sont effectuées sont mis en cache sur le client. Au fil du temps, ils peuvent devenir encombrants. 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 programmation des canaux (par exemple, d’anciens emplacements de disposition) à l’aide de la commande removeChannel. Vous pouvez exécuter vswhere par programmation sur l’ordinateur client pour déterminer les canaux mis en cache sur l’ordinateur client.
| Commande | Description |
|---|---|
removeChannel |
Commande permettant de supprimer une chaîne de l’ordinateur client. |
| paramètres removeChannel | Description |
|---|---|
--channelUri |
Obligatoire L’URI de l’ancien manifeste de chaîne. |
--quiet |
Optionnel Ce paramètre empêche l’affichage d’une interface utilisateur pendant l’exécution de la commande. |
--passive |
Optionnel Ce paramètre remplace le paramètre --quiet. Il entraîne l’affichage de l’interface utilisateur d’une 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 « winget » du Gestionnaire de package Windows pour installer ou mettre à jour Visual Studio par programmation sur vos machines avec d’autres packages managés par winget.
Par défaut, winget installe simplement la charge de travail de base de Visual Studio.
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 pendant l’installation initiale, vous pouvez utiliser le commutateur winget --override en même temps que la commande winget install, 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 des composants directement lors de l’installation initiale, comme ceci :
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 winget configure agit comme une opération « modify » de Visual Studio. Voir comment créer un fichier de configuration WinGet pour savoir comment 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 winget upgrade, car upgrade agit 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 winget pour ajouter des composants.
Veuillez noter que les opérations de Visual Studio Installer nécessitent actuellement des privilèges d’administrateur. Si nécessaire, winget vous invitera donc à élever vos privilèges pour terminer la commande. De plus, vous ne pouvez pas actuellement utiliser winget pour installer plusieurs éditions (c’est-à-dire différentes références SKU) ou plusieurs instances de la même référence SKU en même temps sur un ordinateur client. 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 de composant
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.
Liste des paramètres régionaux de langue
| Paramètres régionaux de langue | Langage |
|---|---|
| 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
En fonction du résultat de l’opération, la variable d’environnement %ERRORLEVEL% a l’une des valeurs suivantes :
| Valeur | Résultat |
|---|---|
| 0 | Opération effectuée avec succès |
| 740 | Élévation obligatoire |
| 1001 | Le processus du programme d’installation de Visual Studio est en cours d’exécution |
| 1003 | Visual Studio est en cours d’utilisation |
| 1602 | Opération annulée |
| 1618 | Autre installation en cours d’exécution |
| 1641 | Opération achevée avec succès, le redémarrage a été lancé |
| 3010 | Opération effectuée avec succès, mais l’installation nécessite un redémarrage avant de pouvoir être utilisée |
| 5003 | Le programme d’amorçage a échoué à télécharger le programme d’installation |
| 5004 | Opération annulée |
| 5005 | Erreur d’analyse de la ligne de commande du programme d’amorçage |
| 5007 | L’opération a été bloquée - l’ordinateur ne répond pas à la configuration requise |
| 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 par un processus externe) |
| Autres (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_client et dd_setup pour le programme d’amorçage, l’application du programme d’installation et le moteur d’installation, respectivement.
Support ou résolution des problèmes
Parfois, des problèmes peuvent se produire. 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.
Voici d’autres options de support :
- Nous offrons une option de support par chat sur les installations (en anglais uniquement) pour les problèmes liés à l’installation.
- Signalez-nous les problèmes au niveau d’un produit via l’outil Signaler un problème qui apparaît dans Visual Studio Installer et dans l’IDE Visual Studio. Si vous êtes administrateur informatique et que Visual Studio n’est pas installé, vous pouvez envoyer vos commentaires d’administrateur informatique ici.
- Suggérez une fonctionnalité, suivez les problèmes des produits et trouvez les réponses à vos questions dans la Communauté des développeurs Visual Studio.