Partager via

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

  • Article

Pour illustrer comment utiliser des paramètres de ligne de commande pour installer Visual Studio, voici plusieurs exemples que vous pouvez personnaliser pour répondre à vos besoins.

Dans chaque exemple, vs_enterprise.exe, vs_professional.exeet vs_community.exe représentent l’édition respective du programme d’amorçage visual Studio, qui est le petit fichier (~ 1 Mo) qui lance 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 également placer ces lignes ensemble sur une seule ligne. Dans PowerShell, l’équivalent est le caractère backtick (`).

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

Installer à l’aide de --installPath et --add avec le programme d’amorçage

  • Installez une instance minimale de Visual Studio, sans invite interactive, mais la progression s’affiche :

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

  • Installez une instance de bureau de Visual Studio silencieusement, avec le module linguistique français, en retournant uniquement lorsque le produit est installé.

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

Mettre à jour

  • Mettez à jour une instance de Visual Studio via la ligne de commande avec progression affichée et aucune invite interactive. Vous pouvez exécuter cette série de commandes en deux étapes à l’aide d’un programme de démarrage trouvé sur le client ou dans une configuration. 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 avec élévation de privilèges, car la mise à jour du programme d’installation 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. utilisateurs Standard, s’ils ont reçu des autorisations appropriées, 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 programme à partir du même répertoire 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 ou scripts par lots pour attendre la fin de la commande initiale avant l’exécution de la commande suivante. Pour les fichiers par lots, une variable d’environnement %ERRORLEVEL% contient la valeur de retour de la commande, comme indiqué dans la Utiliser les paramètres de ligne de commande pour installer Visual Studio page. Certains utilitaires de commande nécessitent d’autres paramètres pour attendre la fin et 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()
  • La première --wait est utilisée par le programme d’amorçage Visual Studio, et la deuxième -Wait est utilisée 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 une disposition qui inclut uniquement l’éditeur principal Visual Studio (la configuration visual Studio la plus minimale) et le module linguistique anglais. D’autres exemples de création de mise en page peuvent être trouvés sur 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 toutes les charges de travail et composants disponibles dans l’édition Visual Studio Enterprise :

    vs_enterprise.exe --all

Utilisation de --includeRecommended

  • Installez une deuxième instance de Visual Studio Professional avec un nom personnalisé sur un ordinateur où Visual Studio Community Edition est déjà installé, prenant en charge le 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. Le --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 et ce qu’ils signifient.

nom du canal --channelUri --channelId
Canal actuel Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Canal Visual Studio 2022 17.0 LTSC https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Canal Visual Studio 2022 Preview https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Canal de publication Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Canal de publication 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 instructions suivantes :

Utilisation de --remove

  • Supprimez le composant Outils de profilage de l’instance Visual Studio installée par défaut. Cet exemple utilise le programme d’installation déjà installé sur l’ordinateur client. utilisateurs Standard disposant d’autorisations appropriées peuvent exécuter la commande de modification par programmation à 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 programme à partir du même répertoire 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’une disposition.

Utilisation de --removeOos

À l’aide du dernier programme d’installation, vous pouvez modifier une installation et supprimer tous les composants qui ont passé à un état hors support à partir 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. utilisateurs Standard, s’ils ont reçu des autorisations appropriées, peuvent exécuter par programmation la commande modify à l’aide du programme d’installation, mais ils ne sont pas autorisés à utiliser le commutateur --passive ou --quiet. Vous ne pouvez pas lancer le programme d’installation à partir du même répertoire 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" ^
 --removeOos true ^
 --passive

  • Ajustez les paramètres de mise à jour pour supprimer définitivement tous les composants transférés vers un état hors support chaque fois que le produit est mis à jour :

    "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 d’installation, de cache et de partage :

    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 d’installation et de cache :

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

  • Utilisez uniquement les chemins d’installation et partagés :

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

  • Utilisez uniquement le chemin d’installation :

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

Utilisation d’export

  • Utilisez l’exportation 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 l’exportation pour enregistrer la 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 de configuration d’installation précédemment 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. utilisateurs Standard disposant d’autorisations appropriées peuvent exécuter la commande de modification par programmation à l’aide du programme d’installation, mais ils ne sont pas autorisés à utiliser le commutateur --passive ou --quiet. Vous ne pouvez pas lancer le programme d’installation à partir du même répertoire dans lequel réside le programme d’installation.

    "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’une disposition :

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

Utilisation de winget

Utilisez l’outil Gestionnaire de package Windows « winget » pour installer ou mettre à jour Visual Studio par programmation sur vos machines, ainsi que d’autres packages gérés par winget. Pour personnaliser l’installation et spécifier d’autres charges de travail et composants, vous pouvez utiliser le commutateur --override de winget en même temps que la commande install de winget et transmettre un fichier vsconfig exporté comme suit :

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 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 d'assistance de chat d'installation (anglais uniquement) 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