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

適用対象: Visual Studio

このトラブルシューティング ガイドには、Visual Studio のインストールとアップグレードに関する一般的な問題を解決するための詳細な手順が含まれています。

オンライン インストールまたは更新プログラム

一般的なオンライン インストールの問題に適用される次の解決策を順番に試してください。

1. この問題が既知の問題であるかどうかを確認する

最初に確認することは、発生している問題が、Microsoft が修正に取り組んでいる Visual Studio インストーラーの既知の問題であるかどうかです。

問題の回避策があるかどうかを確認するには、「 Visual Studio 2019 の問題」と 「 Visual Studio 2022 の問題を確認してください。

2. Visual Studio の修復を試す

インストールを修復してみてください。 これは、多くの一般的な更新プログラムの問題を修正する可能性があります。

3. 開発者コミュニティがエラーについて何を言っているかを確認する

修復しても問題が解決しない場合は、Visual Studio Developer Community でエラー メッセージを検索します。 コミュニティの他のメンバーが、問題の解決策か回避策を見つけている可能性があります。

4. インストーラーのフォルダーを削除する (更新に関する問題)

更新時に問題が発生した場合は、Visual Studio インストーラーのフォルダーを削除してから、インストール ブートストラップを再実行してみると、特定の更新エラーが解決する場合があります。 それを行うと、Visual Studio インストーラー ファイルが再インストールされ、インストール メタデータがリセットされます。

1. Visual Studio インストーラーを閉じます。
2. Visual Studio インストーラーのフォルダーを削除します。 通常、フォルダー パスは C:\Program Files (x86)\Microsoft Visual Studio\Installer です。
3. Visual Studio インストーラーのブートストラップを実行します。 ファイル名が VisualStudioSetup.exe (Visual Studio 2022) または vs_<edition>*.exe (Visual Studio 2019 以前のバージョン) のダウンロード フォルダーにブートストラップが含まれている場合があります。 または、 Visual Studio 2022、 Visual Studio 2019 以前のバージョン ダウンロード ページからブートストラップをダウンロード。 次に、実行可能ファイルを実行して、インストール メタデータをリセットします。
4. Visual Studio のインストールまたは更新を再度試します。 Visual Studio インストーラーが引き続き失敗する場合は、問題サポートする必要があります。

5. サポートに問題を報告する

ファイルが破損している状況では、問題によってはケース バイ ケースのトラブルシューティングが必要になる場合があります。

Microsoft サポートに問題を送信するには、次の手順に従ってください。

• Visual Studio 2022 の場合:

  1. セットアップ ログを収集します。 詳細については、「Visual Studio のインストール ログを取得する方法」をご覧ください。

  2. Visual Studio インストーラーを開き、[問題の報告] を選択して、Visual Studio フィードバック ツールを開きます。

     

  3. 問題レポートにタイトルを付け、関連する詳細を入力します。 Visual Studio インストーラーの最新のセットアップ ログは、問題レポートの追加の添付ファイルセクションに自動的に追加されます。

  4. [送信] を選択します。

• Visual Studio 2019 以前のバージョンの場合:

  1. セットアップ ログを収集します。 詳細については、「Visual Studio のインストール ログを取得する方法」をご覧ください。
  2. Visual Studio インストーラーを開き、[問題の報告] を選択して Visual Studio フィードバック ツールを開きます。
  3. 問題のレポートにタイトルを付け、関連する詳細を入力します。 [次へ] を選択して Attachments セクションに移動し、生成されたログ ファイルを添付します (通常、ファイルは%TEMP%\vslogs.zipにあります)。
  4. [次へ を選択して問題レポートを確認し、Submit を選択します。

6. すべての Visual Studio インストール ファイルを削除する

最後の手段として、すべての Visual Studio インストール ファイルと製品情報を削除できます。

1. InstallCleanup.exeを使用してすべてを削除します。
2. Visual Studio インストーラーのブートストラップを再実行します。 ファイル名が VisualStudioSetup.exe (Visual Studio 2022) または vs<edition>*.exe_ (Visual Studio 2019 以前のバージョン) のDownloads フォルダーにブートストラップが含まれている場合があります。 または、 Visual Studio 2022、 Visual Studio 2019 以前のバージョン ダウンロード ページからブートストラップをダウンロード。
3. Visual Studio の再インストールを試みます。

7. 以前のインストールにロールバックする (Visual Studio 2022 のみ)

ロールバックを試みる前に、Visual Studio の ロールバック機能の詳細を確認してください。

前の手順で Visual Studio を正常にアップグレードできない場合は、以前にインストールしたバージョンにロールバックできます。 Visual Studio 2022 バージョン 17.4 以降では、元のバージョンが現在のチャネル バージョン 17.1.7 以降、または 17.0 Fall 2021 LTSC チャネル 17.0.10 以降にある場合は、以前にインストールしたバージョンにロールバックできます。

以前にインストールしたバージョンにロールバックするには、Visual Studio インストーラーを使用するか、コマンド ラインを使用します。

Visual Studio インストーラーでロールバックするには、次の手順に従います。

1. コンピューターで Visual Studio インストーラーを起動します。

2. インストーラーで、インストールした Visual Studio のエディションを探します。

3. その他 を選択します。

4. 以前のバージョンへのロールバックを選択します。

   

5. OK を選択して確認します。

8. ライブ チャットに問い合わせる

前の手順のいずれに従っても Visual Studio のインストールまたはアップグレードに失敗する場合は、詳細なサポートのためにライブ チャット サポート オプション (英語のみ) を使用してお問い合わせください。

ネットワーク レイアウトまたはオフライン インストール

ネットワーク インストールに関する問題を解決するには、「エラー コード」または「Visual Studio をインストールまたは使用するときのネットワーク関連のエラーのトラブルシューティング」を参照してください。

管理者の更新

さまざまな状況により、管理者の更新プログラムが正しく適用されない場合があります。 詳細については、「 Administrator 更新プログラムのトラブルシューティング エラー コードを参照してください。

次の方法を使用して、Visual Studio の管理者向け更新プログラムに関するフィードバックを提供したり、更新プログラムに影響する問題を報告したりできます。

• Visual Studio セットアップ Q&A フォーラムでコミュニティに質問してください。
• Visual Studio のサポート ページにアクセスし、ご自分の問題がよくあるご質問に記載されているかどうかを確認します。
• エクスペリエンスについて、Visual Studio チームに機能のフィードバックを提供するか、問題を報告してください。
• Microsoft の組織のテクニカル アカウント マネージャーにお問い合わせください。

Microsoft サポートのためにインストール ログを収集する

Microsoft サポートに連絡する場合、Microsoft Visual Studio と .NET Framework ログ収集ツールを使用して、これらのセットアップ ログを収集するよう求められる場合があります。 このログ収集ツールは、Visual Studio にインストールされている .NET Framework、Windows SDK、SQL Server などのすべてのコンポーネントからセットアップ ログを収集します。 また、コンピューター情報、Windows インストーラーのインベントリ、Visual Studio インストーラーの Windows イベント ログ情報、Windows インストーラー、システムの復元に関する情報を収集します。

ログを収集するには、次の手順に従います。

1. ツールをダウンロードします。

2. 管理コマンド プロンプトを開きます。

3. ツールを保存したフォルダーで Collect.exe を実行します。

   このツールは、インストールの実行に失敗したときと同じユーザー アカウントで実行する必要があります。 別のユーザー アカウントからツールを実行している場合は、-user:<name> オプションを設定して、失敗したインストールが実行されたユーザー アカウントを明示します。 管理者コマンド プロンプトから Collect.exe -? を実行して、その他のオプションと使用状況の情報を確認します。

このツールは、%TEMP% フォルダー (通常は C:\Users\YourName\AppData\Local\Temp\vslogs.zip) にvslogs.zip ファイルを生成します。

Visual Studio インストーラーと Visual Studio IDE の両方に表示される 問題 ツールを使用して、製品の問題を報告します。 IT 管理者であり、Visual Studio がインストールされていない場合は、 IT 管理者フィードバックをここに送信できます。

WebView2 のインストールに関する問題

組織のグループ ポリシーによって WebView2 コンポーネントのインストールがブロックされている場合、インストーラーでは WebView2 をインストールする必要があるため、Visual Studio をインストールすることはできません。 このような場合は、次のポリシーを確認してください。

• Microsoft Edge 'Install (WebView)' が構成されている場合は、これにより WebView2 をインストールできるかどうかが決まります。
• Microsoft Edge 'Install (WebView)' ポリシーが構成されていない場合、 Microsoft Edge 'InstallDefault' ポリシーによって、WebView2 をインストールできるかどうかが決まります。