AWS Toolkit for Visual Studio のインストールに関する問題のトラブルシューティング - AWS Toolkit with Amazon Q

AWS Toolkit for Visual Studio のインストールに関する問題のトラブルシューティング

以下の情報によって、AWS Toolkit for Visual Studio のセットアップ中によく発生する問題を解決できることがわかっています。

AWS Toolkit for Visual Studio のインストール中にエラーが発生した場合、またはインストールが完了したかどうか不明な場合は、以下の各セクションの情報を確認してください。

Visual Studio のための管理者のアクセス許可

AWS Toolkit for Visual Studio 拡張機能には、すべての AWS サービスと機能にアクセスできるようにするための管理者のアクセス許可が必要です。

ローカル管理者のアクセス許可がある場合、管理者のアクセス許可が Visual Studio インスタンスに直接適用されない可能性があります。

管理者のアクセス許可で Visual Studio をローカルで起動するには、以下の手順を実行します。

  1. Visual Studio アプリケーションランチャー (アイコン) を Windows から探します。

  2. Visual Studio アイコンのコンテキスト (右クリック) メニューを開きます。

  3. コンテキストメニューから [Run as administrator] を選択します。

管理者のアクセス許可で Visual Studio をリモートで起動するには、以下の手順を実行します。

  1. Visual Studio のリモートインスタンスへの接続に使用しているアプリケーションのアプリケーションランチャーを Windows から探します。

  2. アプリケーションのコンテキスト (右クリック) メニューを開きます。

  3. コンテキストメニューから [Run as administrator] を選択します。

注記

プログラムをローカルで起動するか、リモートで接続するかにかかわらず、Windows では管理者認証情報の確認を求められることがあります。

インストールログの取得

上記の「管理者のアクセス許可」セクションの手順を完了し、管理者のアクセス許可で Visual Studio を実行しているか Visual Studio に接続していることが確認できた場合は、インストールログファイルを取得することでその他の問題を診断できます。

.vsix ファイルから AWS Toolkit for Visual Studio を手動でインストールし、インストールログファイルを生成するには、次の手順を実行します。

  1. AWS Toolkit for Visual Studio のランディングページから [ダウンロード] リンクをクリックして、インストールする AWS Toolkit for Visual Studio のバージョンの .vsix ファイルを保存します。

  2. Visual Studio のメインメニューから [ツール] ヘッダーを展開し、[Command Line] サブメニューを展開して、[Visual Studio Developer Command Prompt] を選択します。

  3. [Visual Studio Developer Command Prompt] から、vsixinstaller コマンドを以下の形式で入力します。

    vsixinstaller /logFile:[file path to log file] [file path to Toolkit installation file]

  4. [file path to log file] を、インストールログを作成したいディレクトリのファイル名とフルファイルパスに置き換えます。ファイルパスとファイル名を指定した vsixinstaller コマンドの例は、以下のようになります。

    vsixinstaller /logFile:C:\Users\Documents\install-log.txt [file path to AWSToolkitPackage.vsix]

  5. [file path to Toolkit installation file] を、AWSToolkitPackage.vsix が置かれているディレクトリのフルファイルパスに置き換えます。

    Toolkit インストールファイルへのフルファイルパスを含む vsixinstaller コマンドの例は、以下のようになります。

    vsixinstaller /logFile:[file path to log file] C:\Users\Downloads\AWSToolkitPackage.vsix

  6. ファイル名とパスが正しいことを確認し、vsixinstaller コマンドを実行します。

    完全な vsixinstaller コマンドの例は、以下のようになります。

    vsixinstaller /logFile:C:\Users\Documents\install-log.txt C:\Users\Downloads\AWSToolkitPackage.vsix

さまざまな Visual Studio 拡張機能のインストール

インストールログファイルを入手しても、インストールプロセスが失敗する理由がわからない場合は、その他の Visual Studio 拡張機能をインストールできるかどうかを確認してください。さまざまな Visual Studio 拡張機能をインストールすると、インストールの問題についてさらに詳しく知ることができます。どの Visual Studio 拡張機能もインストールできない場合、AWS Toolkit for Visual Studio ではなく Visual Studio に関する問題のトラブルシューティングを行う必要があるかもしれません。

サポートへのお問い合わせ

このガイドに含まれるすべてのセクションを確認した後に、さらにリソースやサポートが必要な場合は、AWS Toolkit for Visual Studio Github Issues サイトで過去の問題を確認したり、新しい問題を作成したりできます。

迅速な解決のために以下をお試しください。

  • 過去および現在の問題をチェックして、他のユーザーが同じような状況に見舞われていないか確認します。

  • 問題に対処するために行った各手順について詳細にメモしておきます。

  • AWS Toolkit for Visual Studio またはその他の拡張機能をインストールして取得したログファイルをすべて保存します。

  • AWS Toolkit for Visual Studio のインストールログファイルを新しい問題に添付します。