Devenv-Befehlszeilenparameter

  • Artikel

Mit Devenv können Sie über die Befehlszeile verschiedene Optionen für die IDE festlegen und Projekte erstellen, debuggen und bereitstellen. Verwenden Sie diese Schalter, um die IDE aus einem Skript oder einer BAT-Datei auszuführen (z.B. einem über Nacht ausgeführten Buildskript) oder um die IDE in einer bestimmten Konfiguration zu starten.

Hinweis

Für buildbezogene Tasks wird empfohlen, dass Sie MSBuild anstelle von Devenv verwenden. Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz.

Informationen zu Schaltern, die hauptsächlich für die Entwicklung von Visual Studio-Erweiterungen vorgesehen sind, finden Sie auch unter Devenv-Befehlszeilenschalter für die VSPackage-Entwicklung.

Syntax des Devenv-Schalters

Befehle, die mit devenv beginnen, werden vom Hilfsprogramm devenv.com verarbeitet. Die Ausgabe wird über die Standardstreams des Systems (z.B. stdout und stderr) bereitgestellt. Das Hilfsprogramm bestimmt die entsprechende E/A-Umleitung, wenn es die Ausgabe beispielsweise in einer TXT-Datei erfasst.

Alternativ können Befehle, die mit devenv.exe beginnen, dieselben Schalter verwenden, das Hilfsprogramm devenv.com wird jedoch umgangen. Wenn Sie devenv.exe direkt verwenden, wird verhindert, dass die Ausgabe in der Konsole angezeigt wird.

Die Syntaxregeln für devenv-Schalter ähneln den Regeln für andere DOS-Befehlszeilenhilfsprogramme. Die folgenden Syntaxregeln gelten für alle devenv-Schalter und ihre Argumente:

  • Befehle beginnen mit devenv.

  • Die Groß-/Kleinschreibung wird bei Schaltern nicht beachtet.

  • Sie können einen Schalter mit einem Bindestrich („-“) oder einem Schrägstrich („/“) angeben.

  • Bei Angabe einer Projektmappe oder eines Projekts ist das erste Argument der Name der Projektmappendatei oder der Projektdatei, einschließlich Dateipfad.

  • Wenn das erste Argument eine Datei ist, die keine Projektmappe bzw. kein Projekt ist, wird die Datei im entsprechenden Editor in einer neuen Instanz der IDE geöffnet.

  • Wenn Sie anstelle des Namens einer Projektmappendatei den einer Projektdatei angeben, wird der übergeordnete Ordner der Projektdatei von einem devenv-Befehl nach einer Projektmappendatei mit demselben Namen durchsucht. Beispielsweise durchsucht der Befehl devenv myproject1.vbproj /build den übergeordneten Ordner nach einer Projektmappendatei mit dem Namen myproject1.sln.

    Hinweis

    In diesem übergeordneten Ordner darf genau eine Projektmappendatei enthalten sein, die auf dieses Projekt verweist. Wenn der übergeordnete Ordner keine oder zwei bzw. mehr Projektmappendateien enthält, die auf das Projekt verweisen, wird in diesem Ordner eine temporäre Projektmappendatei erstellt.

  • Dateipfade und Dateinamen, die Leerzeichen enthalten, müssen in Anführungszeichen ("") eingeschlossen werden. Beispielsweise "c:\project a\".

  • Fügen Sie zwischen Schaltern und Argumenten auf der gleichen Zeile ein Leerzeichen ein. Der Befehl devenv /log output.txt öffnet z. B. die IDE und gibt alle Protokollinformationen für diese Sitzung in output.txt aus.

  • In devenv-Befehlen kann keine Syntax zum Mustervergleich verwendet werden.

Devenv-Schalter

Die folgenden Befehlszeilenschalter zeigen die IDE an und führen die beschriebene Aufgabe aus.

Befehlszeilenschalter Beschreibung
/Command Startet die IDE und führt den angegebenen Befehl aus.

devenv /command "nav https://learn.microsoft.com/"
/DebugExe Lädt eine ausführbare C++-Datei unter der Kontrolle des Debuggers. Dieser Schalter ist für ausführbare Visual Basic- oder C#-Dateien nicht verfügbar. Weitere Informationen finden Sie unter Prozess im Debugger automatisch starten.

devenv /debugexe mysln.exe
/Diff Vergleicht zwei Dateien. Erfordert vier Parameter: SourceFile, TargetFile, SourceDisplayName (optional) und TargetDisplayName (optional).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects Öffnet die angegebene Lösung, ohne Projekte zu laden.

devenv /donotloadprojects mysln.sln
/Edit Öffnet die angegebenen Dateien in einer ausgeführten Instanz dieser Anwendung. Wenn keine ausgeführten Instanzen vorhanden sind, wird eine neue Instanz mit einem vereinfachten Fensterlayout gestartet.

devenv /edit File1 File2
/LCID oder /L Legt die Standardsprache für die IDE fest. Wenn die angegebene Sprache in der Installation von Visual Studio nicht enthalten ist, wird diese Einstellung ignoriert.

devenv /l 1033
/Log Startet Visual Studio und protokolliert sämtliche Aktivitäten in der Protokolldatei.

devenv /log mylogfile.xml
/NoScale Hiermit wird die IDE im DPI-deaktivierten Modus geöffnet, der ein genaueres Layout im Windows Forms-Designer ermöglicht.
/NoSplash Öffnet die IDE ohne Anzeige der Begrüßungsbildschirms.

devenv /nosplash File1 File2
/ResetSettings Stellt die Visual Studio-Standardeinstellungen wieder her. Setzt die Einstellungen optional auf die der angegebenen .vssettings-Datei zurück.

devenv /resetsettings mysettings.vssettings
/Run oder /R Kompiliert die angegebene Projektmappe und führt sie aus.

devenv /run mysln.sln
/RunExit Kompiliert die angegebene Projektmappe und führt sie aus, minimiert die IDE bei der Ausführung der Projektmappe und schließt die IDE nach beendeter Ausführung der Projektmappe.

devenv /runexit mysln.sln
/SafeMode Startet Visual Studio im abgesicherten Modus. Dieser Schalter lädt nur die Standardumgebung, die Standarddienste und die im Lieferumfang enthaltenen Versionen von Drittanbieterpaketen.

Der Schalter verwendet keine Argumente.
/TfsLink Öffnet Team Explorer und startet einen Viewer für den angegebenen Artefakt-URI (sofern registriert).
/UseEnv Bewirkt, dass die IDE die Umgebungsvariablen PATH, INCLUDE, LIBPATH und LIB für die C++-Kompilierung verwendet. Dieser Schalter wird mit der Workload Desktopentwicklung mit C++ installiert. Weitere Informationen finden Sie unter Festlegen der Pfad- und Umgebungsvariablen für Befehlszeilenbuilds.

Durch die folgenden Befehlszeilenschalter wird die IDE nicht angezeigt.

Befehlszeilenschalter Beschreibung
/? Zeigt Hilfe für devenv-Schalter im Eingabeaufforderungsfenster an.

Der Schalter verwendet keine Argumente.
/Build Erstellt die angegebene Projektmappe oder das angegebene Projekt entsprechend der Konfiguration der angegebenen Projektmappe.

devenv mysln.sln /build
/Clean Löscht vom Buildbefehl erstellte Dateien, ohne die Quelldateien zu beeinflussen.

devenv mysln.sln /clean
/Deploy Erstellt die Projektmappe zusammen mit den für die Bereitstellung notwendigen Dateien gemäß der Konfiguration der Projektmappe.

devenv mysln.sln /deploy
/Out Ermöglicht die Angabe einer Datei für Fehlermeldungen, wenn ein Build erstellt wird.

devenv mysln.sln /build Debug /out log.txt
/Project Das zu erstellende, bereinigende oder bereitzustellende Projekt. Dieser Schalter kann nur verwendet werden, wenn auch der Schalter /Build, /Rebuild, /Clean, oder /Deploy angegeben wurde.

devenv mysln.sln /build Debug /project proj1
/ProjectConfig Gibt die zu erstellende oder bereitzustellende Projektkonfiguration an. Dieser Schalter kann nur verwendet werden, wenn auch der Schalter /Project angegeben wurde.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild Bereinigt die angegebene Projektmappe oder das angegebene Projekt und erstellt diese bzw. dieses entsprechend der Konfiguration der angegebenen Projektmappe durch.

devenv mysln.sln /rebuild
/Setup Zwingt Visual Studio dazu, Ressourcenmetadaten zur Beschreibung von Menüs, Symbolleisten und Befehlsgruppen aus allen verfügbaren VSPackages zusammenzuführen. Sie können diesen Befehl nur als Administrator ausführen.
/Upgrade Aktualisiert die angegebene Projektmappendatei und alle zugehörigen Projektdateien bzw. die angegebene Projektdatei mit den aktuellen, für diese Dateien gültigen Visual Studio-Formaten.

devenv mysln.sln /upgrade

Siehe auch