📣 フィードバックをお待ちしております。この アンケートの を完了し、レイアウトエクスペリエンスを向上させる方法をお知らせください。ご支援をいただき、ありがとうございます。
レイアウトをクライアント コンピューターに展開するには、まず次のトピックを考慮する必要があります。
- レイアウトを準備する: レイアウトをクライアントにインストールする準備ができていることを確認します。
- クライアント マシンを準備する: クライアント マシンが 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
注
しばらくお待ちください。 インストーラーと製品の両方が完了するように --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 | Bootstrapper コマンド ライン解析エラー |
5007 | 操作がブロックされました - コンピューターが要件を満たしていません |
8001 | Arm マシン チェックの失敗 |
8002 | バックグラウンド ダウンロードの事前チェックに失敗しました |
8003 | サポート対象外の選択可能なエラー |
8004 | ターゲット ディレクトリのエラー |
8005 | ソース ペイロードのエラーの確認 |
8006 | 実行中の Visual Studio プロセス |
8010 | オペレーティング システムはサポートされていません。 システム要件の を参照してください。 |
-1073720687 | 接続エラー |
-1073741510 | Microsoft Visual Studio インストーラーが終了しました (ユーザーまたは外部プロセスによって) |
その他 (例: -1、1、1603) |
エラー状態が発生しました - ログで詳細を確認する |
レイアウトの展開のサポートを受ける
レイアウトをクライアント コンピューターに展開するときに問題が発生した場合は、そのことを確認する必要があります。 私たちに伝える最善の方法は、Visual Studio インストーラーと Visual Studio IDE の両方に表示される 問題の報告 ツールを使用することです。 IT 管理者であり、Visual Studio がインストールされていない場合は、で IT 管理者フィードバック送信できます。 このツールを使用する場合は、 VS Collect ツールでログを送信できると便利です。これは、問題の診断と修正に役立ちます。
また、インストール関連の問題に対する インストール チャット (英語のみ) のサポート オプションも提供しています。
その他のサポート オプションも用意されています。 Visual Studio Developer Communityをご覧ください。
関連コンテンツ
- Visual Studio 管理者ガイド
- Visual Studio のネットワーク ベースのインストールを更新する
- Visual Studio をインストールまたは使用するときのネットワーク関連エラーのトラブルシューティング
- ネットワーク ベースの Visual Studio デプロイの更新プログラムを制御
- Visual Studio のエンタープライズ 展開のポリシーを構成する
- Visual Studio 製品のライフサイクルとメンテナンス
- コマンドライン パラメーターを使用して Visual Studio をインストールする
- Visual Studio のワークロードIDとコンポーネントID
- Visual Studio のオフライン インストール に必要な証明書のインストール