Visual Studio インストールのコマンド ライン パラメーターの例
コマンド ライン パラメーター 使用して Visual Studioをインストールする方法を説明するために、ニーズに合わせてカスタマイズできるいくつかの例を次に示します。
各例では、vs_enterprise.exe
、vs_professional.exe
、および vs_community.exe
は、ダウンロード プロセスを開始する小さい (最大 1 MB) ファイルである Visual Studio ブートストラップの各エディションを表します。 使用しているエディションが異なる場合は、適切なブートストラッパー名に置き換えてください。
すべてのコマンドには管理者特権の昇格が必要であり、昇格されたプロンプトからプロセスが開始されていない場合は、ユーザー アカウント制御プロンプトが表示されます。
コマンド ラインの末尾にある ^
文字を使用して、複数の行を 1 つのコマンドに連結できます。 または、これらの行を 1 行にまとめることもできます。 PowerShell では、これに相当する文字はバックティック (`
) 文字です。
非対話型の方法でコマンドを実行するには、--passive
または --quiet
を使用できます。 これらのパラメーターの詳細については、コマンドとコマンド ライン パラメーターの ページを参照してください。
コマンド ラインを使用してインストールできるワークロードとコンポーネントの一覧については、「Visual Studio ワークロードとコンポーネント ID ページ」を参照してください。
ブートストラップと共に --installPath と --add を使用してインストールする
Visual Studio の最小限のインスタンスをインストールします。対話型のプロンプトは表示されませんが、進行状況は表示されます。
vs_enterprise.exe --installPath C:\minVS ^ --add Microsoft.VisualStudio.Workload.CoreEditor ^ --passive --norestart
Visual Studio のデスクトップ インスタンスを、フランス語の言語パックと共にサイレント インストールし、製品がインストールされている場合にのみ返します。
vs_enterprise.exe --installPath C:\desktopVS ^ --addProductLang fr-FR ^ --add Microsoft.VisualStudio.Workload.ManagedDesktop ^ --includeRecommended --quiet --wait
更新
コマンド ラインを使用して Visual Studio インスタンスを更新します。進行状況は表示され、対話型のプロンプトは表示されません。 クライアントまたはレイアウトで見つかったブートストラップを使用して、これらの一連のコマンドを 2 つの手順で実行できます。 最初のコマンドはクライアントのインストーラーを更新し、2 番目のコマンドは Visual Studio 製品を更新します。 インストーラーを更新するには管理者権限が必要であるため、管理者特権のコマンド プロンプトでこれらのコマンドを実行する必要があります。 次の例では、レイアウトの常緑ブートストラップを使用してクライアントの更新をシミュレートします。
\\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait \\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
または、クライアントのインストーラーを使用して、1 つの手順で Visual Studio インスタンスを更新することもできます。 標準ユーザー は、適切なアクセス許可が付与されている場合、インストーラーを使ってコードを用いて更新コマンドを実行できますが、--passive
や --quiet
スイッチを使用することは許可されていません。 インストーラーが存在するのと同じディレクトリからプログラムでインストーラーを開始することはできません。
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"
--wait の使用
- バッチ ファイルまたはスクリプトの
--wait
を使用して、最初のコマンドが完了するのを待ってから次のコマンドを実行します。 バッチ ファイルの場合、「コマンドライン パラメーターを使用して Visual Studio をインストールする」ページに記載されているように、%ERRORLEVEL%
環境変数にはコマンドの戻り値が含まれます。 一部のコマンド ユーティリティでは、完了を待機し、インストーラーの戻り値を取得するために、他のパラメーターが必要です。
--wait
パラメーターはブートストラップでのみサポートされます。
start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%
次のコマンドは、PowerShell スクリプト コマンド Start-Process
で --wait
を使用する例です。
$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode
または
$startInfo = New-Object System.Diagnostics.ProcessStartInfo
$startInfo.FileName = "vs_enterprise.exe"
$startInfo.Arguments = "--all --quiet --wait"
$process = New-Object System.Diagnostics.Process
$process.StartInfo = $startInfo
$process.Start()
$process.WaitForExit()
- 最初の
--wait
は Visual Studio ブートストラップによって使用され、2 番目の-Wait
は 'Start-Process' によって完了を待機するために使用されます。-PassThru
パラメーターは、インストーラーの終了コードを戻り値として使用するために、Start-Process
によって使用されます。
--layout を使用してネットワーク レイアウトまたはローカル キャッシュを作成する
Visual Studio コア エディター (最小限の Visual Studio 構成) と英語言語パックのみを含むレイアウトを作成します。 その他のレイアウト作成の例については、「Visual Studio のネットワーク インストールを作成する」ページを参照してください。
vs_professional.exe --layout "C:\VS" ^ --lang en-US ^ --add Microsoft.VisualStudio.Workload.CoreEditor ^
--all を使用して製品全体を取得する
Visual Studio Enterprise エディションで使用できるすべてのワークロードとコンポーネントの対話型インストールを開始します。
vs_enterprise.exe --all
Using --includeRecommended
Visual Studio Community エディションが既にインストールされているコンピューターにニックネームを使用して Visual Studio Professional の 2 番目のインスタンスをインストールし、Node.js 開発をサポートします。
vs_professional.exe --installPath C:\VSforNode ^ --add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
--channelURI の使用
最新のインストーラーを使用して、Visual Studio が更新プログラム 検索する場所を構成できます。 --channelUri
は、更新チャネルまたは更新プログラムのソースの場所と呼ばれます。 次の表に、channelId と channelUri の値の例と、その意味を示します。
チャンネル名 | --channelUri | --channelId |
---|---|---|
Visual Studio 2022 の現在のチャネル | https://aka.ms/vs/17/release/channel |
VisualStudio.17.Release |
Visual Studio 2022 17.0 LTSC チャネル | https://aka.ms/vs/17/release.LTSC.17.0/channel |
VisualStudio.17.Release.LTSC.17.0 |
Visual Studio 2022 プレビュー チャネル | https://aka.ms/vs/17/pre/channel |
VisualStudio.17.Preview |
Visual Studio 2019 リリース チャネル | https://aka.ms/vs/16/release/channel |
VisualStudio.16.Release |
Visual Studio 2017 リリース チャネル | https://aka.ms/vs/15/release/channel |
VisualStudio.15.Release |
カスタム レイアウト - プライベート チャネル | \\layoutserver\share\path\channelmanifest.json |
VisualStudio.17.Release (またはレイアウトのベースとなっているもの) |
カスタム レイアウトを更新チャネルとして使用する場合は、次のガイドラインに注意してください。
--channelUri
は、カスタム レイアウトの 'channelmanifest.json' ファイルを指している必要があります。- 管理者は、クライアントのレジストリ設定 を構成することで、カスタム レイアウト "プライベート チャネル" を更新設定 UI に表示する方法構成できます。
Using --remove
既定でインストールされている Visual Studio インスタンスからプロファイル ツール コンポーネントを削除します。 この例では、クライアント コンピューターに既にインストールされているインストーラーを使用します。 適切なアクセス許可を持つ Standard ユーザー プログラムでインストーラーを使用して modify コマンドを実行できますが、
--passive
または--quiet
スイッチの使用は許可されません。 インストーラーが存在するのと同じディレクトリからプログラムでインストーラーを開始することはできません。"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^ --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^ --remove Microsoft.VisualStudio.Component.DiagnosticTools ^ --passive
--layout
と同じコマンドで --remove
を使用することはできません。 つまり、レイアウトからコンポーネントを削除することはできません。
--removeOos の使用
最新のインストーラーを使用すると、インストールを変更し、既定のインストール済み Visual Studio インスタンスからサポート外の状態に移行したすべての コンポーネント 削除できます。 この例では、クライアント コンピューターに既にインストールされているインストーラーを使用して、removeOos 設定を構成します。 標準ユーザー は、適切なアクセス許可が付与されている場合、インストーラーを使用してプログラム的にモディファイ コマンドを実行できますが、--passive
または --quiet
スイッチを使用することは許可されていません。 インストーラーが存在するのと同じディレクトリからプログラムでインストーラーを開始することはできません。
"C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--removeOos true ^
--passive
更新設定を調整して、製品が更新されるたびにサポート外の状態に遷移したすべてのコンポーネントを永続的に削除します。
"C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^ --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
--path の使用
これらの例はすべて、ブートストラップを使用して新しい製品をインストールすることを前提としています。
インストール、キャッシュ、および共有パスを使用します。
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"
インストール パスとキャッシュ パスのみを使用します。
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"
インストール パスと共有パスのみを使用します。
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"
インストール パスのみを使用します。
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"
エクスポートの使用
エクスポートを使用して、インストールから選択内容を保存します。 この例では、クライアント コンピューターに既にインストールされているインストーラーを使用します。
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"
エクスポートを使用して、カスタム選択を最初から保存します。 この例では、クライアント コンピューターに既にインストールされているインストーラーを使用します。
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"
--config の使用
--config を使用して、以前に保存したインストール構成ファイルからワークロードとコンポーネントをインストールします。
vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
--config を使用して、既存のインストールにワークロードとコンポーネントを追加します。 この例では、クライアント コンピューターに既にインストールされているインストーラーを使用します。 適切なアクセス許可を持つ Standard ユーザー プログラムでインストーラーを使用して modify コマンドを実行できますが、
--passive
または--quiet
スイッチの使用は許可されません。 インストーラーが存在するのと同じディレクトリからプログラムでインストーラーを開始することはできません。"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
--config を使用してレイアウトの内容を構成します。
vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"
winget の使用
Windows パッケージ マネージャー "winget" ツールを使用して、コンピューター上の Visual Studio を winget によって管理される他のパッケージと共にプログラムでインストールまたは更新します。 インストールをカスタマイズし、他のワークロードとコンポーネントを指定するには、winget の --override
スイッチを winget の install
コマンドと共に使用し、次のように エクスポートされた vsconfig ファイル 渡します。
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config C:\my.vsconfig"
winget configure
を使用し、.yaml
ファイルを渡して、既存の Visual Studio インストールを変更することもできます。 この方法では、ここに記載されている Visual Studio PowerShell DSC プロバイダーを使用します。
サポートまたはトラブルシューティング
問題が発生することがあります。 Visual Studio のインストールが失敗した場合は、「Visual Studio のインストールとアップグレードの問題のトラブルシューティング」に記載されているステップ バイ ステップ ガイドをご覧ください。
他のいくつかのサポート オプションを次に示します。
- インストール関連の問題については、インストール チャット (英語のみ) のサポート オプションを使用します。
- Visual Studio Installer および Visual Studio IDE の両方に表示される [問題の報告] ツールを使用して、製品の問題を Microsoft に報告してください。 Visual Studio がインストールされていない IT 管理者の場合は、IT 管理者向けのフィードバックを送信できます。
- Visual Studio Developer Community で機能を提案し、製品の問題を追跡し、回答を検索できます。