Commutateurs de ligne de commande DevenvDevenv command-line switches

Devenv permet de définir différentes options pour l’environnement IDE et de générer, déboguer et déployer des projets en ligne de commande.Devenv lets you set various options for the IDE, build projects, debug projects, and deploy projects from the command line. Utilisez ces commutateurs pour exécuter l’environnement IDE à partir d’un script ou d’un fichier .bat (par exemple, un script de build nocturne) ou pour le lancer dans une configuration particulière.Use these switches to run the IDE from a script or a .bat file (such as a nightly build script), or to start the IDE in a particular configuration.

Note

Pour les tâches de build, nous recommandons d’utiliser MSBuild plutôt que devenv.For build-related tasks, it's recommended that you use MSBuild instead of devenv. Pour plus d’informations, consultez Informations de référence sur la ligne de commande MSBuild.For more information, see MSBuild command-line reference.

Pour plus d’informations sur les commutateurs liés au développement VSPackage, voir aussi Commutateurs de ligne de commande devenv pour le développement VSPackage.For information about switches that are related to VSPackage development, also see Devenv command-line switches for VSPackage development.

Syntaxe des commutateurs devenvDevenv switch syntax

Les commandes qui commencent par devenv sont gérées par l’utilitaire devenv.com, qui fournit ses sorties via des flux système standard, tels que stdout et stderr.Commands that begin with devenv are handled by the devenv.com utility, which delivers output through standard system streams, such as stdout and stderr. L’utilitaire détermine la redirection d’E/S appropriée lors de la capture de la sortie, par exemple dans un fichier .txt.The utility determines the appropriate I/O redirection when it captures output, for example to a .txt file.

Les commandes qui commencent par devenv.exe peuvent utiliser les mêmes commutateurs, mais l’utilitaire devenv.com est alors ignoré.Alternatively, commands that begin with devenv.exe can use the same switches, but the devenv.com utility is bypassed. L’utilisation de devenv.exe empêche l’affichage direct de la sortie sur la console.Using devenv.exe directly prevents output from appearing on the console.

Les règles syntaxiques des commutateurs devenv ressemblent à celles d’autres utilitaires de ligne de commande DOS.The syntax rules for devenv switches resemble the rules for other DOS command-line utilities. Les règles de syntaxe suivantes s’appliquent à tous les commutateurs devenv et leurs arguments :The following syntax rules apply to all devenv switches and their arguments:

  • Les commandes commencent par devenv.Commands begin with devenv.

  • Les commutateurs ne respectent pas la casse.Switches aren't case-sensitive.

  • Pour spécifier un commutateur, on utilise un trait d’union («- ») ou une barre oblique (« / »).You can specify a switch by using a hyphen ("-") or a forward slash ("/").

  • Quand vous spécifiez une solution ou un projet, le premier argument est le nom du fichier solution ou projet, y compris le chemin du fichier.When specifying a solution or project, the first argument is the name of the solution file or project file, including file path.

  • Si le premier argument est un fichier qui n’est ni une solution ni un projet, ce fichier s’ouvre dans l’éditeur adapté, dans une nouvelle instance de l’environnement IDE.If the first argument is a file that's not a solution or project, that file opens in the appropriate editor, in a new instance of the IDE.

  • Quand vous fournissez un nom de fichier projet au lieu d’un nom de fichier solution, une commande devenv recherche le dossier parent du fichier projet pour un fichier solution du même nom.When you supply a project file name instead of a solution file name, a devenv command searches the parent folder of the project file for a solution file that has the same name. Par exemple, la commande devenv myproject1.vbproj /build recherche le dossier parent d’un fichier solution nommé myproject1.sln.For example, the command devenv myproject1.vbproj /build searches the parent folder for a solution file that's named myproject1.sln.

    Note

    Un seul fichier solution référençant ce projet doit se trouver dans son dossier parent.One and only one solution file that references this project should be located in its parent folder. Si le dossier parent ne contient aucun fichier solution référençant ce projet, ou si le dossier parent contient deux fichiers solution ou plus qui le référencent, un fichier solution temporaire est créé.If the parent folder contains no solution file that references this project, or if the parent folder contains two or more solution files that reference it, then a temporary solution file is created.

  • Quand les chemins et les noms de fichier comportent des espaces, vous devez les placer entre des guillemets doubles ("").When file paths and file names include spaces, you must enclose them in quotation marks (""). Par exemple, "c:\project a\".For example, "c:\project a\".

  • Insérez un espace entre les commutateurs et les arguments de la même ligne.Insert one space character between switches and arguments on the same line. Par exemple, la commande devenv /log output.txt ouvre l’environnement IDE et écrit toutes les informations de journal de cette session dans le fichier output.txt.For example, the command devenv /log output.txt opens the IDE and outputs all log information for that session to output.txt.

  • Il n’est pas possible d’utiliser une syntaxe de type critères spéciaux dans les commandes devenv.You can't use pattern-matching syntax in devenv commands.

Commutateurs de devenvDevenv switches

Les commutateurs de ligne de commande suivants affichent l’environnement IDE et effectuent la tâche décrite.The following command-line switches display the IDE and do the described task.

Commutateur de ligne de commandeCommand line switch DescriptionDescription
/Command/Command Démarre l’IDE et exécute la commande spécifiée.Starts the IDE and executes the specified command.

devenv /command "nav https://docs.microsoft.com/"
/DebugExe/DebugExe Charge un exécutable C++ sous le contrôle du débogueur.Loads a C++ executable under the control of the debugger. Ce commutateur n’est pas disponible pour les exécutables Visual Basic ou C#.This switch isn't available for Visual Basic or C# executables. Pour plus d’informations, consultez Démarrer automatiquement un processus dans le débogueur.For more information, see Automatically start a process in the debugger.

devenv /debugexe mysln.exe
/Diff/Diff Compare deux fichiers.Compares two files. Accepte quatre paramètres : SourceFile, TargetFile, SourceDisplayName (facultatif) et TargetDisplayName (facultatif).Takes four parameters: SourceFile, TargetFile, SourceDisplayName (optional), and TargetDisplayName (optional).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects/DoNotLoadProjects Ouvre la solution spécifiée sans charger de projets.Opens the specified solution without loading any projects.

devenv /donotloadprojects mysln.sln
/Edit/Edit Ouvre les fichiers spécifiés dans une instance en cours d’exécution de cette application.Opens the specified files in a running instance of this application. S’il n’existe aucune instance en cours d’exécution, il démarre une nouvelle instance avec une disposition de fenêtre simplifiée.If there are no running instances, it starts a new instance with a simplified window layout.

devenv /edit File1 File2
/LCID ou /L/LCID or /L Spécifie la langue par défaut pour l’IDE.Sets the default language for the IDE. Si la langue spécifiée n’est pas incluse dans votre installation de Visual Studio, ce paramètre est ignoré.If the specified language isn't included in your installation of Visual Studio, this setting is ignored.

devenv /l 1033
/Log/Log Démarre Visual Studio et enregistre toute l’activité dans le fichier journal.Starts Visual Studio and logs all activity to the log file.

devenv /log mylogfile.xml
/NoSplash/NoSplash Ouvre l’environnement IDE sans afficher l’écran de démarrage.Opens the IDE without showing the splash screen.

devenv /nosplash File1 File2
/Run ou /R/Run or /R Compile et exécute la solution spécifiée.Compiles and runs the specified solution.

devenv /run mysln.sln
/RunExit/RunExit Compile et exécute la solution spécifiée, réduit l’IDE pendant l’exécution de la solution et ferme l’IDE une fois la solution exécutée.Compiles and runs the specified solution, minimizes the IDE when the solution is run, and closes the IDE after the solution has finished running.

devenv /runexit mysln.sln
/SafeMode/SafeMode Lance Visual Studio en mode sans échec.Starts Visual Studio in safe mode. Ce commutateur charge uniquement l’environnement par défaut, les services par défaut et les versions commercialisées des packages tiers.This switch loads only the default environment, the default services, and the shipped versions of third-party packages.

Ce commutateur ne prend aucun argument.This switch takes no arguments.
/UseEnv/UseEnv Force l’environnement IDE à utiliser les variables d’environnement PATH, INCLUDE, LIBPATH et LIB pour la compilation C++.Causes the IDE to use PATH, INCLUDE, LIBPATH, and LIB environment variables for C++ compilation. Ce commutateur est installé avec la charge de travail Développement Desktop avec C++.This switch is installed with the Desktop development with C++ workload. Pour plus d’informations, consultez Définition du chemin d’accès et des variables d’environnement pour les générations sur la ligne de commande.For more information, see Setting the Path and Environment Variables for Command-Line Builds.

Les commutateurs de ligne de commande suivants n’affichent pas l’environnement IDE.The following command-line switches don't display the IDE.

Commutateur de ligne de commandeCommand line switch DescriptionDescription
/?/? Affiche l’aide des commutateurs devenv dans la fenêtre d’invite de commandes.Displays help for devenv switches in the Command Prompt window.

Ce commutateur ne prend aucun argument.This switch takes no arguments.
/Build/Build Génère la solution ou le projet spécifié en fonction de la configuration de la solution indiquée.Builds the specified solution or project according to the configuration of the specified solution.

devenv mysln.sln /build
/Clean/Clean Supprime tous les fichiers créés par la commande build, sans affecter les fichiers sources.Deletes any files created by the build command, without affecting source files.

devenv mysln.sln /clean
/Deploy/Deploy Génère la solution, ainsi que les fichiers nécessaires au déploiement, en fonction de la configuration de la solution.Builds the solution, along with files necessary for deployment, according to the solution's configuration.

devenv mysln.sln /deploy
/Out/Out Permet de spécifier un fichier pour recevoir les erreurs pendant la génération.Lets you specify a file to receive errors when you build.

devenv mysln.sln /build Debug /out log.txt
/Project/Project Projet à générer, nettoyer ou déployer.The project to build, clean, or deploy. Ce commutateur n’est utilisable que si le commutateur /Build, /Rebuild, /Clean ou /Deploy est également indiqué.You can use this switch only if you've also supplied the /Build, /Rebuild, /Clean, or /Deploy switch.

devenv mysln.sln /build Debug /project proj1
/ProjectConfig/ProjectConfig Spécifie la configuration de projet à générer ou déployer.Specifies the project configuration to build or deploy. Ce commutateur n’est utilisable que si le commutateur /Project est également indiqué.You can use this switch only if you've also supplied the /Project switch.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild/Rebuild Efface, puis génère la solution ou le projet spécifié en fonction de la configuration de la solution indiquée.Cleans and then builds the specified solution or project according to the configuration of the specified solution.

devenv mysln.sln /rebuild
/ResetSettings/ResetSettings Restaure les paramètres par défaut de Visual Studio.Restores Visual Studio default settings. Éventuellement, réinitialise les paramètres dans le fichier .vssettings spécifié.Optionally resets the settings to the specified .vssettings file.

devenv /resetsettings mysettings.vssettings
/Upgrade/Upgrade Met à niveau le fichier solution spécifié et tous ses fichiers projet, ou le fichier projet spécifié, avec les formats Visual Studio actuels pour ces fichiers.Upgrades the specified solution file and all its project files, or the specified project file, to the current Visual Studio formats for these files.

devenv mysln.sln /upgrade

Voir aussiSee also