Devenv コマンドライン スイッチ
Devenv を使用すると、コマンド ラインから IDE のさまざまなオプションの設定、プロジェクトのビルド、プロジェクトのデバッグ、およびプロジェクトの配置を行うことができます。 これらのスイッチを使用して、スクリプトや .bat ファイル (夜間用のビルド スクリプトなど) から IDE を実行したり、特定の構成で IDE を起動したりします。
Note
ビルド関連のタスクでは、devenv の代わりに MSBuild を使用することをお勧めします。 詳細については、「MSBuild コマンド ライン リファレンス」を参照してください。
主に Visual Studio 拡張機能の開発を目的としたスイッチの詳細については、「VSPackage 開発の Devenv コマンド ライン スイッチ」も参照してください。
Devenv のスイッチの構文
devenv で始まるコマンドは devenv.com ユーティリティによって処理されます。このユーティリティは、stdout や stderr のような標準のシステム ストリーム経由で出力を配信します。 このユーティリティは出力をキャプチャする際に、txt ファイルなどの適切な入出力先を判断します。
また、devenv.exe で始まるコマンドも同じスイッチを使うことができますが、devenv.com ユーティリティはバイパスされます。 devenv.exe を使用すると、コンソールの出力表示が直接的に禁止されます。
devenv スイッチの構文規則は、他の DOS コマンド ライン ユーティリティの規則とよく似ています。 すべての devenv スイッチと引数に適用される構文規則は以下のとおりです。
devenvで始まるコマンド。スイッチは大文字と小文字が区別されません。
ハイフン ("-") またはスラッシュ ("/") を使用してスイッチを指定できます。
ソリューションまたはプロジェクトを指定するとき、最初の引数はソリューション ファイルまたはプロジェクト ファイルの名前 (ファイル パスを含む) です。
最初の引数がソリューションでもプロジェクトでもないファイルの場合、そのファイルが IDE の新しいインスタンスで適切なエディターを使用して開かれます。
ソリューション ファイル名の代わりにプロジェクト ファイル名を入力すると、
devenvコマンドは、プロジェクト フォルダーの親フォルダーで同じ名前が付いているソリューション ファイルを検索します。 たとえば、devenv myproject1.vbproj /buildというコマンドは、親フォルダーでmyproject1.slnという名前のソリューション ファイルを検索します。Note
このプロジェクトを参照するソリューション ファイルは、親フォルダーの中に 1 つだけ置かれている必要があります。 親フォルダーにこのプロジェクトを参照するソリューション ファイルがない場合、また親フォルダーにこのソリューション ファイルが 2 つ以上ある場合は、一時ソリューション ファイルが作成されます。
ファイル パスやファイル名にスペースが含まれる場合は、二重引用符 ("") で囲む必要があります。 たとえば、「
"c:\project a\"」のように入力します。1 行に複数のスイッチや引数を入力する場合は、空白文字 1 つで区切ります。 たとえば、
devenv /log output.txtというコマンドは、IDE を開き、そのセッションのすべてのログ情報を output.txt に出力します。devenvコマンドではパターン一致構文を使用できません。
Devenv のスイッチ
次の表のコマンド ライン スイッチを使用すると、IDE が表示され、説明されているタスクが実行されます。
| コマンド ライン スイッチ | 説明 |
|---|---|
| /Command | IDE を起動し、指定したコマンドを実行します。devenv /command "nav https://learn.microsoft.com/" |
| /DebugExe | C++ の実行可能ファイルをデバッガーの制御下に読み込みます。 このスイッチは、Visual Basic または C# の実行可能ファイルには使用できません。 詳細については、「デバッガーでプロセスを自動的に開始する」を参照してください。devenv /debugexe mysln.exe |
| /Diff | 2 つのファイルを比較します。 4 つのパラメーター: SourceFile、TargetFile、SourceDisplayName (省略可能)、および TargetDisplayName (省略可能) を受け取ります。devenv /diff File1 File2 Alias1 Alias2 |
| /DoNotLoadProjects | プロジェクトを読み込むことなく、指定したソリューションを開きます。devenv /donotloadprojects mysln.sln |
| /Edit | 指定したファイルを、このアプリケーションの実行中のインスタンスで開きます。 実行中のインスタンスがない場合は、簡略化されたウィンドウ レイアウトで新しいインスタンスを起動します。devenv /edit File1 File2 |
| /LCID または /L | IDE の既定の言語を設定します。 指定した言語が Visual Studio インストールに含まれていない場合、この設定は無視されます。devenv /l 1033 |
| /Log | Visual Studio を起動し、ログ ファイルにすべてのアクティビティを記録します。devenv /log mylogfile.xml |
| /NoScale | DPI 無効モードで IDE を開きます。これにより、Windows フォーム デザイナーでの、より正確なレイアウトが可能になります。 |
| /NoSplash | スプラッシュ スクリーンを表示せずに IDE を開きます。devenv /nosplash File1 File2 |
| /ResetSettings | Visual Studio の既定の設定を復元します。 指定の .vssettings ファイルに準じた設定にリセットすることもできます。devenv /resetsettings mysettings.vssettings |
| /Run または /R | 指定したソリューションをコンパイルして実行します。devenv /run mysln.sln |
| /RunExit | 指定したソリューションをコンパイルして実行します。ソリューションの実行時には IDE を最小化し、ソリューションの実行終了後に IDE を終了します。devenv /runexit mysln.sln |
| /SafeMode | Visual Studio をセーフ モードで起動します。 このスイッチを指定すると、既定の環境、既定のサービス、および出荷バージョンのサードパーティ パッケージのみが読み込まれます。 このスイッチは引数を取りません。 |
| /TfsLink | チーム エクスプローラーを開き、アーティファクト URI が登録されている場合、それのビューアーを起動します。 |
| /UseEnv | IDE で C++ のコンパイルに PATH、INCLUDE、LIBPATH、および LIB 環境変数が使用されます。 このスイッチは、C++ によるデスクトップ開発ワークロードと共にインストールされます。 詳細については、コマンド ライン ビルドのパスと環境変数の設定に関するページを参照してください。 |
次のコマンドライン スイッチでは、IDE が表示されません。
| コマンド ライン スイッチ | 説明 |
|---|---|
| /? | devenv のスイッチのヘルプを [コマンド プロンプト] ウィンドウ内に表示します。このスイッチは引数を取りません。 |
| /Build | 指定のソリューションの構成に従って、指定のソリューションまたはプロジェクトをビルドします。devenv mysln.sln /build |
| /Clean | ビルド コマンドによって作成されたすべてのファイルを、ソース ファイルに影響を与えずに削除します。devenv mysln.sln /clean |
| /Deploy | ソリューションの構成に従って、ソリューションを配置に必要なファイルと共にビルドします。devenv mysln.sln /deploy |
| /Out | ビルド時のエラーを受け取るファイルを指定できます。devenv mysln.sln /build Debug /out log.txt |
| /Project | ビルド、消去、または配置するプロジェクトを指定します。 このスイッチは、/Build、/Rebuild、/Clean、または /Deploy スイッチも指定した場合にのみ使用できます。devenv mysln.sln /build Debug /project proj1 |
| /ProjectConfig | ビルドまたは配置するプロジェクト構成を指定します。 このスイッチは、/Project スイッチも指定した場合にのみ使用できます。devenv mysln.sln /build Release /project proj1 /projectconfig Release |
| /Rebuild | 指定のソリューションの構成に従って、指定のソリューションまたはプロジェクトを消去してからビルドします。devenv mysln.sln /rebuild |
| /Setup | 使用できるすべての VSPackages にある、メニュー、ツールバー、およびコマンド グループを記述したリソース メタデータが Visual Studio により強制的にマージされます。 このコマンドの実行は、管理者としてのみ行えます。 |
| /Upgrade | 指定されたソリューション ファイルとそのすべてのプロジェクト ファイル、または指定されたプロジェクト ファイルを、そのファイルに対応する現在の Visual Studio の形式にアップグレードします。devenv mysln.sln /upgrade |