Commutateurs de la ligne de commande devenvDevenv command line switches

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

Note

Pour les tâches liées à la génération, nous vous recommandons d’utiliser MSBuild au lieu de devenv.For build-related tasks, it is 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.

Syntaxe des commutateurs devenvDevenv switch syntax

Par défaut, les commandes devenv passent des commutateurs à l’utilitaire devenv.com.By default, devenv commands pass switches to the devenv.com utility. L’utilitaire devenv.com fournit ses sorties via des flux système standard, comme stdout et stderr.The devenv.com utility 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.

En revanche, les commandes qui commencent par devenv.exe peuvent utiliser les mêmes commutateurs, mais l’utilitaire devenv.com est alors ignoré.On the other hand, commands that begin with devenv.exe can use the same switches, but the devenv.com utility is bypassed.

Les règles de syntaxe pour les commutateurs devenv ressemblent à celles d’autres utilitaires de ligne de commande DOS.The syntax rules for devenv switches resemble those 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 are not case-sensitive.

  • 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 pas une solution ou un projet, ce fichier s’ouvre dans l’éditeur approprié, dans une nouvelle instance de l’IDE.If the first argument is a file that is 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 /build myproject1.vbproj recherche le dossier parent d’un fichier solution nommé « myproject1.sln ».For example, the command devenv /build myproject1.vbproj searches the parent folder for a solution file that is 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’IDE et produit toutes les informations de journal de la 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.

  • Vous ne pouvez pas utiliser la syntaxe des critères spéciaux dans les commandes devenv.You cannot use pattern-matching syntax in devenv commands.

Commutateurs de devenvDevenv switches

Les commutateurs de ligne de commande suivants affichent l’IDE et effectuent la tâche décrite.The following command-line switches display the IDE and perform 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.
/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 is not 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.
/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 is not included in your installation of Visual Studio, this setting is ignored.
/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.
/Run ou /r/Run or /r Compile et exécute la solution spécifiée.Compiles and runs the specified solution.
/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.
/UseEnv/UseEnv Force l’IDE à utiliser les variables d’environnement PATH, INCLUDE et LIB pour la compilation de C++, au lieu des paramètres spécifiés dans la section Répertoires VC ++ des options de Projets dans la boîte de dialogue Options.Causes the IDE to use PATH, INCLUDE, and LIB environment variables for C++ compilation, instead of the settings specified in the VC++ Directories section of Projects options in the Options dialog box. 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.
/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.
/SafeMode/SafeMode Démarre Visual Studio en mode sans échec, et charge seulement l’environnement et les services par défaut ainsi que les versions commercialisées des packages tiers.Starts Visual Studio in safe mode, and loads only the default environment and services, and shipped versions of third-party packages.
/ResetSkipPkgs/ResetSkipPkgs Efface toutes les balises SkipLoading qui ont été ajoutées aux packages Visual Studio par les utilisateurs voulant éviter de charger les Packages Visual Studio défectueux.Clears all SkipLoading tags that have been added to VSPackages by users who want to avoid loading problem VSPackages.
/Setup/Setup Force Visual Studio à fusionner les métadonnées de ressources qui décrivent les menus, les barres d’outils et les groupes de commandes de tous les packages Visual Studio disponibles.Forces Visual Studio to merge resource metadata that describes menus, toolbars, and command groups, from all VSPackages available. Vous devez exécuter cette commande en tant qu’administrateur.You must run this command as an administrator.

Les commutateurs de ligne de commande suivants n’affichent pas l’IDE.The following command-line switches do not 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.

Devenv /?Devenv /?
/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 myproj.csproj /buildDevenv myproj.csproj /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 myproj.csproj /cleanDevenv myproj.csproj /clean
/Deploy/Deploy Génère la solution, ainsi que les fichiers nécessaires pour le déploiement, en fonction de la configuration des solutions.Builds the solution, along with files necessary for deployment, according to the solutions configuration.

Devenv myproj.csproj /deployDevenv myproj.csproj /deploy
/Diff/Diff Compare deux fichiers.Compares two files. Prend quatre paramètres : SourceFile, TargetFile, SourceDisplayName (facultatif) et TargetDisplayName (facultatif).Takes four parameters: SourceFile, TargetFile, SourceDisplayName (optional), TargetDisplayName (optional).
/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 myproj.csproj /build /out log.txtDevenv myproj.csproj /build /out log.txt
/Project/Project Projet à générer, nettoyer ou déployer.The project to build, clean, or deploy. Vous pouvez utiliser ce commutateur uniquement si vous avez également spécifié le commutateur /build, /rebuild, /clean ou /deploy.You can use this switch only if you have also supplied the /build, /rebuild, /clean, or /deploy switch.
/ProjectConfig/ProjectConfig Spécifie la configuration de projet à générer ou déployer.Specifies the project configuration to build or deploy. Vous pouvez utiliser ce commutateur uniquement si vous avez également spécifié le commutateur /project.You can use this switch only if you have also supplied the /project switch.
/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.
/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.
/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.

Voir aussiSee also