次の方法で共有


Visual Studio インストールのコマンド ライン パラメーターの例

コマンド ライン パラメーター 使用して Visual Studioをインストールする方法を説明するために、ニーズに合わせてカスタマイズできるいくつかの例を次に示します。

各例では、vs_enterprise.exevs_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 (またはレイアウトのベースとなっているもの)

カスタム レイアウトを更新チャネルとして使用する場合は、次のガイドラインに注意してください。

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 のインストールとアップグレードの問題のトラブルシューティング」に記載されているステップ バイ ステップ ガイドをご覧ください。

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