Visual Studio のネットワーク ベース インストールを更新するUpdate a network-based installation of Visual Studio

ネットワーク インストール レイアウトを Visual Studio の最新のインストール ポイントとして使用できるように、また、クライアント ワークステーションに既に配置されているインストールを保持するために、最新の製品の更新プログラムを使って Visual Studio のネットワーク インストール レイアウトを更新できます。It's possible to update a network installation layout of Visual Studio with the latest product updates so that it can be used both as an installation point for the latest update of Visual Studio and also to maintain installations that are already deployed to client workstations.

ネットワーク レイアウトの更新方法How to update a network layout

最新の更新プログラムが含まれるように、ネットワーク インストールの共有を更新するには、--layout コマンドを実行して、更新されたパッケージの増分をダウンロードします。To refresh your network install share so that it includes the latest updates, run the --layout command to incrementally download updated packages.

最初にネットワーク レイアウトを作成したときに部分的レイアウトを選択した場合は、その設定が保存されます。If you selected a partial layout when you first created the network layout, those settings are saved. 以後のレイアウト コマンドでは以前のオプションと、指定した新しいすべてのオプションが使用されます。Any future layout commands use the previous options plus any new options that you specify. (これは 15.3 の新機能です。)古いバージョンのレイアウトを使用している場合は、コンテンツの更新時に最初にネットワーク インストール レイアウトを作成したときに使用したものと同じコマンドライン パラメーター (つまり、同じワークロードと言語) を使用してください。(This is new in 15.3.) If you are using a layout of an older version, you should use the same command-line parameters that you used when you first created the network install layout (in other words, the same workloads and languages) to update its content.

ファイル共有上にレイアウトをホストしている場合は、レイアウトのプライベート コピーを更新し (例: c:\vs2017offline)、すべての更新されたコンテンツがダウンロードされた後に、ファイル共有にコピーします (例: \server\products\VS2017)。If you host a layout on a file share, you should update a private copy of the layout (for example, c:\vs2017offline) and then, after all of the updated content is downloaded, copy it to your file share (for example, \server\products\VS2017). この操作を行わない場合、レイアウトの更新中にユーザーがセットアップを実行しても、レイアウトが完全に更新されていないため、レイアウトからすべてのコンテンツを取得できない可能性が非常に高くなります。If you don't do this, there is a greater chance that any users who run Setup while you are updating the layout might not be able to get all of the content from the layout because it is not yet completely updated.

レイアウトを作成して更新する方法について順番に説明します。Let's walk through how to create and then update a layout:

  • 最初に、英語のみ対象の 1 つのワークロードを含むレイアウトの作成例を示します。First, here's an example of how to create a layout with one workload for English only:

    vs_enterprise.exe --layout c:\VS2017Layout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US
    
  • 以下は、同じレイアウトを新しいバージョンに更新する場合です。Here's how to update that same layout to a newer version. 追加のコマンド ライン パラメーターを指定する必要はありません。You don't have to specify any additional command-line parameters. このレイアウト フォルダーに保存されている以前の設定が、後続のすべてのレイアウト コマンドで使用されます。The previous settings were saved and will be used by any subsequent layout commands in this layout folder.

    vs_enterprise.exe --layout c:\VS2017Layout  
    
  • ここでは、お使いのレイアウトを無人方式で新しいバージョンに更新する方法を示します。Here's how to update your layout to a newer version in an unattended manner. レイアウト操作は、新しいコンソール ウィンドウでセットアップ プロセスを実行します。The layout operation runs the setup process in a new console window. ユーザーが最終的な結果と、発生した可能性のあるエラーの概要を確認できるように、ウィンドウは開いたままになります。The window is left open so users can see the final result and a summary of any errors that might have occurred. 無人方式でレイアウト操作を実行している場合は (たとえば、定期的に実行してお使いのレイアウトを最新バージョンに更新するスクリプトがある場合)、--passive パラメーターを使うと、プロセスは自動的にウィンドウを閉じます。If you are performing a layout operation in an unattended manner (for example, you have a script that is regularly run to update your layout to the latest version), then use the --passive parameter and the process will automatically close the window.

    vs_enterprise.exe --layout c:\VS2017Layout --passive
    
  • 次に、追加のワークロードとローカライズされた言語を追加する方法を示します。Here's how to add an additional workload and localized language. (このコマンドでは、Azure のワークロードを追加しています。)これで、Managed Desktop と Azure の両方がこのレイアウトに含まれるようになります。(This command adds the Azure workload.) Now both Managed Desktop and Azure are included in this layout. 英語とドイツ語の言語リソースもすべてのワークロードに含まれます。The language resources for English and German are also included for all these workloads. さらに、レイアウトが利用可能な最新バージョンに更新されます。And, the layout is updated to the latest available version.

    vs_enterprise.exe --layout c:\VS2017Layout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE
    
  • 最後に、バージョンを更新せずに追加のワークロードとローカライズされた言語を追加する方法を示します。And finally, here's how to add an additional workload and localized language without updating the version. (このコマンドでは、ASP.NET Web のワークロードを追加しています。)これで、Managed Desktop、Azure、ASP.NET Web のワークロードがこのレイアウトに含まれるようになりました。(This command adds the ASP.NET & Web workload.) Now the Managed Desktop, Azure, and ASP.NET & Web workloads are included in this layout. 英語、ドイツ語、フランス語の言語リソースもすべてのワークロードに含まれます。The language resources for English, German, and French are also included for all these workloads. ただし、このコマンドが実行されたときにレイアウトが利用可能な最新バージョンに更新されませんでした。However, the layout was not updated to the latest available version when this command was run. そのため、既存のバージョンのままになります。It remains at the existing version.

    vs_enterprise.exe --layout c:\VS2017Layout --add Microsoft.VisualStudio.Workload.NetWeb --lang fr-FR --keepLayoutVersion
    

クライアント マシンに更新を配置する方法How to deploy an update to client machines

ネットワーク環境が構成される方法によって、更新プログラムをエンタープライズ管理者が配置することも、クライアント マシンから開始することもできます。Depending on how your network environment is configured, an update can either be deployed by an enterprise administrator or initiated from a client machine.

  • ユーザーは、オフラインのインストール フォルダーからインストールした Visual Studio インスタンスを更新することができます。Users can update a Visual Studio instance that was installed from an offline installation folder:

    • Visual Studio インストーラーを実行します。Run the Visual Studio Installer.
    • 次に、[更新] をクリックします。Then, click Update.
  • 管理者は、次の 2 つの別々のコマンドを使用して、ユーザーの相互作用なしに、Visual Studio のクライアント展開を更新できます。Administrators can update client deployments of Visual Studio without any user interaction with two separate commands:

    • 最初に、Visual Studio インストーラーを更新します。First, update the Visual Studio installer:
      vs_enterprise.exe --quiet --update
    • 次に、Visual Studio アプリケーション自体を更新します。Then, update the Visual Studio application itself:
      vs_enterprise.exe update --installPath "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise" --quiet --wait --norestart

注意

vswhere.exe コマンドを使用して、クライアント コンピューター上にある Visual Studio の既存のインスタンスのインストール パスを特定します。Use the vswhere.exe command to identify the install path of an existing instance of Visual Studio on a client machine.

ヒント

更新通知をユーザーに表示するときの制御方法の詳細については、「Control updates to network-based Visual Studio deployments」 (ネットワーク ベースの Visual Studio 配置の更新プログラムを制御する) を参照してください。For details on how to control when update notifications are presented to users, see Control updates to network-based Visual Studio deployments.

レイアウトを検証する方法How to verify a layout

--verify を使用して指定したオフライン キャッシュに対する検証を行います。Use --verify to perform verification on the offline cache supplied. パッケージ ファイルが見つからないか、無効であるかどうかがチェックされます。It checks if packages files are either missing or invalid. 検証の最後に、見つからないファイルと無効なファイルのリストを出力します。At the end of the verification, it prints the list of missing files and invalid files.

vs_enterprise.exe --layout <layoutDir> --verify

layoutDir 内の vs_enterprise.exe を呼び出すことができます。The vs_enterprise.exe can be invoked inside the layoutDir.

注意

レイアウト オフライン キャッシュには --verify オプションで必要とされるいくつかの重要なメタデータ ファイルが必要です。Some important metadata files that are needed by the --verify option must be in the layout offline cache. これらのメタデータ ファイルが見つからない場合、"--verify" が実行できず、セットアップでエラーが返されます。If these metadata files are missing, "--verify" cannot run and Setup gives you an error. このエラーが発生した場合、新しいオフライン レイアウトを別のフォルダー (または同じオフライン キャッシュ フォルダー) に再作成してください。If you experience this error, re-create a new offline layout to a different folder (or to the same offline cache folder. そのためには、初期オフライン レイアウトの作成に使用したものと同じレイアウト コマンドを実行します。To so do, run the same layout command that you used to create the initial offline layout. たとえば、Vs_enterprise.exe --layout <layoutDir> のようにします。For example, Vs_enterprise.exe --layout <layoutDir>.

Microsoft は定期的に Visual Studio の更新プログラムを提供しているため、作成した新しいレイアウトが初期レイアウトと同じバージョンでない可能性があります。Microsoft ships updates to Visual Studio periodically, so the new layout that you create might not be the same version as the initial layout.

レイアウトの修正方法How to fix a layout

--fix を使用して --verify と同じ検証を実行して、特定された問題の修正も試みます。Use --fix to perform the same verification as --verify and also try to fix the identified issues. --fix の処理にはインターネット接続が必要なため、--fix を呼び出す前に、コンピューターがインターネットに接続していることを確認してください。The --fix process needs an Internet connection, so make sure your machine is connected to the Internet before you invoke --fix.

vs_enterprise.exe --layout <layoutDir> --fix

layoutDir 内の vs_enterprise.exe を呼び出すことができます。The vs_enterprise.exe can be invoked inside the layoutDir.

以前のバージョンをレイアウトから削除する方法How to remove older versions from a layout

オフライン キャッシュにレイアウトの更新を実行した後、レイアウト キャッシュ フォルダーには最新の Visual Studio のインストールに不要な古いパッケージがいくつか含まれている場合があります。After you perform layout updates to an offline cache, the layout cache folder may have some obsolete packages that are no longer needed by the latest Visual Studio installation. --clean オプションを使用すると、オフライン キャッシュ フォルダーから古いパッケージを削除できます。You can use the --clean option to remove obsolete packages from an offline cache folder.

これを行うには、その古いパッケージが含まれるカタログ マニフェストのファイル パスが必要になります。To do this, you'll need the file path(s) to catalog manifest(s) that contain those obsolete packages. カタログ マニフェストは、オフライン レイアウト キャッシュの "Archive" フォルダーにあります。You can find the catalog manifests in an "Archive" folder in the offline layout cache. これは、レイアウトの更新時に保存されたものです。They are saved there when you update a layout. "Archive" フォルダーには、1 つまたは複数の "GUID" 名フォルダーがあり、そのそれぞれに古いカタログ マニフェストが含まれています。In the "Archive" folder, there is one or more "GUID" named folders, each of which contains an obsolete catalog manifest. "GUID" フォルダーの数は、オフライン キャッシュに対する更新プログラムの数と同じである必要があります。The number of "GUID" folders should be the same as the number of updates made to your offline cache.

各 "GUID" フォルダー内にいくつかのファイルが保存されています。A few files are saved inside each "GUID" folder. 特に関係のあるファイルが "catalog.json" ファイルと "version.txt" ファイルの 2 つです。The two files of most interest are a "catalog.json" file and a "version.txt" file. "catalog.json" ファイルは --clean オプションに渡す必要がある古いカタログ マニフェストです。The "catalog.json" file is the obsolete catalog manifest you'll need to pass to the --clean option. その他の version.txt ファイルには、この古いカタログ マニフェストのバージョンが含まれています。The other version.txt file contains the version of this obsolete catalog manifest. バージョン番号に基づき、このカタログ マニフェストから古いパッケージを削除するかどうかを決定できます。Based on the version number, you can decide whether you want to remove obsolete packages from this catalog manifest. 他の "GUID" フォルダーでも同じように行います。You can do the same as you go through the other "GUID" folders. クリーンアップを実行するカタログが決まったら、そのカタログのファイル パスを指定して --clean カタログを実行します。After you make the decision on the catalog(s) you want to clean, run the --clean command by supplying the files paths to these catalogs.

--clean オプションを使用するいくつかの例を示します。Here are a few examples of how to use the --clean option:

vs_enterprise.exe --layout <layoutDir> --clean <file-path-of-catalog1> <file-path-of-catalog2> …
vs_enterprise.exe --layout <layoutDir> --clean <file-path-of-catalog1> --clean <file-path-of-catalog2> …

<layoutDir> 内の vs_enterprise.exe を呼び出すことができます。You can also invoke vs_enterprise.exe inside the <layoutDir>. 次に例を示します。Here's an example:

c:\VS2017Layout\vs_enterprise.exe --layout c:\VS2017Layout --clean c:\VS2017Layout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VS2017Layout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

このコマンドを実行すると、セットアップでオフライン キャッシュ フォルダーが分析され、削除されるファイルのリストが検索されます。When you execute this command, Setup analyzes your offline cache folder to find the list of files that it will remove. このリストで、削除されるファイルを確認し、削除を確定できます。You will then have a chance to review the files that are going to be deleted and confirm the deletions.

サポートを受けるGet support

ときには、問題が発生してしまうことがあります。Sometimes, things can go wrong. Visual Studio のインストールが失敗した場合は、「Troubleshooting Visual Studio 2017 installation and upgrade issues (Visual Studio 2017 のインストールとアップグレードの問題のトラブルシューティング)」ページをご覧ください。If your Visual Studio installation fails, see the Troubleshooting Visual Studio 2017 installation and upgrade issues page. トラブルシューティングの手順でも解決しない場合は、ライブ チャットでインストールの支援を依頼してください (英語のみ)。If none of the troubleshooting steps help, you can contact us by live chat for installation assistance (English only). 詳細については、Visual Studio のサポート ページをご覧ください。For details, see the Visual Studio support page.

他のいくつかのサポート オプションを次に示します。Here are a few more support options:

関連項目See also