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

現象

Microsoft Visual Studio 2017 をインストールまたは更新しようとすると、操作が失敗する。

回避策

この問題を回避するには、次の手順を実行します。

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

Visual Studio インストーラーには、Microsoft が修正に取り組んでいる問題がいくつかあります。 問題の回避策があるかどうか、リリース ノートの既知の問題に関するセクションで確認してください。

手順 2 - 開発者コミュニティを確認する

Visual Studio の開発者コミュニティ でエラー メッセージを検索してください。 コミュニティの他のメンバーが、問題の解決策を文書化している可能性があります。

手順 3 - Visual Studio インストーラーのディレクトリを削除してアップグレードの問題を修正する

Visual Studio インストーラーのブートストラップは、Visual Studio インストーラーの残りをインストールする最小限の軽量な実行可能ファイルです。 Visual Studio インストーラー ファイルを削除して、ブートストラップを再実行すると、いくつかの更新エラーを解決できる場合があります。 この操作を行うには、次の手順に従います。

  1. Visual Studio インストーラーを閉じます。
  2. Visual Studio インストーラーのディレクトリを削除します。 通常、ディレクトリは、C:\Program Files (x86)\Microsoft Visual Studio\Installer にあります。
  3. Visual Studio インストーラーのブートストラップを実行します。 [ダウンロード] フォルダーのブートストラップのファイル名には vs_[Visual Studio edition]__*.exe のパターンが使用されている場合があります。 アプリケーションが見つからない場合は、「Visual Studio のダウンロード」ページに移動し、Visual Studio のお使いのエディションの [ダウンロード] をクリックすると、ブートストラップをダウンロードできます。 この実行可能ファイルを実行して、インストールのメタデータをリセットします。
  4. Visual Studio のインストールまたは更新を再度試します。 インストーラーのエラーが続く場合は、この次の手順 4 に進んでください。
    注: この手順では Visual Studio インストーラー ファイルが再インストールされ、インストールのメタデータがリセットされます。

手順 4 - 問題を報告する

ファイルの破損など、一部の状況では、問題をケースごとに調べなければならない場合があります。

  1. Microsoft Visual Studio および .NET Framework のログ収集ツールをダウンロードして、実行します。 このツールは、Visual Studio、.NET Framework、SQL Server のインストールで入手できるセットアップ ログを収集し、コンパイルします。
  2. Visual Studio インストーラーを開き、[問題の報告] をクリックして、Visual Studio フィードバック ツールを開きます。 [フィードバックの送信] ボタンからフィードバック ツールを開くことができます
  3. 問題のレポートにタイトルを付け、関連する詳細を入力します。 [次へ] をクリックして [添付ファイル] セクションに移動し、生成されたログ ファイルを添付します (通常、ファイルは %TEMP%\vslogs.zip にあります)。 [新しい問題を報告する] ボタンを選択し、手順に従います
  4. [次へ] をクリックして問題レポートを確認し、[送信] をクリックします。

手順 5 - InstallCleanup.exe を実行してインストール ファイルをクリーンアップする

最後の手段として、InstallCleanup.exe を実行することができます。 InstallCleanup.exe は、Visual Studio インストーラーのパッケージに含まれるユーティリティで、インストール ファイルをクリーンアップします。 これによって全体が再インストールされるわけではありません。 このユーティリティは、Visual Studio 2017 のキャッシュとインスタンス データを削除します。

  1. Visual Studio インストーラーを閉じます。
  2. 管理者のコマンド プロンプトを開きます。 この操作を行うには、次の手順に従います。
    • [スタート] メニューで、 [ファイル名を指定して実行] (Start + R) をクリックします。
    • cmd」と入力します。
    • [コマンド プロンプト] を右クリックしてから、[管理者として実行] を選択します。
  3. InstallCleanup.exe ユーティリティの完全なパスを入力し、コマンド ライン スイッチ -f を渡します。 既定では、ユーティリティのパスは次のようになります。 C:\Program Files (x86)\Microsoft Visual Studio\Installer\resources\app\layout\InstallCleanup.exe
  4. 手順 3 で説明したブートス トラップを再実行します。
  5. Visual Studio のインストールまたは更新を再度試します。

オフライン インストーラーをトラブルシューティングする方法

次にローカル レイアウトからのインストール時の既知の問題と、便利な回避策をいくつか紹介します。

懸案事項 アイテム ソリューション
ユーザーにファイルへのアクセス権がない。 アクセス許可 (ACL) オフライン インストールを共有するに、他のユーザーに読み取りアクセス権を付与するように、必ずアクセス許可 (ACL) を調整してください。
新しいワークロード、コンポーネント、または言語をインストールできない。 --layout 部分レイアウトからインストールし、以前のレイアウトで使用できないワークロード、コンポーネント、または言語を選択した場合、インターネットにアクセスできることを確認してください。