Modificadores de línea de comandos para Devenv

  • Artículo

Devenv le permite establecer varias opciones para el IDE, la compilación de proyectos, la depuración de proyectos y la implementación de proyectos desde la línea de comandos. Use estos modificadores para ejecutar el IDE desde un script o un archivo .bat (por ejemplo, la versión de desarrollo de un script) o para iniciar el IDE con una configuración determinada.

Nota

Para las tareas relacionadas con la compilación, le recomendamos usar MSBuild en lugar de devenv. Para obtener más información, vea Referencia de la línea de comandos de MSBuild.

Para obtener información acerca de los modificadores destinados principalmente al desarrollo de extensiones de Visual Studio, consulte también Modificadores de línea de comandos de Devenv para el desarrollo de VSPackage.

Sintaxis de los modificadores de Devenv

La utilidad devenv.com controla los comandos que comienzan por devenv, que ofrece salida a través de secuencias del sistema estándar, como stdout y stderr. La utilidad determina la redirección de E/S adecuada al capturar el resultado, por ejemplo a un archivo .txt.

Por otro lado, los comandos que empiezan por devenv.exe pueden usar los mismos modificadores, pero se omite la utilidad devenv.com. El uso de devenv.exe directamente impide que la salida aparezca en la consola.

Las reglas de sintaxis de los modificadores de devenv son similares a las de otras utilidades de la línea de comandos de DOS. Las siguientes reglas sintácticas se aplican a todos los modificadores de devenv y sus argumentos:

  • Los comandos comienzan por devenv.

  • Los modificadores no distinguen mayúsculas de minúsculas.

  • Puede especificar un modificador con un guion ("-") o una barra diagonal ("/").

  • Cuando se especifica una solución o un proyecto, el primer argumento es el nombre del archivo de solución o del archivo de proyecto, incluida la ruta de acceso del archivo.

  • Si el primer argumento es un archivo que no es una solución ni un proyecto, el archivo se abrirá en el editor adecuado, en una instancia nueva del IDE.

  • Cuando se indica un nombre de archivo de proyecto en lugar de un nombre de archivo de solución, un comando devenv busca en la carpeta primaria del archivo de proyecto un archivo de solución que tenga el mismo nombre. Por ejemplo, el comando devenv myproject1.vbproj /build busca en la carpeta principal un archivo de solución denominado myproject1.sln.

    Nota

    En su carpeta primaria debe haber un archivo de solución, y solamente uno, que haga referencia a este proyecto. Si la carpeta primaria no contiene ningún archivo de solución que haga referencia a este proyecto, o si contiene dos o más archivos de solución que hagan referencia a él, se crea un archivo de solución temporal.

  • Si las rutas de acceso y los nombres de archivo contienen espacios en blanco, se deben incluir entre comillas dobles (""). Por ejemplo: "c:\project a\".

  • Inserte un carácter de espacio entre los modificadores y los argumentos de la misma línea. Por ejemplo, el comando devenv /log output.txt abre el IDE y envía toda la información de registro de esa sesión a output.txt.

  • No se puede usar la sintaxis de coincidencia de patrones en los comandos de devenv.

Modificadores de devenv

Los siguientes modificadores de línea de comandos muestran el IDE y realizan la tarea descrita.

Modificador de la línea de comandos Descripción
/Command Inicia el IDE y ejecuta el comando especificado.

devenv /command "nav https://learn.microsoft.com/"
/DebugExe Carga un archivo ejecutable de C++ bajo el control del depurador. Este modificador no está disponible para los archivos ejecutables de Visual Basic o C#. Para obtener más información, vea Iniciar automáticamente un proceso en el depurador.

devenv /debugexe mysln.exe
/Diff Compara dos archivos. Toma cuatro parámetros: SourceFile, TargetFile, SourceDisplayName (opcional) y TargetDisplayName (opcional).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects Abre la solución especificada sin cargar ningún proyecto.

devenv /donotloadprojects mysln.sln
/Edit Abre los archivos especificados en una instancia en ejecución de esta aplicación. Si no hay ninguna instancia en ejecución, inicia una instancia nueva con un diseño de ventanas simplificado.

devenv /edit File1 File2
/LCID o /L Establece el idioma predeterminado del IDE. Si el idioma especificado no se incluye en la instalación de Visual Studio, se omitirá este valor.

devenv /l 1033
/Log Inicia Visual Studio y registra toda la actividad en el archivo de registro.

devenv /log mylogfile.xml
/NoScale Abre el IDE en un modo deshabilitado por PPP que permite un diseño más preciso en el diseñador de Windows Forms.
/NoSplash Abre el IDE sin mostrar la pantalla de presentación.

devenv /nosplash File1 File2
/ResetSettings Restaura la configuración predeterminada de Visual Studio. Opcionalmente, restablece la configuración del archivo .vssettings especificado.

devenv /resetsettings mysettings.vssettings
/Run o /R Compila y ejecuta la solución especificada.

devenv /run mysln.sln
/RunExit Compila y ejecuta la solución especificada, minimiza el IDE cuando se ejecuta la solución y cierra el IDE una vez finalizada la ejecución de la solución.

devenv /runexit mysln.sln
/SafeMode Inicia Visual Studio en modo seguro. Este modificador carga únicamente el entorno predeterminado, los servicios predeterminados y las versiones publicadas de paquetes de terceros.

Este modificador no toma ningún argumento.
/TfsLink Abre Team Explorer e inicia un visor para el URI de artefacto proporcionado si se registra uno.
/UseEnv Hace que el IDE use las variables de entorno PATH, INCLUDE, LIBPATH y LIB para la compilación de C++. Este modificador se instala con la carga de trabajo Desarrollo para el escritorio con C++ . Para obtener más información, vea Establecer la ruta de acceso y las variables de entorno para compilar desde la línea de comandos.

Los siguientes modificadores de línea de comandos no muestran el IDE.

Modificador de la línea de comandos Descripción
/? Muestra la ayuda para los modificadores de devenv en la ventana del símbolo del sistema.

Este modificador no toma ningún argumento.
/Build Compila la solución o el proyecto especificado según la configuración de la solución especificada.

devenv mysln.sln /build
/Clean Elimina los archivos creado por el comando de compilación, sin afectar a los archivos de código fuente.

devenv mysln.sln /clean
/Deploy Compila la solución con los archivos necesarios para la implementación, según la configuración de la solución.

devenv mysln.sln /deploy
/Out Permite especificar un archivo para recibir los errores al compilar.

devenv mysln.sln /build Debug /out log.txt
/Project Proyecto que se va a compilar, limpiar o implementar. Puede usar este modificador únicamente si también ha especificado el modificador /Build, /Rebuild, /Clean o /Deploy.

devenv mysln.sln /build Debug /project proj1
/ProjectConfig Especifica la configuración de proyecto que se va a compilar o implementar. Puede usar este modificador únicamente si también ha especificado el modificador /Project.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild Limpia y, a continuación, compila la solución o el proyecto especificado según la configuración de la solución especificada.

devenv mysln.sln /rebuild
/Setup Obliga a Visual Studio a combinar metadatos de recursos que describen menús, barras de herramientas y grupos de comandos de todos los VSPackages disponibles. Solo debe ejecutar este comando como administrador.
/Upgrade Actualiza el archivo de solución especificado y todos sus archivos de proyecto, o bien el archivo de proyecto especificado, a los formatos actuales de Visual Studio para estos archivos.

devenv mysln.sln /upgrade

Vea también