Exemples de paramètres de ligne de commande pour l’installation de Visual Studio

  • Article

Voici plusieurs exemples montrant comment utiliser les paramètres de ligne de commande pour installer Visual Studio. Vous pouvez les personnaliser en fonction de vos besoins.

Dans chaque exemple, vs_enterprise.exe, vs_professional.exe, et vs_community.exe représentent respectivement l’édition du bootstrapper de Visual Studio, qui est le petit fichier (~ 1 Mo) qui initie le processus de téléchargement. Si vous utilisez une autre édition, remplacez par le nom approprié du programme d’amorçage.

Toutes les commandes nécessitent une élévation administrative. Une invite du Contrôle de compte d’utilisateur s’affiche si le processus n’est pas démarré à partir d’une invite avec élévation de privilèges.

Vous pouvez utiliser le caractère ^ à la fin d’une ligne de commande pour concaténer plusieurs lignes en une seule commande. Vous pouvez aussi regrouper ces lignes sur une seule ligne. Dans PowerShell, le caractère équivalent est l’accent grave (`).

Pour obtenir la liste des charges de travail et des composants que vous pouvez installer à l’aide de la ligne de commande, consultez la page ID de composants et de charges de travail de Visual Studio.

Installer à l’aide de --installPath à côté du programme d’amorçage

  • Installez une instance minimale de Visual Studio, sans invites interactives, mais avec l’affichage de la progression :

    vs_enterprise.exe --installPath C:\minVS ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
--passive --norestart

  • Installez une instance de bureau de Visual Studio en mode silencieux, avec le module linguistique français, avec un retour uniquement une fois le produit installé.

    vs_enterprise.exe --installPath C:\desktopVS ^
--addProductLang fr-FR ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended --quiet --wait

Update

  • Mettez à jour une instance Visual Studio en utilisant la ligne de commande avec affichage de la progression, mais sans invite interactive. Vous pouvez exécuter ces séries de commandes en deux étapes à l’aide d’un programme d’amorçage qui se trouve sur le client ou dans un layout. La première commande met à jour le programme d’installation sur le client et la deuxième commande met à jour le produit Visual Studio. Vous devez exécuter ces commandes dans une invite de commandes élevée, car la mise à jour de l’installateur nécessite des autorisations d’administrateur. L’exemple suivant simule la mise à jour d’un client à l’aide d’un programme d’amorçage persistant du layout.

    \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
\\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"

Vous pouvez également mettre à jour votre instance Visual Studio en une seule étape à l’aide du programme d’installation sur le client. Les utilisateurs Standard qui ont reçu l’autorisation appropriée peuvent exécuter par programme la commande de mise à jour à l’aide du programme d’installation, mais ils ne sont pas autorisés à utiliser le commutateur --passive ou --quiet. Notez que vous ne pouvez pas lancer le programme d’installation par programmation à partir du même répertoire que celui dans lequel réside le programme d’installation.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Utilisation de --wait

  • Utilisez --wait dans les fichiers de commandes ou les scripts pour attendre que la commande initiale se termine avant d’exécuter la commande suivante. Pour les fichiers de commandes, une variable d’environnement %ERRORLEVEL% contient la valeur de retour de la commande, comme indiqué dans la page Utiliser les paramètres de ligne de commande pour installer Visual Studio. Certains utilitaires de commande nécessitent d’autres paramètres pour attendre la fin et pour obtenir la valeur de retour du programme d’installation.

Le paramètre --wait est uniquement pris en charge par le programme d’amorçage.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

La commande suivante est un exemple d’utilisation de --wait avec la commande de script PowerShell Start-Process :

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode

ou

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()
  • Le premier paramètre --wait est utilisé par le programme d’amorçage Visual Studio, tandis que le second paramètre -Wait est utilisé par « Start-Process » pour attendre la fin. Le paramètre -PassThru est utilisé par Start-Process pour utiliser le code de sortie du programme d’installation pour sa valeur de retour.

Utilisation de --layout pour créer une disposition réseau ou un cache local

  • Créez un layout qui comprend uniquement l’éditeur de base de Visual Studio (configuration Visual Studio la plus minime) et le module linguistique anglais. Vous trouverez d’autres exemples de création de layout dans la page Créer une installation réseau de Visual Studio.

    vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^

Utilisation de --all pour acquérir l’intégralité du produit

  • Démarrez une installation interactive de l’ensemble des charges de travail et composants disponibles dans Visual Studio Enterprise Edition :

    vs_enterprise.exe --all

Utilisation de --includeRecommended

  • Installez une deuxième instance de Visual Studio Professional en utilisant un surnom sur une machine où l’édition Visual Studio Community est déjà installée, avec prise en charge du développement Node.js :

    vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode

Utilisation de --channelURI

L’utilisation du dernier programme d’installation permet de configurer l’emplacement où Visual Studio recherche les mises à jour. --channelUri est également appelé canal de mise à jour ou emplacement source des mises à jour. Le tableau suivant donne des exemples de valeurs pour channelId et channelUri avec leur signification.

Nom du canal --channelUri --channelId
Canal actuel Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Canal LTSC Visual Studio 2022 17.0 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Canal de préversion Visual Studio 2022 https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Canal de version Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Canal de version Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Disposition personnalisée - Canal privé \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (ou tout élément sur lequel le layout est basé)

Si vous choisissez d’utiliser une disposition personnalisée comme canal de mise à jour, tenez compte des directives suivantes :

Utilisation de --remove

  • Supprimez le composant Outils de profilage de l’instance de Visual Studio installée par défaut. Cet exemple utilise le programme d’installation déjà installé sur l’ordinateur client. Les utilisateurs standard avec les permissions appropriées peuvent exécuter de manière programmatique la commande de modification en utilisant l’installateur, mais ils ne sont pas autorisés à utiliser les commutateurs --passive ou --quiet. Notez que vous ne pouvez pas lancer le programme d’installation par programmation à partir du même répertoire que celui dans lequel réside le programme d’installation.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

Vous ne pouvez pas utiliser --remove dans la même commande que --layout. En d’autres termes, il n’est pas possible de supprimer des composants d’un layout.

Utilisation de --removeOos

Avec le dernier programme d’installation, vous pouvez modifier une installation et supprimer tous les composants qui sont passés à un état hors support de l’instance Visual Studio installée par défaut. Cet exemple utilise le programme d’installation déjà installé sur l’ordinateur client pour configurer le paramètre removeOos. Les utilisateurs Standard qui ont reçu l’autorisation appropriée peuvent exécuter par programme la commande de modification à l’aide du programme d’installation, mais ils ne sont pas autorisés à utiliser le commutateur --passive ou --quiet. Vous ne pouvez pas initier l’installateur de manière programmatique à partir du même répertoire où réside l’installateur.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

  • Ajustez les paramètres de mise à jour pour supprimer de manière persistante tous les composants qui ont basculé dans un état hors support à chaque mise à jour du produit :

    "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--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

Utilisation de --path

Tous ces exemples supposent que vous installez un nouveau produit à l’aide d’un programme d’amorçage.

  • Utilisez les chemins install, cache et shared :

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

  • Utilisez uniquement les chemins install et cache :

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

  • Utilisez uniquement les chemins install et shared :

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

  • Utilisez uniquement le chemin install :

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Utilisation d’export

  • Utilisez Exporter pour enregistrer la sélection à partir d’une installation. Cet exemple utilise le programme d’installation déjà installé sur l’ordinateur client.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"

  • Utilisez Exporter pour enregistrer une sélection personnalisée à partir de zéro. Cet exemple utilise le programme d’installation déjà installé sur l’ordinateur client.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"

Utilisation de --config

  • Utilisez --config pour installer les charges de travail et les composants à partir d’un fichier config d’installation déjà enregistré :

    vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"

  • Utilisez --config pour ajouter des charges de travail et des composants à une installation existante. Cet exemple utilise le programme d’installation déjà installé sur l’ordinateur client. Les utilisateurs standard avec les permissions appropriées peuvent exécuter de manière programmatique la commande de modification en utilisant l’installateur, mais ils ne sont pas autorisés à utiliser les commutateurs --passive ou --quiet. Vous ne pouvez pas initier l’installateur de manière programmatique à partir du même répertoire où réside l’installateur.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"

  • Utilisez --config pour configurer le contenu d’un layout :

    vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"

Utilisation de winget

Utilisez 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. Pour personnaliser l’installation et spécifier d’autres workloads et composants, vous pouvez utiliser l’option --override de winget aux côtés de la commande install de winget, et transmettre un fichier vsconfig exporté de cette manière :

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

Vous pouvez également utiliser winget configure et transmettre un fichier .yaml pour modifier une installation existante de Visual Studio. Cette approche utilise le fournisseur DSC Visual Studio PowerShell décrit ici.

Support et 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 :

Contenu connexe