コマンド ライン パラメーターを使用して Visual Studio のインストール、更新、管理を行う
プログラムまたはコマンド プロンプトから Visual Studio をインストールする場合は、さまざまなコマンド ライン パラメーターを使用してインストールを制御またはカスタマイズし、次の操作を実行できます。
- 特定のオプションと動作が事前に選択された状態で、クライアントでインストールを開始します。
- インストールまたは更新プロセスを自動化します。
- クライアント マシンをインストールまたは更新するための製品ファイルのネットワーク レイアウトを作成または維持します。
次のコマンド ライン動詞とパラメーターは、次の実行可能ファイルまたはプログラムで使用できます。
- セットアップ ブートストラップ。ダウンロード プロセスと初期インストールを開始する小さな (最大 1 MB) ファイル (vs_enterprise.exeなど)。
- コンピューターに既にインストールされている可能性があり、
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exeフォルダーにある Visual Studio インストーラー。 インストーラーが存在するのとは "異なる" ディレクトリから、プログラムでインストーラーを開始する必要があります。 インストーラーは通常、更新または変更コマンドに使用されます。 - winget コマンドで winget の --override スイッチを使用します。
- ネットワーク レイアウトをプログラムで更新するために、Microsoft Update Catalogからダウンロードできる Administrator Update パッケージを使用します。 詳細については、更新またはレイアウトの変更に関する記事 参照してください。
これらの状況では、すべてのコマンドまたはパラメーターが機能するわけではありません。また、特別な注意事項や例外が記載されています。 さらに、一部のシナリオでは、前に説明したすべての実行可能ファイルにアクセスできない場合があります。 たとえば、Visual Studio がレイアウトを使用してインストールされている場合、クライアント マシンはプログラムで実行できるインストーラーのみを持つことができます。
次の表から Visual Studio 2019 ブートストラッパーを入手することができます。 または、特定のバージョンの Visual Studio 2019 が必要な場合は、「Visual Studio 2019 リリース」ページを参照してください。 このページには、選択したバージョンと Visual Studio のエディションの固定バージョン ブートストラップへのリンクがあります。
| エディション | ブートストラップ ローダー |
|---|---|
| Visual Studio 2019 Enterprise バージョン 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional バージョン 16.11 | vs_professional.exe |
| Visual Studio 2019 ビルド ツール バージョン 16.11 | vs_buildtools.exe |
常に最新バージョンの Current チャネルをインストールする 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 コミュニティ | vs_community.exe |
| Visual Studio 2022 ビルド ツール | vs_buildtools.exe |
ヒント
ブートストラップ ファイルを以前にダウンロードし、そのバージョンを確認する場合は、その方法を次に示します。 Windows でエクスプローラーを開き、ブートストラップ ファイルを右クリックし、[プロパティ] 選択し、[の詳細] タブを選択して、製品バージョン 番号を表示します。 その番号を Visual Studio のリリースと一致させる場合は、Visual Studio 2019 リリース ページの下部にある表を参照してください。
アドバイス
以前にブートストラップ ファイルをダウンロードし、インストールするバージョンを確認する場合は、次の手順を実行します。 Windows でエクスプローラーを開き、ブートストラップ ファイルを右クリックし、[プロパティ] 選択し、[の詳細] タブを選択します。製品バージョンの フィールドには、ブートストラップがインストールする チャネルとバージョンの が記述されます。 バージョン番号は常に"指定された内容の最新のサービス バージョン" として読み取る必要があり、チャネルは明示的に指定されていない限り Current です。 そのため、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 |
インストールされている製品を更新します。 |
updateall |
インストールされているすべての製品を順番に更新します。 --quiet および --passive パラメーターで動作します。 |
repair |
インストールされている製品を修復します。 |
uninstall |
インストールされている製品をアンインストールします。 |
export |
インストール構成を *.vsconfig ファイルにエクスポートします。 |
重要
複数の個別のワークロードまたはコンポーネントまたは言語を指定する場合は、各項目に対して --add または --remove コマンド ライン スイッチを繰り返す必要があります。
| パラメーター | 説明 |
|---|---|
--installPath <dir> |
既定のインストール コマンドの場合、このパラメーターは Optional であり、インスタンスがクライアント コンピューターにインストールされる場所について説明します。 更新や変更などの他のコマンドの場合、このパラメーターは Required であり、インスタンスが実行するインストール ディレクトリを示します。 |
--productId <id> |
省略可能な: 変更され、--channelIdと共に使用される製品インスタンスの ID。 productID は"Microsoft.VisualStudio.Product.Enterprise" のようなものです。 |
--channelUri |
省略可能な: 更新コマンド中に、新しい --channelUri を渡して更新設定の場所を変更できます。 構成する Visual Studio のインスタンスが明示的になるように、--installPath パラメーターとペアにすることをお勧めします。 構文の--channelUriの例を参照してください |
--channelId <id> |
チャネルの ID (例: VisualStudio.17.Release)。 の --channelId構文の例を参照してください。 channelId は、--productID または --installPathと共に、変更操作に必要です。 |
--add <one or more workload or component IDs> |
省略可能な: インストールまたは変更コマンド中に、この反復可能なパラメーターは、追加する 1 つ以上のワークロード ID またはコンポーネント ID を指定します。 成果物の必須コンポーネントはインストールされますが、推奨またはオプションのコンポーネントはインストールされません。 --includeRecommended や --includeOptional パラメーターを使用して、他のコンポーネントをグローバルに制御できます。 複数のワークロードまたはコンポーネントを含めるには、--add コマンド (たとえば、--add Workload1 --add Workload2) を繰り返します。 きめ細かい制御を行うには、ID に ;includeRecommended または ;includeOptional を追加できます (たとえば、--add Workload1;includeRecommended や --add Workload2;includeRecommended;includeOptional)。 詳細については、ワークロード ID とコンポーネント ID ページを参照してください。 |
--all |
省略可能な: インストールまたは変更コマンド中に、このパラメーターを指定すると、製品のすべてのワークロードとコンポーネントがインストールされます。 |
--allWorkloads |
省略可能な: インストールまたは変更コマンド中に、このパラメーターはすべてのワークロードとコンポーネントをインストールしますが、推奨コンポーネントまたはオプション コンポーネントはインストールしません。 |
--includeRecommended |
省略可能な: インストールまたは変更コマンド中に、このパラメーターには、インストールされているワークロードに推奨されるコンポーネントが含まれます。 省略可能なコンポーネントは含まれません。 ワークロードは、--allWorkloads または --addで指定されます。 --includeRecommended パラメーターを使用すると、の [更新設定] ダイアログを有効にして、"更新時にインストールされているワークロードに推奨されるコンポーネントを追加する" ことに注意してください。 この設定を変更するには、「更新設定 をカスタマイズする」を参照してください。 |
--includeOptional |
省略可能な: インストールまたは変更コマンドの際、このパラメーターには、既にインストール済みのワークロードのオプションコンポーネントが含まれています。 推奨されるコンポーネントは含まれません。 ワークロードは、--allWorkloads または --addで指定されます。 |
--addProductLang <language-locale> |
省略可能な: インストールまたは変更コマンド中に、この反復可能なパラメーターは、製品と共にインストールする UI 言語パックを指定します。 存在しない場合、インストールでは、コンピューターのロケールに対応する言語パックが使用されます。 詳細については、「言語ロケールの一覧」を参照してください。 |
--remove <one or more workload or component IDs> |
省略可能な: 変更コマンド中に、この反復可能なパラメーターは、削除する 1 つ以上のワークロードまたはコンポーネント ID を指定します。 これは、--add パラメーターと同様に補完され、動作します。 |
| このページの (#list-of-language-locales) セクション | |
--removeProductLang <language-locale> |
省略可能な: インストールまたは変更コマンド中に、この反復可能なパラメーターによって、製品から削除する必要がある UI 言語パックが決まります。 これは、--addProductLang パラメーターと同様に補完され、動作します。 |
--in <path> |
省略可能な: 構成設定を含めることができる、応答ファイルの URI またはパス。 |
--quiet |
省略可能な: 任意のコマンドで使用します。このパラメーターを指定すると、コマンドの実行中にユーザー インターフェイスが表示されなくなります。 AllowStandardUserControl ポリシー の の設定方法に関係なく、標準ユーザーがプログラムで使用することはできません。 |
--passive, -p |
省略可能な: このパラメーターにより、ユーザー インターフェイスが非対話型の方法で表示されます。 このパラメーターは、--quiet パラメーターとは相互に排他的です (実際にはオーバーライドされます)。 また、AllowStandardUserControl ポリシー の設定方法に関係なく、標準ユーザーがプログラムで使用することはできません。 |
--norestart |
省略可能な: このパラメーターは、--passive または --quiet パラメーターとペアにする必要があります。 インストール、更新、または変更コマンド中に、--norestart パラメーターを追加すると、必要な再起動が遅れます。 |
--force |
省略可能な: このパラメーターは、Visual Studio プロセスが使用中であっても、Visual Studio を強制的に閉じます。 Visual Studio を強制的に閉じると、作業が失われる可能性があるため、注意して使用してください。 |
--installWhileDownloading |
省略可能な: インストール、更新、または変更コマンド中に、このパラメーターを使用すると、Visual Studio で製品を並列にダウンロードおよびインストールできます。 既定のエクスペリエンスです。 |
--downloadThenInstall |
省略可能な: インストール、更新、または変更のコマンド中に、このパラメーターは、インストールする前にすべてのファイルをダウンロードするように Visual Studio に強制します。 --installWhileDownloading パラメーターとは相互に排他的です。 |
--nickname <name> |
省略可能な: インストール コマンド中に、このパラメーターは、インストールされている製品に割り当てるニックネームを定義します。 ニックネームは 10 文字を超えることはできません。 |
--productKey |
省略可能な: インストール コマンド中に、このパラメーターは、インストールされている製品に使用するプロダクト キーを定義します。 プロダクト キーは、xxxxxxxxxxxxxxxxxxxxxxxxx形式の 25 文字の英数字で構成されます。 |
--removeOos true |
省略可能な: インストール、更新、または変更コマンドの実行中に、このパラメーターの後に true または falseが続き、インストールされているすべてのコンポーネントをサポート外の状態に移行するかどうかを Visual Studio インストーラーに指示します。 この動作は、1 つのイベントに適用されます。 この動作を永続的にする場合は、後で説明する modifySettings コマンドにこのパラメーターを適用するか、removeOOS グローバル ポリシー を構成します。 マシンのセキュリティを維持するのに役立ちます。 |
--config <path to *.vsconfig file> |
省略可能な: インストールまたは変更操作中に、--config パラメーターを使用して構成ファイルを渡して、以前に保存したインストール構成ファイルに基づいて追加するワークロード、コンポーネント、または拡張機能を指定できます。 この操作は加法のみです。ファイルで指定されていないものは削除されません。 また、製品に適用されない構成ファイルで指定された項目は追加されません。 構成ファイルへの完全修飾パスを指定することを強くお勧めします。 エクスポート操作中に、このパラメーターはインストール構成ファイルを保存する場所を決定します。 |
--allowUnsignedExtensions |
省略可能な: --config ファイルを使用して --passive または --quiet コンテキストでインストールまたは変更操作を実行する際に、構成ファイルに拡張機能が指定されている場合、デジタル署名なしで拡張機能を読み込むには、このパラメーターが必要です。 |
--installerOnly |
省略可能な: インストールまたは更新操作中に、このパラメーターは Visual Studio 製品ではなく、それ自体 (インストーラー) のみをインストールするように Visual Studio インストーラーに指示します。 その機能は、--update パラメーターと同等ですが、より直感的です。 クライアント マシンの準備と事前構成時に使用されます。 |
--help, --?, -h, -? |
このページのオフライン バージョンを表示します。 |
レイアウト コマンドとコマンド ライン パラメーター
レイアウトの作成や更新など、すべてのレイアウト管理操作はブートストラップ exe を使用して実行され、コマンドが既定のインストール (空白) であることを前提としています。 すべてのレイアウト管理操作は、必要な --layout 初期パラメーターで開始する必要があります。 次の表では、コマンド ラインを使用してレイアウトを作成または更新するために使用できるその他のパラメーターについて説明します。
| レイアウト パラメーター | 説明 |
|---|---|
--layout <dir> |
オフライン インストール キャッシュを作成または更新するディレクトリを指定します。 詳細については、「Visual Studioのネットワーク ベースのインストールを作成する」を参照してください。 |
--lang <one or more language-locales> |
省略可能な: --layout と共に使用して、指定した 1 つ以上の指定された言語のリソース パッケージを含むオフライン インストール キャッシュを準備します。 詳細については、このページの「言語ロケールの一覧」セクションを参照してください。 |
--add <one or more workload or component IDs> |
オプショナルな: 追加するワークロード ID またはコンポーネント ID が 1 つ以上あります。 成果物の必須コンポーネントはインストールされますが、推奨またはオプションのコンポーネントはインストールされません。 --includeRecommended や --includeOptionalを使用して、より多くのコンポーネントをグローバルに制御できます。 きめ細かい制御を行うには、ID に ;includeRecommended または ;includeOptional を追加できます (たとえば、--add Workload1;includeRecommended や --add Workload2;includeOptional)。 詳細については、ワークロード ID とコンポーネント ID ページを参照してください。 注意: --add が使用されている場合は、指定されたワークロードとコンポーネントとその依存関係のみがダウンロードされます。 --add が指定されていない場合、すべてのワークロードとコンポーネントがレイアウトにダウンロードされます。 |
--includeRecommended |
省略可能な: インストールされているワークロードに推奨されるコンポーネントが含まれますが、オプションコンポーネントは含まれません。 ワークロードは、--allWorkloads または --addで指定されます。 |
--includeOptional |
省略可能: レイアウトに含まれるワークロードのための推奨コンポーネントに加えて省略可能なコンポーネントを含めます。 ワークロードは、--addで指定されます。 |
--wait |
省略可能な: プロセスは、終了コードを返す前にインストールが完了するまで待機します。 wait は、インストールが完了するまで待機して、そのインストールからのリターン コードを処理する必要があるインストールを自動化する場合に便利です。 --wait パラメーターはブートストラップにのみ渡すことができます。インストーラー (setup.exe) ではサポートされていません。 レイアウトを更新する場合に便利です。 その他の例については、こちら参照してください。 |
--useLatestInstaller |
省略可能: 2023 年 4 月より前の Visual Studio ブートストラップ ローダーにのみ適用されるレガシ機能。 2023 年 4 月以降に出荷されたものは、既定で最新のインストーラーを使用します。 このパラメーターが存在する場合、新しいメジャー バージョンの製品に属している場合でも、Visual Studio インストーラーの最新バージョンがレイアウトに含まれます。 最新のインストーラーは、最新バージョンで利用可能な新機能やバグ修正を利用する場合に役立ちます。 詳細については、「最新のインストーラー ドキュメントを常に使用するようにレイアウトを構成する」を参照してください。 |
--config <path to *.vsconfig file> |
省略可能な: 存在する場合、Visual Studio は構成ファイル の コンテンツを使用してレイアウトを構成します。 構成ファイルへの完全修飾パスを指定してください。 |
--noWeb |
省略可能な: Visual Studio のセットアップでは、レイアウト ディレクトリ内のファイルを使用して Visual Studio をインストールし、Web からパッケージをダウンロードしません。 ユーザーがレイアウトにないコンポーネントをインストールしようとすると、セットアップは失敗します。 内部イントラネット Web サイトでホストされているレイアウトを展開する場合は、このパラメーターを使用しないでください。 詳細については、「インターネット アクセスを持たないクライアントにインストールする」を参照してください。 重要な: --noWeb パラメーターは、クライアントが Microsoft でホストされているサーバーで更新プログラムを確認するように構成されている場合、インターネットに接続されたクライアント コンピューター上の Visual Studio インストーラーによる更新プログラムのチェックを停止しません。 この場合、--noWeb は、クライアントが製品パッケージをダウンロードできないようにするだけです。 |
--verify |
省略可能な: レイアウトの内容を確認します。 破損しているファイルや見つからないファイルが一覧表示されます。 |
--fix |
省略可能な: レイアウトの内容を確認します。 ファイルが破損しているか見つからない場合は、再ダウンロードされます。 レイアウトを修正するには、インターネット アクセスが必要です。 |
--clean <one or more paths to catalogs> |
オプション: 新しいバージョンに更新されたレイアウトから古いバージョンのコンポーネントを削除します。 |
| 高度なレイアウト パラメーター | 説明 |
|---|---|
--channelId <id> |
省略可能な: VisualStudio.17.Releaseのように表される、インストールするインスタンスのチャネルの ID。 channelId はインストール コマンドに必要であり、--installPath が指定されている場合は他のコマンドでは無視されます。 --channelId の の構文例を参照してください。 |
--channelUri <uri> |
省略可能な: チャネル マニフェストの URI。 この値は更新のソースの場所を制御し、初期値はレイアウトの response.json ファイルで構成されます。 使用可能な値については、--channelUri の構文例 参照してください。 更新が不要な場合、--channelUri は存在しないファイルを指すことができます (例: --channelUri C:\doesntExist.chman)。 このパラメーターは、install コマンドに使用できます。他のコマンドでは無視されます。 |
--installChannelUri <uri> |
省略可能な: インストールに使用するチャネル マニフェストの URI。 --channelUri で指定された URI (--installChannelUri が指定されている場合に指定する必要があります) は、更新プログラムを検出するために使用されます。 このパラメーターは、install コマンドに使用できます。他のコマンドでは無視されます。 |
--installCatalogUri <uri> |
省略可能な: インストールに使用するカタログ マニフェストの URI。 指定した場合、チャネル マネージャーは、インストール チャネル マニフェストで URI を使用する前に、この URI からカタログ マニフェストをダウンロードしようとします。 このパラメーターは、オフライン インストールをサポートするために使用されます。この場合、製品カタログが既にダウンロードされた状態でレイアウト キャッシュが作成されます。 このパラメーターは、install コマンドに使用できます。他のコマンドでは無視されます。 |
--productId <id> |
省略可能な: インストールされているインスタンスの製品の ID。 このパラメーターは、通常のインストール条件で事前に設定されます。 productID は"Microsoft.VisualStudio.Product.Enterprise" のようなものです。 |
--arch all |
省略可能な: 既定では、x64 製品バイナリのみを使用してレイアウトが作成されます。 該当するワークロードの ARM バイナリを x64 バイナリと共にレイアウトに含めるには、--arch all または --arch * パラメーターを使用します。 ARM バイナリだけのレイアウトを作成するには、--arch arm64 を使用します |
--keepLayoutVersion |
オプション: レイアウトに含まれている製品バージョンを更新せずに、レイアウトに変更を適用します。 |
--locale <language-locale> |
オプション: インストーラー自体のユーザー インターフェイスの表示言語を変更します。 設定は保持されます。 詳細については、このページの「言語ロケールの一覧」セクションを参照してください。 |
--cache |
オプションの: 存在する場合、パッケージは、以降の修復のためにインストールされた後も保持されます。 これにより、以降のインストール、修復、または変更に使用するグローバル ポリシー設定がオーバーライドされます。 既定のポリシーは、パッケージをキャッシュすることです。 アンインストール コマンドの場合、これは無視されます。 詳細については、パッケージ キャッシュ 無効または移動する方法について説明します。 |
--nocache |
オプション: 存在する場合、パッケージはインストールまたは修復された後に削除されます。 必要な場合にのみ再度ダウンロードされ、使用後にもう一度削除されます。 これにより、以降のインストール、修復、または変更に使用するグローバル ポリシー設定がオーバーライドされます。 既定のポリシーは、パッケージをキャッシュすることです。 アンインストール コマンドの場合、これは無視されます。 詳細については、パッケージ キャッシュ 無効または移動する方法について説明します。 |
--noUpdateInstaller |
省略可能な: 存在する場合は、quiet が指定されたときにインストーラーがそれ自体を更新できなくなります。 インストーラーの更新が必要な場合に noUpdateInstaller が quiet で指定されている場合、インストーラーはコマンドを失敗させ、0 以外の終了コードを返します。 |
--path <name>=<path> |
省略可能な: インストールのカスタム インストール パスを指定するために使用します。 サポートされているパス名は、共有、キャッシュ、インストールです。 |
--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 つだけです。 |
ModifySettings コマンドおよびコマンド ライン パラメーター
クライアント コンピューターのインストーラーまたはブートストラップを使用し、modifySettings コマンドと必要な更新チャネルを渡すことで、更新設定を変更し、Visual Studio の特定のインスタンスの更新のソースの場所をプログラムで構成できます。
| コマンド | 説明 |
|---|---|
modifySettings |
Visual Studio の特定のインスタンスの更新設定を変更するために使用される動詞。 |
| modifySettings パラメーター | 説明 |
|---|---|
--installPath <dir> |
どのインスタンスの Visual Studio に作用するかを指定するために使用することが推奨されます。 |
--newChannelUri |
必須: チャネル マニフェストの URI。 この値は、更新プログラムの次 ソースの場所 指定します。 使用可能な値については、--channelUri の構文例 参照してください。 更新が不要な場合、--channelUri は存在しないファイルを指すことができます (例: --channelUri C:\doesntExist.chman)。 |
--channelUri |
古いチャネル マニフェストの URI。 --installPath が不明な場合に使用できます。 操作する適切なインスタンスを識別するには、productID と組み合わせて使用する必要があります。 |
--productId <id> |
--channelUri が指定され、動作する適切なインスタンスを識別するために使用される場合は、使用する必要があります。 productID は"Microsoft.VisualStudio.Product.Enterprise" のようなものです。 |
--includeRecommended |
省略可能な: modifySettings コマンド中に、このパラメーター (直後に true または false という単語を指定する必要があります) は、[更新設定] ダイアログで [更新時にインストールされたワークロードに推奨されるコンポーネントを追加する] 機能を無効にするように Visual Studio インストーラーに指示します。 |
--quiet |
省略可能な: このパラメーターは、コマンドの実行中にユーザー インターフェイスが表示されないようにします。 標準ユーザーがプログラムで使用することはできません。 |
--removeOos true |
省略可能な: modifySettings コマンド中に、このパラメーター (直後に true または false という単語を指定する必要があります) は、サポート外の状態に移行したすべてのインストール済みコンポーネントを永続的に 削除 (または削除しない) するように Visual Studio インストーラーに指示します。 マシンのセキュリティを維持するのに役立ちます。 |
構文の例:
C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true
C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet
Rollback コマンドとコマンド ライン パラメーター
Visual Studio 2022 以降では、更新プログラムのロールバックをプログラムで行うことができます。それにはクライアント コンピューター上のインストーラーを使用し、rollback コマンドをインストール パス インスタンスとともに渡します。
| コマンド | 説明 |
|---|---|
rollback |
Visual Studio の特定のインスタンスを以前にインストールした更新プログラムにロールバックするコマンド。 DisableRollback が有効になっている場合、このコマンドは機能しません。 |
| rollback パラメーター | 説明 |
|---|---|
--installPath <dir> |
推奨事項として、どの Visual Studio インスタンスに対して操作を行うべきかを指定するために を利用してください。 |
構文の例:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
Administrator Update のコマンド およびコマンド ライン パラメーター
Microsoft Update Catalog から Administrator Update をダウンロードし、それを使用してクライアント のインストールまたはレイアウトを更新できます。
レイアウトの更新
レイアウトを特定のバージョンの Visual Studio に更新する場合は、レイアウトをホストしているコンピューターに Administrator Update をダウンロードし、そのコンピューターでコマンド プロンプトを開き、次のようなコマンドを実行します。
visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout
クライアントの更新
クライアントで、管理者更新プログラムをクライアント コンピューター上のインストール ディレクトリにダウンロードする場合は、ファイルをダブルクリックするだけで更新プログラムを適用できます。 コマンド ウィンドウを開き、以下のパラメーターの一部を渡して、既定の動作を変更することもできます。
SCCM での管理者更新プログラムの構成
Microsoft Endpoint Manager (SCCM) を使用して管理者の更新プログラムを展開する場合は、次のパラメーターを使用して動作を調整するようにパッケージを変更できます。 また、クライアント コンピューター上の構成ファイルを使用してパラメーターを制御することもできます。 詳細については、「管理者更新プログラムの構成方法」を参照
レイアウト動詞が指定されていない限り、すべての Administrator Update パラメーターは "更新" コンテキストで既定で実行されることに注意してください。
| 管理者の更新パラメーター | 説明 |
|---|---|
--installerUpdateArgs [optional parameters] |
このパラメーターは、管理者の更新シナリオに関連する特定のパラメーターの "パススルー配列" として機能します。 この目的で有効になっている省略可能なパラメーターは次のとおりです。--quiet: これは管理者の更新プログラムの既定のエクスペリエンスであり、完全のためにここに記載されています。 --passive: このパラメーターは、--quiet パラメーターをオーバーライドします。 これにより、非対話型の方法で UI が表示されます。 --norestart: このパラメーターは、--quiet または --passive と組み合わせて使用する必要があり、必要な再起動が遅延します。 --noWeb: このパラメーターにより、Visual Studio がインターネットで製品の更新プログラムをチェックできなくなります。 --force: このパラメーターは、Visual Studio が使用中の場合でも、Visual Studio を強制的に閉じます。 このパラメーターは、作業の損失を引き起こす可能性があるため、注意して使用してください。 このパラメーターは、管理者の更新がユーザー コンテキストで実行される場合にのみ使用する必要があります。管理者の更新がシステム コンテキストで実行される場合は無視されます。 --installWhileDownloading: このパラメーターを使用すると、Visual Studio で製品を並行してダウンロードしてインストールできます。 これは管理者の更新プログラムの既定のエクスペリエンスであり、完全のためにここに記載されています。 --keepWindowsUpdateOn: このパラメーターにより、インストーラーがクライアント上の Windows Update エージェントをオフにできなくなります。 カタログから SCCM に管理者更新プログラムをインポートする場合は、このパラメーターを使用する必要があります。 SCCM パッケージのタイムアウトを既定の 10 分より長く設定する必要がある場合もあります。 SCCM 展開の種類を [必須] に変更すると、このパラメーターは不要になります。--downloadThenInstall: このパラメーターは、インストールする前にすべてのファイルをダウンロードするように Visual Studio に強制します。 --installWhileDownloading パラメーターとは相互に排他的です。 |
--checkPendingReboot |
どのアプリケーションが原因であるかに関係なく、マシンで保留中の再起動がある場合、更新は中止されます。 既定では、保留中の再起動を確認しません。 |
管理者更新プログラムにパラメーターを渡す構文の例:
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
チャネル コマンドとコマンド ライン パラメーターを削除する
更新に使用できるチャネルはクライアントにキャッシュされ、時間の経過と伴って混乱する可能性があります。 Visual Studio インストーラーを起動し、[使用可能な ] タブに切り替えて、製品カードの右上隅にあるX をクリックすると、更新チャネル を手動で削除できます。 removeChannel コマンドを使用して、プログラムによってチャネル (以前のレイアウトの場所など) を削除できます。 vswhere をクライアント コンピューター上でプログラムによって実行して、クライアント コンピューターにキャッシュされるチャネルを決定できます。
| コマンド | 説明 |
|---|---|
removeChannel |
クライアント コンピューターからチャネルを削除するコマンド。 |
| removeChannel パラメーター | 説明 |
|---|---|
--channelUri |
必須: 古いチャネル マニフェストの URI。 |
--quiet |
省略可能 このパラメーターを指定すると、コマンドの実行中にユーザー インターフェイスが表示されなくなります。 |
--passive |
省略可能 このパラメーターは、--quiet パラメーターをオーバーライドします。 これにより、非対話型の方法で UI が表示されます。 |
構文の例:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"
winget を使用して Visual Studio をインストールまたは変更する
Windows パッケージ マネージャー "winget" ツールを使用して、コンピューター上の Visual Studio を winget によって管理される他のパッケージと共にプログラムでインストール、変更、または更新できます。
既定では、winget は Visual Studio コア ワークロードをインストールするだけです。
winget install --id Microsoft.VisualStudio.2022.Community
ただし、インストールをカスタマイズし、初期インストール時に取得する追加のワークロードとコンポーネントを指定する場合は、winget の install コマンドと共に winget の --override スイッチを使用し、追加するワークロードとコンポーネントを含む エクスポートされた vsconfig ファイル を渡すことができます。
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"
もちろん、次のように、最初のインストール時にコンポーネントを直接含めることもできます。
winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"
コンピューターに既に Visual Studio がインストールされている場合は、winget の configure コマンド、Visual Studio PowerShell DSC プロバイダー、yaml ファイル、および .vsconfig ファイルを使用して、コンポーネントを既存の Visual Studio インストールに追加。 Winget の configure コマンドは、基本的に Visual Studio の "変更" 操作として機能します。 WinGet 構成ファイルの作成方法については、「WinGet 構成ファイルを作成する方法」を参照してください。
--override スイッチまたは Visual Studio DSC プロバイダーを winget の upgrade コマンドと共に使用することはできません。upgrade 基本的に Visual Studio の "更新" 操作として機能し、既に選択した最新バージョンのコンポーネントをインストールするためです。 更新/アップグレードを使用してコンポーネントを追加することはできません。 コンポーネントを追加するには、winget の configure を使用する必要があります。
現在、Visual Studio インストーラーの操作には管理者特権が必要であるため、winget はコマンドを完了するために必要に応じて特権を昇格するように求めるメッセージを表示します。 また、現在、winget を使用して、クライアント コンピューターに複数のエディション (つまり、異なる SKU) または同じ SKU の複数のインスタンスを同時にインストールすることはできません。 最後に、コンポーネントを追加するように構成 (変更) する場合、または最新バージョンにアップグレードする場合は、Visual Studio を閉じる必要があります。
ワークロード ID とコンポーネント ID の一覧
Visual Studio 製品別に並べ替えられたワークロード ID とコンポーネント ID の一覧については、「Visual Studio ワークロード ID とコンポーネント ID ページ」を参照してください。
言語ロケールの一覧
| 言語ロケール | 言語 |
|---|---|
| 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 | Bootstrapper コマンド ライン解析エラー |
| 5007 | 操作がブロックされました - コンピューターが要件を満たしていません |
| 8001 | Arm マシン チェックの失敗 |
| 8002 | バックグラウンド ダウンロードの事前チェック失敗 |
| 8003 | サポート対象外の選択可能なエラー |
| 8004 | ターゲット ディレクトリのエラー |
| 8005 | ソース ペイロードのエラーの確認 |
| 8006 | 実行中の Visual Studio プロセス |
| 8010 | オペレーティング システムはサポートされていません。 システム要件の を参照してください。 |
| -1073720687 | 接続エラー |
| -1073741510 | Microsoft Visual Studio インストーラーが終了しました (ユーザーまたは外部プロセスによって) |
| その他 (例: -1、1、1603) |
エラー状態が発生しました - ログで詳細を確認する |
各操作では、インストールの進行状況を示す複数のログ ファイルが %TEMP% ディレクトリに生成されます。 フォルダーを日付で並べ替え、ブートストラップ、インストーラー アプリ、セットアップ エンジンの dd_bootstrapper、dd_client、および dd_setup で始まるファイルを探します。
サポートまたはトラブルシューティング
場合によっては、問題が発生することがあります。 Visual Studio のインストールが失敗した場合は、「Visual Studio のインストールとアップグレードに関する問題のトラブルシューティング」 を参照して、詳細なガイダンスを参照してください。
その他のサポート オプションをいくつか次に示します。
- インストール関連の問題については、インストール チャット (英語のみ) サポート オプションを使用します。
- Visual Studio インストーラーと Visual Studio IDE の両方に表示される 問題の報告 ツールを使用して、製品の問題を報告します。 自分が IT 管理者であり、Visual Studio がインストールされていない場合は、IT 管理者フィードバックを送信できます。
- 機能を提案し、製品の問題を追跡し、Visual Studio Developer Communityで回答を見つけます。