コマンド ライン パラメーターを使用して Visual Studio をインストールする

プログラムから、またはコマンド プロンプトから Visual Studio をインストールする場合、さまざまなコマンド ライン パラメーターを使用してインストールを管理またはカスタマイズし、以下のアクションを実行することができます。

  • 事前に選択された特定のオプションと動作を使用して、クライアントでのインストールを開始する。
  • インストール プロセスを自動化する。
  • クライアント コンピューターをインストールまたは更新するための、製品ファイルのネットワーク レイアウトを作成または管理する。

ほとんどのコマンド ライン オプションは、セットアップ ブートストラップという、ダウンロード プロセスを開始する小さな (1 MB 以下) ファイル (vs_enterprise.exe 等) と組み合わせて使用されます。 以下に示すコマンドとパラメーターはすべて、ブートストラップで動作するように設計されています。

また、Microsoft Update Catalogからダウンロードできる管理者更新プログラム パッケージを使用して、ネットワーク レイアウトをプログラムで更新することができます。 これを行う方法の詳細については、レイアウトの更新または変 更 に関するドキュメントを参照してください。

Visual Studio 2017 バージョン 15.9 のブートストラップを取得するには、次のいずれかのブートストラップ ファイルをダウンロードします。

エディション ブートストラップ
Visual Studio Enterprise 2017 バージョン 15.9 vs_enterprise.exe
Visual Studio Professional 2017 バージョン 15.9 vs_professional.exe
Visual Studio Build Tools 2017 バージョン 15.9 vs_buildtools.exe

次の表の Visual Studio 2019 ブートストラップを取得できます。 または、Visual Studio 2019 の特定のバージョンをインストールする場合は、Visual Studio の任意のバージョンおよびエディションの固定バージョン ブートストラップへのリンクが記載されている Visual Studio 2019 リリースのページにアクセスしてください。

エディション ブートストラップ
Visual Studio 2019 Enterprise バージョン 16.11 vs_enterprise.exe
Visual Studio 2019 Professional バージョン 16.11 vs_professional.exe
Visual Studio 2019 Build Tools バージョン 16.11 vs_buildtools.exe

最新機能提供チャネルの最新バージョンが常にインストールされる Visual Studio 2022 の最新のブートストラップを入手するには、次のいずれかのファイルをダウンロードします。 または、Visual Studio 2022 の特定のバージョンまたは特定のチャネルをインストールする場合は、各サービス リリースの固定バージョン ブートストラップへのリンクが記載されている Visual Studio 2022 リリース履歴のページにアクセスします。

エディション ブートストラップ
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Visual Studio 2022 Community vs_community.exe
Visual Studio 2022 Build Tools vs_buildtools.exe

ヒント

前にブートストラップ ファイルをダウンロードしてあり、そのバージョンを確認したい場合は、次のようにします。 Windows でエクスプローラーを開き、ブートストラップ ファイルを右クリックし、 [プロパティ] を選択して、 [詳細] タブを選択し、 [製品バージョン] の値を表示します。 この値に対応する Visual Studio のリリースを調べるには、「Visual Studio のビルド番号とリリース日」ページを参照してください。

ヒント

前にブートストラップ ファイルをダウンロードしてあり、そのバージョンを確認したい場合は、次のようにします。 Windows でエクスプローラーを開き、ブートストラップ ファイルを右クリックし、 [プロパティ] を選択して、 [詳細] タブを選択し、 [製品バージョン] の値を表示します。 この値に対応する Visual Studio のリリースを調べるには、「Visual Studio 2019 リリース」の下部の表を参照してください。

ヒント

前にブートストラップ ファイルをダウンロードしてあり、インストールされるバージョンを確認したい場合は、次のようにします。 Windows でエクスプローラーを開き、ブートストラップ ファイルを右クリックして、 [プロパティ] を選択してから [詳細] タブを選択します。 [製品バージョン] フィールドに、ブートストラップでインストールされる チャネルとバージョンが記載されます。 バージョン番号は、常に "指定されている最新のサービス バージョン" として読み取られるため、チャネルは明示的に指定されていない限り、最新になります。 そのため、LTSC 17.0 の製品バージョンを持つブートストラップでは、17.0 LTSC チャネルで利用可能な最新の 17.0.x サービス リリースがインストールされます。 製品バージョンのブートストラップで Visual Studio 2022 とだけ表示される場合は、最新チャネルの Visual Studio 2022 の最新バージョンがインストールされます。

ブートストラップのコマンドとコマンド ライン パラメーター

製品をインストールしたり、レイアウトを維持したりするために、プログラムで Visual Studio ブートストラップを呼び出すときの最初のパラメーターは、実行する操作を記述するコマンド (動詞) です。 後続の省略可能なコマンド ライン パラメーター (すべて先頭に 2 つのダッシュ -- が付いている) によって、その操作がどのように行われるかがさらに定義されます。 Visual Studio のすべてのコマンド ライン パラメーターで大文字と小文字が区別されません。その他の例については、コマンド ライン パラメーターの例に関する記事を参照してください。

構文例: vs_enterprise.exe [command] <optional parameters>...

コマンド 説明
(空白) 既定のコマンドはどちらも製品をインストールし、すべてのレイアウト メンテナンス操作に使用されます。
modify インストールされている製品を変更します。
update インストールされている製品を更新します。
repair インストールされている製品を修復します。
uninstall インストールされている製品をアンインストールします。
export インストールの選択をインストール構成ファイルにエクスポートします。 注記: vs_installer.exe でのみ使用できます。

重要

複数の個別のワークロード、コンポーネント、または言語を指定する場合、項目ごとに --add または --remove のコマンド ライン スイッチを繰り返す必要があります。

パラメーター 説明
--installPath <dir> 既定の install コマンドの場合、このパラメーターは 省略可能 で、インスタンスがクライアント コンピューターのどこにインストールされるかを示します。 update や modify などの他のコマンドの場合、このパラメーターは 必須 であり、操作するインスタンスのインストール ディレクトリを示します。
--add <one or more workload or component IDs> 省略可能: install または modify コマンドの実行中に、この反復可能なパラメーターでは、追加する 1 つ以上のワークロードまたはコンポーネント ID が指定されます。 成果物の必須のコンポーネントはインストールされますが、推奨されるコンポーネントまたは省略可能なコンポーネントはインストールされません。 --includeRecommended--includeOptional のパラメーターを使用して、他のコンポーネントをグローバルに制御できます。 複数のワークロードやコンポーネントを含める場合、--add コマンドを繰り返します (例: --add Workload1 --add Workload2)。 詳細に制御するために、ID に ;includeRecommended または ;includeOptional を追加できます (例: --add Workload1;includeRecommended または --add Workload2;includeRecommended;includeOptional)。 詳しくは、ワークロード ID とコンポーネント ID に関するページをご覧ください。
--remove <one or more workload or component IDs> 省略可能: modify コマンドの実行中に、この反復可能なパラメーターでは、削除する 1 つ以上のワークロードまたはコンポーネント ID が指定されます。 これは、--add パラメーターと同じように補完および動作します。
--addProductLang <language-locale> 省略可能: install または modify コマンドの実行中に、この反復可能なパラメーターでは、製品と共にインストールする必要がある UI 言語パックが指定されます。 存在しない場合、インストールでは、コンピューターのロケールに対応する言語パックが使用されます。 詳しくは、このページの「言語ロケールの一覧」セクションをご覧ください。
--removeProductLang <language-locale> 省略可能: install または modify コマンドの実行中に、この反復可能なパラメーターでは、製品から削除する必要がある UI 言語パックが決定されます。 これは、--addProductLang パラメーターと同じように補完および動作します。
--in <path> 省略可能: 構成設定を含むことができる応答ファイルの URI またはパス。
--all 省略可能: install または modify コマンドの実行中に、このパラメーターでは製品のすべてのワークロードとコンポーネントがインストールされます。
--allWorkloads 省略可能: install または modify コマンドの実行中に、このパラメーターを指定すると、すべてのワークロードとコンポーネントがインストールされますが、推奨される、またはオプションのコンポーネントはインストールされません。
--includeRecommended 省略可能: install または modify コマンドの実行中、このパラメーターには、インストールされているワークロードに対して推奨されるコンポーネントが含まれますが、オプションのコンポーネントは含まれません。 ワークロードは、--allWorkloads または --add のいずれかで指定されます。
--includeOptional 省略可能: install または modify コマンドの実行中、このパラメーターには、インストールされているワークロードに対して省略可能なコンポーネントが含まれますが、推奨されるコンポーネントは含まれません。 ワークロードは、--allWorkloads または --add のいずれかで指定されます。
--quiet, -q 省略可能: 任意のコマンドで使用します。このパラメーターにより、コマンドの実行中にユーザー インターフェイスが表示されなくなります。
--passive, -p 省略可能: このパラメーターにより、ユーザー インターフェイスは非対話形式で表示されます。 このパラメーターは、--quiet パラメーターとは相互に排他的です (実際にはオーバーライドされます)。
--norestart 省略可能: このパラメーターは、--passive または --quiet のいずれかのパラメーターと組み合わせる必要があります。 install、update、または modify コマンドの実行中に、--norestart パラメーターを追加すると、必要な再起動が遅延します。
--force 省略可能: このパラメーターは、Visual Studio プロセスが使用されている場合でも、Visual Studio を強制的に閉じます。
--installWhileDownloading 省略可能: install、update、または modify コマンドの実行中に、このパラメーターを指定すると、Visual Studio で製品を同時にダウンロードしてインストールすることができます。 これは既定のエクスペリエンスです。
--downloadThenInstall 省略可能: install、update、または modify コマンドの実行中に、このパラメーターを指定すると、Visual Studio がすべてのファイルをインストール前に強制的にダウンロードします。 --installWhileDownloading パラメーターとは相互に排他的です。
--channelURI 省略可能: 更新コマンド中に、新しい channelURI を渡して更新設定の場所を変更できます。 Visual Studio のどのインスタンスを構成しているのかが明示的になるように、--installPath パラメーターと組み合わせることをお勧めします。
--nickname <name> 省略可能: install コマンドの実行時に、このパラメーターを実行するとインストールされている製品に割り当てるニックネームが定義されます。 ニックネームは 10 文字を超えることはできません。
--productKey 省略可能: install コマンドの実行時に、このパラメーターを実行するとインストールされている製品に使用するプロダクト キーが定義されます。 xxxxxxxxxxxxxxxxxxxxxxxxx の形式の英数字 25 文字で構成されます。
--help, --?, -h, -? このページのオフライン バージョンが表示されます。
--config <path> 省略可能: インストールまたは変更の操作中に、以前に保存したインストール構成ファイルに基づいて、追加するワークロードおよびコンポーネントが決定されます。 この操作は追加式で、ワークロードやコンポーネントがファイル内に存在しない場合、削除されることはありません。 また、製品に適用されない項目は追加されません。 エクスポート操作中に、インストール構成ファイルの保存場所を決定します。

レイアウトのコマンドとコマンド ライン パラメーター

レイアウト管理操作はすべて、レイアウトを作成または更新する場合に関係なく、 コマンドが既定のインストール (空白) である必要があります。 そのため、すべてのレイアウト管理操作は、最初に必要な --layout パラメーターで始まる必要があります。 次の表は、コマンド ラインを使用してレイアウトを作成または更新するために使用できるその他のパラメーターについて説明しています。

レイアウト パラメーター 説明
--layout <dir> オフライン インストールのキャッシュを作成または更新するディレクトリを指定します。 詳細については、「Visual Studio のネットワーク ベース インストールを作成する」をご覧ください。
--lang <one or more language-locales> 省略可能: --layout とともに使用して、指定した言語でのリソース パッケージによるオフライン インストール キャッシュを準備します。 詳しくは、このページの「言語ロケールの一覧」セクションをご覧ください。
--add <one or more workload or component IDs> 省略可能: 1 つ以上のワークロード ID またはコンポーネント ID を追加します。 成果物の必須のコンポーネントはインストールされますが、推奨されるコンポーネントまたは省略可能なコンポーネントはインストールされません。 --includeRecommended--includeOptional を使用して、他のコンポーネントをグローバルに制御できます。 詳細に制御するために、ID に ;includeRecommended または ;includeOptional を追加できます (例: --add Workload1;includeRecommended または --add Workload2;includeOptional)。 詳しくは、ワークロード ID とコンポーネント ID に関するページをご覧ください。
注意: --add を使用する場合、指定したワークロードとコンポーネント、およびその依存関係のみがダウンロードされます。 --add を指定しない場合は、すべてのワークロードとコンポーネントがレイアウトにダウンロードされます。
--includeRecommended 省略可能: インストールされているワークロードの推奨されるコンポーネントを含めますが、オプションのコンポーネントは含めません。 ワークロードは、--allWorkloads または --add のいずれかで指定されます。
--includeOptional 省略可能: レイアウトに含まれるワークロードに、推奨 および 省略可能なコンポーネントが含まれます。 ワークロードは、--add で指定されます。
--keepLayoutVersion 省略可能: レイアウトに含まれる製品バージョンを更新することなく、レイアウトに変更を適用します。
--useLatestInstaller 省略可能: 存在する場合、新しいバージョンの製品に属している場合でも、Visual Studio インストーラー の最新バージョンがレイアウトに含まれます。 これは、最新のインストーラーで使用できる新機能やバグ修正を利用する場合に便利です。 詳細については、「最新のインストーラーを常に使用するレイアウトの構成」ドキュメントを参照してください。
--verify 省略可能: レイアウトの内容を確認します。 破損または欠落しているすべてのファイルが一覧に表示されます。
--fix 省略可能: レイアウトの内容を確認します。 いずれかのファイルが破損または欠落している場合は、再ダウンロードします。 レイアウトを修正するには、インターネットへのアクセスが必要です。
--clean <one or more paths to catalogs> 省略可能: 新しいバージョンに更新されたレイアウトから古いバージョンのコンポーネントを削除します。
高度なレイアウト パラメーター 説明
--channelId <id> 省略可能: インストールするインスタンスのチャネル ID です。 インストール コマンドでは必須です。--installPath が指定されている場合、他のコマンドでは無視されます。
--channelUri <uri> 省略可能: チャネル マニフェストの URI です。 この値は更新のソースの場所 を制御し、初期値はレイアウトの response.json ファイル で構成されます。 更新が不要な場合、--channelUri で存在しないファイル (たとえば、--channelUri C:\doesntExist.chman) を指定できます。 インストール コマンドに使用できます。その他のコマンドでは無視されます。
--installChannelUri <uri> 省略可能: インストールに使用するチャネル マニフェストの URI です。 --channelUri で指定された URI (--installChannelUri を指定した場合は必ず指定する必要があります) は、更新プログラムを検出するために使用されます。 インストール コマンドに使用できます。その他のコマンドでは無視されます。
--installCatalogUri <uri> 省略可能: インストールに使用するカタログ マニフェストの URI です。 これを指定すると、チャネル マネージャーは、インストール チャネル マニフェストの URI を使用する前に、この URI からカタログ マニフェストをダウンロードしようとします。 このパラメーターは、レイアウトのキャッシュが既にダウンロードされている製品カタログで作成される、オフライン インストールをサポートするために使用されます。 インストール コマンドに使用できます。その他のコマンドでは無視されます。
--productId <id> 省略可能: インストールされるインスタンスの製品 ID です。 これは、通常のインストール条件では事前に設定されています。 productIDは、「Microsoft.VisualStudio.Product.Enterprise」のようなものです。
--wait 省略可能: インストールが完了し、終了コードが返されるまでプロセスは待機します。 このオプションは、インストールが完了するまで待ってから、そのインストールからのリターン コードを処理する必要があるインストールの自動化に役立ちます。
--locale <language-locale> 省略可能: インストーラー自体のユーザー インターフェイスの表示言語を変更します。 設定は保持されます。 詳しくは、このページの「言語ロケールの一覧」セクションをご覧ください。
--cache 省略可能: 指定した場合、インストールされた後、その後の修復用にパッケージが保持されます。 このオプションでは、その後のインストール、修復、または修正に使用されるグローバル ポリシー設定がオーバーライドされます。 既定のポリシーでは、パッケージをキャッシュします。 アンインストール コマンドでは、これは無視されます。 詳細については、「disable or move the package cache」 (パッケージ キャッシュの無効化または移動) を参照してください。
--nocache 省略可能: 指定した場合、パッケージはインストールまたは修復された後、削除されます。 必要な場合にのみ、もう一度ダウンロードされ、使用後はもう一度削除されます。 このオプションでは、その後のインストール、修復、または修正に使用されるグローバル ポリシー設定がオーバーライドされます。 既定のポリシーでは、パッケージをキャッシュします。 アンインストール コマンドでは、これは無視されます。 詳細については、「disable or move the package cache」 (パッケージ キャッシュの無効化または移動) を参照してください。
--noUpdateInstaller 省略可能: 指定した場合、quiet が指定されていると、インストーラーはインストーラー自体を更新しません。 インストーラーの更新が必要な場合に、noUpdateInstaller と quiet の両方が指定されていると、インストーラーはコマンドを失敗させて、0 以外の終了コードを返します。
--noWeb 省略可能: 指定した場合、Visual Studio のセットアップでは、レイアウト ディレクトリにあるファイルを使って Visual Studio がインストールされます。 ユーザーがレイアウトに含まれないコンポーネントをインストールしようとした場合、セットアップは失敗します。 詳細については、「ネットワーク インストールから展開する」をご覧ください。

重要: この切り替えによって、Visual Studio のセットアップで更新プログラムのチェックが行われなくなることはありません。 詳細については、「ネットワーク ベースの Visual Studio 配置の更新プログラムを制御する」をご覧ください。
--path <name>=<path> 省略可能: インストール用のカスタム インストール パスを指定するために使用します。 サポートされているパス名は、shared、cache、および install です。
--path cache=<path> 省略可能: 指定した場所を使用してインストール ファイルがダウンロードされます。 この場所は、Visual Studio を初めてインストールするときにのみ設定することができます。 例: --path cache="C:\VS\cache"
--path shared=<path> 省略可能: Visual Studio のサイド バイ サイド インストール用の共有ファイルが含まれています。 ツールおよび SDK については、このドライブ上の場所にインストールされるものもあれば、この設定をオーバーライドして、別のドライブにインストールされるものもあります。 例: --path shared="C:\VS\shared"

重要: これは Visual Studio を初めてインストールするときに 1 回のみ設定できます。
--path install=<path> 省略可能: –-installPath と等価です。 具体的には、--installPath "C:\VS"--path install="C:\VS" が等価です。 これらのコマンドは、一度に 1 つしか使用できません。

管理者向け更新プログラムのコマンドとコマンド ライン パラメーター

Microsoft Update カタログからクライアント コンピューターのインストール ディレクトリに管理者向け更新プログラムをダウンロードする場合は、ファイルをダブルクリックするだけで更新プログラムを適用できます。 また、コマンド ウィンドウを開き、以下のパラメーターの一部を渡して、既定の動作を変更することもできます。

Microsoft Endpoint Manager (SCCM) を使用して管理者向け更新プログラムを展開する場合は、次のパラメーターを使用して、パッケージを変更して動作を調整できます。 クライアント コンピューターの構成ファイルを使用してパラメーターを制御することもできます。 詳細については、「管理者更新プログラムを構成する方法」を参照してください

すべての管理者更新プログラムのパラメーターは、"更新" コンテキストで実行されることに注意してください。

管理者向け更新プログラムのパラメーター 説明
--installerUpdateArgs [optional parameters] このパラメーターは、管理者向け更新プログラムのシナリオに関連する特定のパラメーターの "パススルー配列" として機能します。 この目的で有効になっている省略可能なパラメーターは次のとおりです。

--quiet: これは管理者向け更新プログラムの既定のエクスペリエンスであり、完全を期すためにここに記載されています。
--passive: このパラメーターは --quiet パラメーターをオーバーライドします。 これにより、UI が非対話的な方法で表示されます。
--norestart: このパラメーターは、--quiet または --passive と組み合わせて使用する必要があり、必要な再起動の遅延を引き起こします。
--noWeb: このパラメーターにより、Visual Studio が製品の更新プログラムをインターネット上で確認しなくなります。
--force: このパラメーターにより、Visual Studio が使用されている場合でも、Visual Studio が強制的に閉じられます。 このパラメーターは、作業が失われる可能性があるため、注意して使用してください。 このパラメーターは、ユーザー コンテキストで使用する必要があります。
--installWhileDownloading: このパラメーターにより、Visual Studio で製品のダウンロードとインストールが両方同時にできるようになります。 これは管理者向け更新プログラムの既定のエクスペリエンスであり、完全を期すためにここに記載されています。
--downloadThenInstall: このパラメーターを指定すると、Visual Studio はすべてのファイルをインストール前に強制的にダウンロードします。 --installWhileDownloading パラメーターとは相互に排他的です。
--checkPendingReboot コンピューターに保留中の再起動がある場合は、その原因がどのアプリケーションであるかにかかわらず、更新プログラムは中止されます。 既定では、保留中の再起動の有無はチェックされません。

構文例: visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb --checkPendingReboot

ワークロード ID とコンポーネント ID の一覧

Visual Studio 製品ごとに並べられているワークロード ID とコンポーネント ID の一覧については、「Visual Studio のワークロードとコンポーネント ID」のページをご覧ください。

言語ロケールの一覧

言語ロケール Language
Cs-cz チェコ語
De-de ドイツ語
En-us 英語
Es-es スペイン語
Fr-fr フランス語
It-it イタリア語
Ja-jp 日本語
Ko-kr 韓国語
Pl-pl ポーランド語
Pt-br ポルトガル語 - ブラジル
Ru-ru ロシア語
Tr-tr トルコ語
Zh-cn 中国語 - 簡体字
Zh-tw 中国語 - 繁体字

エラー コード

操作の結果に応じて、%ERRORLEVEL% 環境変数は、次のいずれかの値に設定されます。

結果
0 操作は正常に終了しました
740 昇格が必要
1001 Visual Studio インストーラー プロセスが実行中です
1003 Visual Studio が使用中です
1602 操作が取り消されました
1618 別のインストールを実行しています
1641 操作が正常に完了し、再起動が開始されました
3010 操作は正常に完了しましたが、インストールした製品を使用する前に再起動が必要です
5003 ブートストラップによるインストーラーのダウンロードが失敗しました
5004 操作が取り消されました
5005 ブートストラップのコマンドライン解析エラー
5007 操作がブロックされました - コンピューターが要件を満たしていません
8001 Arm マシン チェックの失敗
8002 バックグラウンド ダウンロードの事前チェックの失敗
8003 サポート外の選択可能エラー
8004 ターゲット ディレクトリのエラー
8005 ソース ペイロードの有効性検証失敗
8006 Visual Studio プロセスを実行しています
-1073720687 接続エラー
-1073741510 Microsoft Visual Studio インストーラーが終了しました (ユーザーか外部プロセスにより)
その他
(例:
-1、1、1603)
失敗の状態が発生しました。詳細については、ログを参照してください

操作ごとに、インストールの進行状況を示す複数のログ ファイルが %TEMP% ディレクトリに生成されます。 フォルダーを日付で並べ替え、dd_bootstrapperdd_clientdd_setup で始まるファイルを探します (それぞれブートストラップ、インストーラー アプリ、セットアップ エンジンを表します)。

サポートを受ける

ときには、問題が発生してしまうことがあります。 Visual Studio のインストールが失敗した場合は、「Visual Studio のインストールとアップグレードの問題のトラブルシューティング」に記載されているステップ バイ ステップ ガイドをご覧ください。

他のいくつかのサポート オプションを次に示します。

関連項目