レイアウトからクライアント コンピューターに Visual Studio を展開する
レイアウトをクライアント コンピューターに展開するには、まず次のトピックを考慮する必要があります。
- レイアウトを準備する: レイアウトをクライアントにインストールする準備ができていることを確認します。
- クライアント コンピューターを準備する: クライアント コンピューターが Visual Studio をインストールする準備が整っており、ユーザーに適切なアクセス許可があることを確かめます。
- クライアント コンピューターでグローバル ポリシーを構成する: 他の Visual Studio のインストール、更新、通知、ダウンロードの動作を制御します。
- 初期クライアント インストールの既定値を構成する: カスタマイズされた設定を使用してクライアントのインストールを初期化します。
- 定期的な更新を実行する: クライアント コンピューターを最新で安全な状態に保ちます。
レイアウトからクライアント コンピューターに Visual Studio をインストールする
管理者は、インストール スクリプトの一部としてプログラムで、Visual Studio のレイアウトをクライアント ワークステーションに展開できます。
ネットワーク レイアウトからインストールする
管理者アクセス許可を持つユーザーは、次のコマンドを実行して、無人モードでネットワーク レイアウトから Visual Studio をインストールできます。 レイアウトの response.json
では、インストールの既定の構成設定を指定します。
\\server\products\VS\vs_enterprise.exe --quiet --wait
ユーザーがレイアウトで使用 ''できない'' 項目を選択した場合、インストーラーにより、インターネット上の Microsoft でホストされているサーバーからのこれらの追加ファイルの供給が ''試み'' られます。 インストーラーが製品のインストール時にインターネットにアクセスしないようにするには、--noweb
スイッチを使用します。 たとえば、このコマンドを使用してインストールを実行し、クライアント コンピューターからインターネットにアクセスできないようにします。
\\server\products\VS\vs_enterprise.exe --noWeb --wait --passive --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional
Note
しばらくお待ちください。 インストーラーと製品の両方が完了していることを確認し--wait
ます。 レイアウトからクライアントをインストールまたは更新する場合、インストーラーは常に最初にインストールまたは更新されます。その後、Visual Studio 製品自体がインストールまたは更新されます。 これらのプロセスはいずれも、正常な更新と見なされるために完了する必要があります。
無人自動バッチファイルの一部としてインストールまたは更新を実行する場合、--wait
オプションを選択すると、 インストールが完了するまでプロセスvs_enterprise.exe
が待機し、終了コードが返されます。 これは、企業の管理者が完了したインストールでさらにアクションを実行するときに役立ちます (たとえば、インストールの完了後、製品キーを適用する等)。 --wait
オプションを使用すると、後続の操作が途中で開始されるのを防ぐことができます。 --wait
を使用しない場合、インストールの両方の部分が完了する前に vs_enterprise.exe
プロセスが終了し、インストール操作の状態を表していない不正確な終了コードが返されます。
内部イントラネット上の場所からインストールする
一部の企業は、地理的なパフォーマンスのボトルネックをより適切に管理し、Web キャッシュを利用するために、イントラネット上の場所でレイアウトをホストしたいと考えています。 イントラネットでホストされるレイアウトをクライアント コンピューターに展開するには、管理者アクセス許可を持つユーザーが、次のような管理者特権の PowerShell スクリプトを実行して、クライアント コンピューターへのインストールを初期化する必要があります。
#Do the initial installation from the web hosted layout onto the client in an elevated PowerShell script
#ADMIN CONFIGURATION
#Enter layout URI here
$LayoutUri = "http://MyCompanyIntranetSite/VS2022Enterprise/"
#Enter bootstrapper name which is present in layout.
$BootstrapperName = "vs_Enterprise.exe"
#Add any arguments which you intend to send to bootstrapper.
$Arguments = "--passive --wait"
#SCRIPT FUNCTIONALITY
#Forming URI for bootstrapper
Write-Verbose "LayoutUri: $LayoutUri"
$BootstrapperUri = "$LayoutUri/$BootstrapperName"
Write-Verbose "BootstrapperUri: $BootstrapperUri"
$Arguments += " --layoutUri $LayoutUri"
Write-Verbose "Arguments: $Arguments"
#Creating temp folder and download bootstrapper
$VSLayoutFolderPath = Join-Path -Path $env:TEMP -ChildPath VSLayout
$BootstrapperFile = Join-Path -Path $VSLayoutFolderPath -ChildPath $BootstrapperName
Write-Verbose "The bootstrapper path is: $BootstrapperFile"
if (Test-Path $VSLayoutFolderPath)
{
Write-Verbose "The directory exists - $VSLayoutFolderPath"
if (Test-Path $BootstrapperFile)
{
Write-Verbose "Deleting file - $BootstrapperFile"
Remove-Item $BootstrapperFile
}
}
else
{
Write-Verbose "Creating folder - $VSLayoutFolderPath"
New-Item -ItemType Directory -Path $VSLayoutFolderPath
}
Write-Verbose "Downloading bootstrapper from - $BootstrapperUri to $BootstrapperFile"
Invoke-WebRequest -Uri $BootstrapperUri -OutFile $BootstrapperFile
Write-Verbose "Starting bootstrapper -$BootstrapperFile with arguments $Arguments"
start-process $BootstrapperFile $Arguments
クライアント コンピューターを準備する
アクセス許可
インストールを実行しているユーザーまたはシステム アカウントが、レイアウトを含むネットワーク共有に適切にアクセスできることを確認します。 詳細については、「Visual Studio をインストールまたは使用するときのネットワーク関連のエラーのトラブルシューティング」ページを参照してください。
インターネットにアクセスできないクライアントにインストールする
オフライン クライアント コンピューターに適切な証明書がインストールされていることを確認する必要があります。
レイアウトからインストールすると、クライアント上のインストーラーによって、常にレイアウトの場所で Visual Studio パッケージが検索されます。 ただし、インストーラーによって、レイアウトに含まれて ''いない'' コンポーネントのインストールが試みられると、更新ソースから Visual Studio パッケージの取得が試みられます。多くの場合、管理者がそれ自体を指すように構成します。
Visual Studio インストーラーによる、Web 上の Microsoft でホストされているサーバーからの欠落しているコンテンツのダウンロードの試行を明示的に禁止する場合は、--noWeb
パラメーターを使用できます。 --noWeb
が使用されていて、インストール対象として選択されているコンピューターがレイアウトにない場合、セットアップは失敗します。 また、--noWeb
が使用されていて、レイアウトがファイル ネットワーク共有ではなくイントラネット Web サーバーでホストされている場合、セットアップは失敗します。
多くの場合、--noweb
スイッチを使用すると、"次のパラメーターと一致する製品が見つかりません" というエラー メッセージが修正されます。
コンピューター リソース
完全なインストール パスが 80 文字未満であり、コンピューターに十分な記憶域があることを確認します。 Visual Studio の完全なインストールでは、少なくとも 45 から 50 GB のディスク領域が必要です。
エラー コード
--wait
パラメーターを使用した場合、操作の結果に応じて、%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 プロセスを実行しています |
8010 | オペレーティング システムがサポートされていません。 システム要件 を参照してください |
-1073720687 | 接続エラー |
-1073741510 | Microsoft Visual Studio インストーラーが終了しました (ユーザーか外部プロセスにより) |
その他 (例: -1、1、1603) |
失敗の状態が発生しました。詳細については、ログを参照してください |
レイアウトの展開のサポートを受ける
レイアウトをクライアント コンピューターに展開するときに問題が発生した場合は、Microsoft にお知らせください。 Visual Studio インストーラーおよび Visual Studio IDE の両方に表示される [問題の報告] ツールから、製品の問題を Microsoft に報告してください。 自分は IT 管理者であるのに、Visual Studio がインストールされていない場合は、こちらで IT 管理者フィードバックを送信できます。 このツールを使用すると、問題の診断と解決に役立つ VS 収集ツールからログを送信できる場合に便利です。
インストール関連の問題については、インストール チャット (英語のみ) のサポート オプションも用意されています。
他にも利用可能なサポート オプションがあります。 「Visual Studio 開発者コミュニティ」を参照してください。
関連するコンテンツ
- Visual Studio 管理者ガイド
- Visual Studio のネットワーク ベース インストールを更新する
- Visual Studio をインストールまたは使用するときのネットワーク関連のエラーのトラブルシューティング
- ネットワーク ベースの Visual Studio 配置の更新プログラムを制御する
- Visual Studio のエンタープライズ展開にポリシーを構成する
- Visual Studio の製品ライフサイクルとサービス
- コマンド ライン パラメーターを使用して Visual Studio をインストールする
- Visual Studio のワークロードとコンポーネント ID
- Visual Studio オフライン インストールに必要な証明書をインストールする