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

Important

インストールに関する問題がある場合、Having a problem installing? Microsoft によるサポートを受けられます。We can help. ライブ チャット (英語のみ) のサポート オプションが用意されています。We offer a live chat (English only) support option.

このトラブルシューティング ガイドには、インストールに関する問題のほとんどを解決できるステップ バイ ステップの手順が含まれています。This troubleshooting guide includes step-by-step instructions that should resolve most installation issues.

オンライン インストールのトラブルシューティング方法How to troubleshoot an online installation

次の手順は、通常のオンライン インストール用に最適化されています。The following steps are optimized for a typical online installation. オフライン インストールに影響を与える問題については、「オフライン インストールのトラブルシューティング方法」をご覧ください。For an issue that affects an offline installation, please see How to troubleshoot an offline installation.

手順 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.

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 might 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.

Note

次のアクションを実行すると、Visual Studio インストーラー ファイルが再インストールされ、インストール メタデータがリセットされます。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 might 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. 次に、実行可能ファイルを実行して、インストール メタデータをリセットします。Then, 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.
  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 might 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. 次に、実行可能ファイルを実行して、インストール メタデータをリセットします。Then, 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 might have to be looked at on a case-by-case basis. サポートに役立つように、次のことを実行します。To help us help you, please do the following:

  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.
  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)

前の手順のいずれに従っても Visual Studio のインストールまたはアップグレードに失敗する場合は、詳細なサポートのためにライブ チャット サポート オプション (英語のみ) を使用してお問い合わせください。If none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our live chat support option (English only) for further assistance.

オフライン インストールのトラブルシューティング方法How to troubleshoot an offline installation

ローカル レイアウトからインストールする際に役立つ可能性がある、既知の問題と回避策を次の表に示します。Here is a table of known issues and some workarounds that might help you when you install from a local layout.

懸案事項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 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 might need to provide these setup logs by using the Microsoft Visual Studio and .NET Framework Log Collection Tool. このログ収集ツールは、Visual Studio にインストールされている .NET Framework、Windows SDK、SQL Server などのすべてのコンポーネントからセットアップ ログを収集します。The log collection tool collects setup logs from all components installed by Visual Studio, 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.

Note

このツールは、インストールの実行に失敗したときと同じユーザー アカウントで実行する必要があります。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.

ライブ ヘルプの取得Get live help

このトラブルシューティング ガイドに記載されているソリューションの一覧に従っても Visual Studio のインストールまたはアップグレードに失敗する場合は、詳細なサポートのためにライブ チャット サポート オプション (英語のみ) を使用してください。If the solutions listed in this troubleshooting guide do not help you to successfully install or upgrade Visual Studio, use our live chat support option (English only) for further assistance.

関連項目See also