Visual Studio 2017 のインストールとアップグレードの問題のトラブルシューティングTroubleshooting Visual Studio 2017 installation and upgrade issues

現象Symptoms

Visual Studio 2017 をインストールまたは更新しようとすると、操作が失敗する。When you try to install or update Visual Studio 2017, the operation fails.

回避策Workaround

この問題を回避するには、次の手順を実行します。To work around this issue, follow these steps.

手順 1 - この問題が既知の問題であるかどうかを確認するStep 1 - Check whether this problem is a known issue

Visual Studio インストーラーには、Microsoft が修正に取り組んでいる問題がいくつかあります。There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. 問題の回避策があるかどうか、リリース ノートの既知の問題に関するセクションで確認してください。To see if there's a workaround for your problem, check the Known Issues section of our release notes.

手順 2 - 開発者コミュニティを確認するStep 2 - Check with the developer community

Visual Studio 開発者コミュニティでエラー メッセージを検索します。Search on your error message with the Visual Studio Developer Community. コミュニティの他のメンバーが、問題の解決策を文書化している可能性があります。Other members of the community may have documented a solution to your problem.

手順 3 - Visual Studio インストーラーのディレクトリを削除してアップグレードの問題を修正するStep 3 - Delete the Visual Studio Installer directory to fix upgrade problems

Visual Studio インストーラーのブートストラップは、Visual Studio インストーラーの残りをインストールする最小限の軽量な実行可能ファイルです。The Visual Studio Installer bootstrapper is a minimal light-weight executable that installs the rest of the Visual Studio Installer. Visual Studio インストーラー ファイルを削除して、ブートストラップを再実行すると、いくつかの更新エラーを解決できる場合があります。Deleting Visual Studio Installer files and then rerunning the bootstrapper might solve some update failures.

注: 次のアクションを実行すると、Visual Studio インストーラー ファイルが再インストールされ、インストール メタデータがリセットされます。Note: Performing the following actions reinstalls the Visual Studio Installer files and resets the installation metadata.

  1. Visual Studio インストーラーを閉じます。Close the Visual Studio Installer.
  2. Visual Studio インストーラーのディレクトリを削除します。Delete the Visual Studio Installer directory. 通常、ディレクトリは C:\Program Files (x86)\Microsoft Visual Studio\Installer です。Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Visual Studio インストーラーのブートストラップを実行します。Run the Visual Studio Installer bootstrapper. [ダウンロード] フォルダーのブートストラップのファイル名には vs_[Visual Studio edition]__*.exe のパターンが使用されている場合があります。You may find the bootstrapper in your Downloads folder with a file name that follows a vs_[Visual Studio edition]__*.exe pattern. アプリケーションが見つからない場合は、「Visual Studio のダウンロード」ページに移動し、Visual Studio のお使いのエディションの [ダウンロード] をクリックして、ブートストラップをダウンロードできます。If you don't find that application, you can download the bootstrapper by going to the Visual Studio downloads page and clicking Download for your edition of Visual Studio. 実行可能ファイルを実行して、インストール メタデータをリセットします。Run the executable to reset your installation metadata.
  4. Visual Studio のインストールまたは更新を再度試します。Try to install or update Visual Studio again. インストーラーのエラーが続く場合は、次の手順に進みます。If the Installer continues to fail, go to the next step.

手順 4 - 問題を報告するStep 4 - Report a problem

ファイルの破損など、一部の状況では、問題をケースごとに調べなければならない場合があります。In some situations, such as those related to corrupted files, the problems may have to be looked at on a case-by-case basis:

  1. セットアップ ログを収集します。Collect your setup logs. 詳細については、「Visual Studio のインストール ログを取得する方法」をご覧ください。See How to get the Visual Studio installation logs for details.
  2. Visual Studio インストーラーを開き、[問題の報告] をクリックして、Visual Studio フィードバック ツールを開きます。Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. [フィードバックの送信] ボタンからフィードバック ツールを開くことができますYou can tab to the Provide Feedback button to open the feedback tool
  3. 問題のレポートにタイトルを付け、関連する詳細を入力します。Give your problem report a title, and provide relevant details. [次へ] をクリックして [添付ファイル] セクションに移動し、生成されたログ ファイルを添付します (通常、ファイルは %TEMP%\vslogs.zip にあります)。Click Next to go to the Attachments section, and then attach the generated log file (typically, the file is at %TEMP%\vslogs.zip).
  4. [次へ] をクリックして問題レポートを確認し、[送信] をクリックします。Click Next to review your problem report, and then click Submit.

手順 5 - InstallCleanup.exe を実行してインストール ファイルを削除するStep 5 - Run InstallCleanup.exe to remove installation files

最後の手段として、Visual Studio を削除し、すべてのインストール ファイルと製品情報を削除できます。As a last resort, you can remove Visual Studio to remove all installation files and product information.

  1. Visual Studio の削除」の説明に従ってください。Follow the instructions in Remove Visual Studio.
  2. 手順 3 - Visual Studio インストーラーのディレクトリを削除してアップグレードの問題を修正する」で説明したブートストラップを再実行します。Rerun the bootstrapper that's described in Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems.
  3. Visual Studio のインストールまたは更新を再度試します。Try to install or update Visual Studio again.

手順 6 - 問い合わせる (省略可能)Step 6 - Contact us (optional)

他のどの手順でも正常にインストールできない場合は、ライブ チャットでインストールの支援を依頼してください (英語のみ)。If none of the other steps allow you to successfully install, you can contact us by live chat for installation assistance (English only). 詳細については、Visual Studio のサポート ページをご覧ください。For details, see the Visual Studio support page.

オフライン インストーラーをトラブルシューティングする方法How to troubleshoot an offline installer

次にローカル レイアウトからのインストール時の既知の問題と、便利な回避策をいくつか紹介します。Here is a table of known issues and some workarounds when installing from a local layout that might help.

懸案事項Issue アイテムItem ソリューションSolution
ユーザーにファイルへのアクセス権がない。Users do not have access to files. アクセス許可 (ACL)permissions (ACLs) オフライン インストールを共有するに、他のユーザーに読み取りアクセス権を付与するように、必ずアクセス許可 (ACL) を調整してください。Make sure that you adjust the permissions (ACLs) so that they grant Read access to other users before you share the offline install.
新しいワークロード、コンポーネント、または言語をインストールできない。New workloads, components, or languages fail to install. --layout 部分レイアウトからインストールし、その部分レイアウトには以前ダウンロードしなかったワークロード、コンポーネント、または言語を選択した場合は、インターネットにアクセスできることを確認してください。Make sure that you have internet access if you install from a partial layout and select workloads, components, or languages that were not downloaded previously in that partial layout.

Visual Studio のインストール ログを取得する方法How to get the Visual Studio installation logs

セットアップ ログは、インストールに関する問題の多くをトラブルシューティングするために必要です。Setup logs are needed to troubleshoot most installation issues. Visual Studio インストーラーの [問題の報告] を使用して問題を送信するとき、レポートには自動でこれらのログが含まれます。When you submit an issue by using Report a Problem in the Visual Studio Installer, these logs are automatically included in your report.

Microsoft サポートに連絡する場合、Microsoft Visual Studio と .NET Framework ログ収集ツールを使用して収集したセットアップ ログの提供が必要になる場合があります。If you contact Microsoft Support, you may need to provide these setup logs by using the Microsoft Visual Studio and .NET Framework Log Collection Tool. このログ収集ツールは、Visual Studio 2017 にインストールされている .NET Framework、Windows SDK、SQL Server などのすべてのコンポーネントからセットアップ ログを収集します。The log collection tool collects setup logs from all components installed by Visual Studio 2017, including .NET Framework, Windows SDK, and SQL Server. また、コンピューター情報、Windows インストーラーのインベントリ、Visual Studio インストーラーの Windows イベント ログ情報、Windows インストーラー、システムの復元に関する情報を収集します。It also collects computer information, a Windows Installer inventory, and Windows event log information for Visual Studio Installer, Windows Installer, and System Restore.

ログを収集するには:To collect the logs:

  1. ツールをダウンロードします。Download the tool.
  2. 管理コマンド プロンプトを開きます。Open an administrative command prompt.
  3. ツールを保存したディレクトリから Collect.exe を実行します。Run Collect.exe from the directory where you saved the tool.
  4. %TEMP% ディレクトリで結果の vslogs.zip ファイルを探します (例: C:\Users\YourName\AppData\Local\Temp\vslogs.zip)。Find the resulting vslogs.zip file in your %TEMP% directory, for example, C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

注意

このツールは、インストールの実行に失敗したときと同じユーザー アカウントで実行する必要があります。The tool must be run under the same user account that the failed installation was run under. 別のユーザー アカウントでこのツールを実行する場合は、–user:<name> オプションを設定して、インストールの実行に失敗したユーザー アカウントを指定します。If you are running the tool from a different user account, set the –user:<name> option to specify the user account under which the failed installation was run. 追加オプションや使用に関する情報を収集するには、管理コマンド プロンプトで Collect.exe -? を実行します。Run Collect.exe -? from an administrator command prompt for additional options and usage information.

その他のサポート オプションMore support options

Visual Studio インストーラーおよび Visual Studio IDE の両方に表示される [問題の報告] ツールから、製品の問題を Microsoft に報告できます。You can report product issues to us via the Report a Problem tool that appears both in the Visual Studio Installer and in the Visual Studio IDE.

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

関連項目See also