翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 開始方法
AWS Toolkit for Visual Studio は、AWS のサービスとリソースを Visual Studio 統合開発環境 (IDE) から直接利用できるようにします。
使用開始をサポートするために、以下のトピックでは AWS Toolkit for Visual Studio のインストール、セットアップ、設定方法について説明します。
**Topics**
+ [インストールとセットアップ](setup.md)
+ [への接続 AWS](connect.md)
+ [インストールに関する問題のトラブルシューティング](setup-troubleshoot.md)
+ [プロファイルとウィンドウのバインド](basic-use.md)
# のインストールとセットアップ AWS Toolkit for Visual Studio
次のトピックでは、 AWS Toolkit for Visual Studioのダウンロード、インストール、セットアップ、アンインストールの方法について説明します。
**Topics**
+ [前提条件](#prereqs)
+ [AWS ツールキットのインストール](#install)
+ [Toolkit のアンインストール AWS](#uninstall)
## 前提条件
サポートされているバージョンの AWS Toolkit for Visual Studioをセットアップするための前提条件を次に示します。
+ Visual Studio 19 以降のリリース
+ Windows 10 以降のリリース
+ Windows と Visual Studio への管理者アクセス
+ アクティブな AWS IAM 認証情報
**注記**
サポートされていないバージョンの AWS Toolkit for Visual Studio は、Visual Studio 2008、2010、2012、2013、2015、および 2017 で使用できます。サポートされていないバージョンをダウンロードするには、[AWS Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/) のランディングページに移動し、ダウンロードリンクのリストから目的のバージョンを選択します。
IAM 認証情報の詳細を確認したり、アカウントにサインアップしたりするには、[AWS コンソール](https://console.aws.amazon.com/)ゲートウェイにアクセスしてください。
## のインストール AWS Toolkit for Visual Studio
をインストールするには AWS Toolkit for Visual Studio、次の手順で Visual Studio のバージョンを検索し、必要なステップを完了します。のすべてのバージョンのダウンロードリンク AWS Toolkit for Visual Studio は、[AWS Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/)ランディングページにあります。
**注記**
のインストール中に問題が発生した場合は AWS Toolkit for Visual Studio、このガイドの[「インストールに関する問題のトラブルシューティング](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html)」トピックを参照してください。
### AWS Toolkit for Visual Studio for Visual Studio 2022 のインストール
Visual Studio から AWS Toolkit for Visual Studio 2022 をインストールするには、次の手順を実行します。
1. **[Main menu]** から **[Extensions]** に移動し、**[Manage Extensions]** を選択します。
1. 検索ボックスで **AWSを検索します。
1. 該当するバージョンの **Visual Studio 2022** の **[Download]** ボタンを選択し、インストールプロンプトに従います。
**注記**
インストールプロセスを完了するには、Visual Studio を手動で閉じて再起動しなければならない場合があります。
1. ダウンロードとインストールが完了したら、**表示**メニューから **AWS Explorer** AWS Toolkit for Visual Studio を選択して を開くことができます。
### AWS Toolkit for Visual Studio for Visual Studio 2019 のインストール
Visual Studio から AWS Toolkit for Visual Studio 2019 をインストールするには、次の手順を実行します。
1. **[Main menu]** から **[Extensions]** に移動し、**[Manage Extensions]** を選択します。
1. 検索ボックスで **AWSを検索します。
1. **Visual Studio 2017 と 2019** の **[Download]** ボタンを選択し、プロンプトに従います。
**注記**
インストールプロセスを完了するには、Visual Studio を手動で閉じて再起動しなければならない場合があります。
1. ダウンロードとインストールが完了したら、**表示**メニューから **AWS Explorer** AWS Toolkit for Visual Studio を選択して を開くことができます。
## のアンインストール AWS Toolkit for Visual Studio
をアンインストールするには AWS Toolkit for Visual Studio、次の手順から Visual Studio のバージョンを検索し、必要なステップを完了します。
### AWS Toolkit for Visual Studio for Visual Studio 2022 のアンインストール
Visual Studio から AWS Toolkit for Visual Studio 2022 をアンインストールするには、次の手順を実行します。
1. **[Main menu]** から **[Extensions]** に移動し、**[Manage Extensions]** を選択します。
1. **[Manage Extensions]** ナビゲーションメニューから、**[Installed]** 見出しを展開します。
1. **AWS Toolkit for Visual Studio 2022** 拡張機能を探し、**[Uninstall]** ボタンを選択します。
**注記**
ナビゲーションメニューのインストール**済み**セクションから が表示され AWS Toolkit for Visual Studio ない場合は、Visual Studio を再起動する必要がある場合があります。
1. 画面上のプロンプトに従ってアンインストールプロセスを完了します。
### AWS Toolkit for Visual Studio for Visual Studio 2019 のアンインストール
Visual Studio から AWS Toolkit for Visual Studio 2019 をアンインストールするには、次の手順を実行します。
1. **[Main menu]** から **[ツール]** に移動し、**[Manage Extensions]** を選択します。
1. **[Manage Extensions]** ナビゲーションメニューから、**[Installed]** 見出しを展開します。
1. **AWS Toolkit for Visual Studio 2019** 拡張機能を探し、**[Uninstall]** ボタンを選択します。
1. 画面上のプロンプトに従ってアンインストールプロセスを完了します。
### AWS Toolkit for Visual Studio for Visual Studio 2017 のアンインストール
Visual Studio で AWS Toolkit for Visual Studio 2017 をアンインストールするには、次の手順を実行します。
1. **[Main]** メニューから **[ツール]** に移動し、**[Extensions and Updates]** を選択します。
1. **[Extensions and Updates]** ナビゲーションメニューから、**[Installed]** 見出しを展開します。
1. **AWS Toolkit for Visual Studio 2017** 拡張機能を探し、**[Uninstall]**ボタンを選択します。
1. 画面上のプロンプトに従ってアンインストールプロセスを完了します。
### AWS Toolkit for Visual Studio for Visual Studio 2013 または 2015 のアンインストール
AWS Toolkit for Visual Studio 2013 または 2015 をアンインストールするには、次の手順を実行します。
1. Windows のコントロールパネルから **[プログラムと機能]** を開きます。
**注記**
Windows のコマンドプロンプトまたは Windows の **[実行]** ダイアログから `appwiz.cpl` を実行すると、[プログラムと機能] をすぐに開くことができます。
1. インストールされたプログラムのリストから、**[AWS Tools for Windows]** のコンテキスト (右クリック) メニューを開きます。
1. **[Uninstall]** を選択し、プロンプトに従ってアンインストールプロセスを完了します。
**注記**
**[Samples]** ディレクトリはアンインストールプロセル中に削除されません。このディレクトリは、サンプルを変更した場合に保持されます。このディレクトリは手動で削除する必要があります。
# への接続 AWS
以下のセクションでは、Amazon Q で AWS Toolkit for Visual Studio の使用を開始する方法について説明します。拡張機能のインストール後に Visual Studio を初めて起動すると、**開始方法が**エディタウィンドウに表示されます。**[開始方法]** タブから、次のアクションを実行できます。
+ Amazon Q と AWS Toolkit を有効または無効にします。
+ 新しい認証情報を追加して認証します。
+ 既存の認証情報を使用して認証します。
+ Amazon Q と AWS Toolkit の使用を開始するのに役立つドキュメントとチュートリアルにアクセスします。
## 前提条件
Amazon Q と AWS Toolkit の使用を開始するには、 AWS 認証情報を使用して認証する必要があります。以前に別の AWS ツールやサービス ( など AWS Command Line Interface) を使用して AWS アカウントと認証をセットアップしたことがある場合は、 AWS Toolkit によって認証情報が自動的に検出されます。を初めて使用する場合、 AWS またはアカウントを作成していない場合は、サインアップポータルから AWS アカウントにサインアップできます。 [AWS]( https://portal.aws.amazon.com/billing/signup)新しい AWS アカウントの設定の詳細については、*AWS 「 セットアップユーザーガイド*」の[「概要](https://docs.aws.amazon.com//SetUp/latest/UserGuide/setup-overview.html)」トピックを参照してください。
## Toolkit AWS から に接続する
Toolkit から AWS アカウントに接続するには AWS 、**「開始方法**」タブをいつでも開き、以下を完了します。
**Visual Studio **[開始方法]** タブを開く**
1. Visual Studio のメインメニューから **[拡張機能]** を展開し、**[AWS Toolkit]** サブメニューを展開します。
1. [**開始方法**] を選択します。
1. Visual Studio エディタウィンドウで **[開始方法]** タブが開きます。
**[開始方法]** タブには、2 つの主要なセクションがあります。
+ **機能:** このセクションでは、Amazon Q や AWS Toolkit などの機能を有効または無効にできます。
+ **ドキュメントとチュートリアル:** 有効にした機能へのリファレンスのコレクションです。
**注記**
[ドキュメントとチュートリアル] セクションは、1 つ以上の機能が有効になっている場合にのみ表示されます。
## Amazon Q Developer
**[開始方法]**タブの Amazon Q セクションから、Amazon Q を有効または無効にしたり、新しい接続を追加したり、別の AWS 接続に切り替えることができます。これらのアクションを表示またはアクセスする前に、Amazon Q を有効にする必要があります。Amazon Q を有効にするには、**[有効化]**ボタンをクリックします。
Amazon Q を無効にすると、Amazon Q のすべての機能と関数が Visual Studio から完全に削除されます。Amazon Q を有効にすると、**[開始方法]** タブで **[Amazon Q の認証のセットアップ]** が自動的に開きます。続行するには、**プロフェッショナル層**にアクセスするための AWS IAM アイデンティティセンター 認証情報、または**無料利用枠**にアクセスするための AWS ビルダー ID を使用して認証する必要があります。各階層オプションの詳細については、「*Amazon Q Developer* ユーザーガイド」の「[Amazon Q Developer のサービス階層について](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/q-tiers.html)」のトピックを参照してください。
続行するには、次のいずれかの手順を実行します。
**IAM Identity Center によるプロフェッショナル階層認証**
**注記**
プロフェッショナル階層での認証に必要な **[プロファイル名]**、**[開始 URL]**、**[プロファイルリージョン]**、または **[SSO リージョン]** フィールドは、通常、会社または組織の管理者によって提供されます。IAM アイデンティティセンター認証情報の詳細については、「*AWS IAM アイデンティティセンター*ユーザーガイド」の「[IAM アイデンティティセンターとは](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)」のトピックを参照してください。
1. **Amazon Q での開始方法: AWS ツールキット**画面から、Amazon Q タイルの**サインイン**ボタンを選択して**、Amazon Q 画面のセットアップ認証**に移動します。
1. **[Amazon Q の認証のセットアップ]** 画面から、**[プロファイル階層]**セクションに移動し、必須フィールドに入力して、**[接続]** ボタンを選択します。
1. デフォルトのウェブブラウザで Authorize AWS リクエストポータルを開くことを確認します。
1. Authorize AWS リクエストポータルに必要なステップを完了すると、ブラウザを閉じて Visual Studio に戻ることが安全であると通知されます。
1. **[開始方法]** タブで Amazon Q が更新され、プロセスが完了したときに IAM アイデンティティセンターに接続していることが示されます。
**AWS Builder ID を使用した無料利用枠認証**
**注記**
AWS ビルダー ID の詳細については、[「 サインインユーザーガイド」の AWS 「ビルダー ID で](https://docs.aws.amazon.com/signin/latest/userguide/sign-in-aws_builder_id.html)*AWS サインイン*」トピックを参照してください。
1. **Amazon Q での開始方法: AWS ツールキット**画面から、Amazon Q タイルの**サインイン**ボタンを選択して**、Amazon Q 画面のセットアップ認証**に移動します。
1. **[Amazon Q の認証のセットアップ]** 画面から、**[無料利用枠]** セクションに移動し、**[サインアップ] または [サインイン]** ボタンを選択します。
1. デフォルトのウェブブラウザで Authorize AWS リクエストポータルを開くことを確認します。
1. Authorize AWS リクエストポータルに必要なステップを完了すると、ブラウザを閉じて Visual Studio に戻ることが安全であると通知されます。
1. **「開始方法**」タブで、Amazon Q が更新され、プロセスが完了したときに AWS Builder ID で接続されていることが表示されます。
IAM Identity Center または AWS Builder ID 認証情報を使用して認証したら、Visual Studio の Amazon Q にアクセスできます。さらに、**[開始方法]** タブで次のアクションを実行できます。
+ **サインアウト**: すべての Amazon Q 機能から現在の認証情報の接続を切断します。Amazon Q は引き続き有効ですが、ほとんどの機能は機能しません。
+ **Amazon Q を無効にする**: Visual Studio のすべての Amazon Q 機能を完全に無効にします。
## AWS ツールキット
AWS ツールキット**の開始方法タブの AWS ツールキット**セクションから、 AWS ツールキットを有効または無効にしたり、新しい接続を追加したり、別の AWS 接続に切り替えることができます。これらのアクションを表示またはアクセスする前に、 AWS ツールキットを有効にする必要があります。Toolkit を有効にするには AWS 、**有効化**ボタンをクリックします。
Toolkit を有効にすると、 AWS Toolkit のセットアップ認証が **Toolkit の開始方法タブに自動的にロードされます AWS **。 ** AWS **続行するには、**[AWS IAM アイデンティティセンター]** 認証情報または **[IAM ユーザーロール]** 認証情報を使用して認証する必要があります。
**注記**
IAM アイデンティティセンター認証情報の詳細については、「*AWS IAM アイデンティティセンター*ユーザーガイド」の「[IAM アイデンティティセンターとは](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)」のトピックを参照してください。IAM ユーザーロールの認証情報の詳細については、「*AWS SDK およびツール*リファレンスガイド」の「[AWS アクセスキー: 長期認証情報](https://docs.aws.amazon.com//sdkref/latest/guide/access-iam-users.html)」のトピックを参照してください。
**IAM アイデンティティセンターで認証して接続する**
1. **Amazon Q での開始方法: AWS ツールキット**画面から、 AWS ツールキットタイルの**サインイン**ボタンを選択して、** AWS ツールキットの認証のセットアップ**画面に移動します。
1. ** AWS ツールキットの認証のセットアップ**画面で、**プロファイルタイプの**ドロップダウンメニューから **IAM アイデンティティセンター (シングルサインオンの後継)** を選択します。
1. **[既存のプロファイルから選択するか、新しく追加する]** ドロップダウンメニューから、既存のプロファイルを選択するか、**[新しいプロファイルを追加]** を選択して新しいプロファイル情報を追加します。
**注記**
既存のプロファイルを選択した場合は、ステップ 7 に進みます。
1. **[プロファイル名]** フィールドに、認証に使用する IAM アイデンティティセンターアカウントに関連付けられた **profile name** を入力します。
1. **[開始 URL]** テキストフィールドに、IAM アイデンティティセンターの認証情報にアタッチされている **Start URL** を入力します。
1. **[プロファイルのリージョン (デフォルトは us-east-1)]** ドロップダウンメニューから、認証に使用する IAM アイデンティティセンターユーザープロファイルで定義されている **[プロファイルのリージョン]** を選択します。
1. **[SSO リージョン (デフォルトは us-east-1)]** ドロップダウンメニューから、IAM アイデンティティセンターの認証情報で定義されている **[SSO リージョン]** を選択します。
1. **[接続]** ボタンを選択すると、デフォルトのウェブブラウザで **[AWS Authorize リクエスト]** サイトが開きます。
1. デフォルトのウェブブラウザのプロンプトに従います。認可プロセスが完了すると、ブラウザを閉じて Visual Studio に戻っても安全であることが通知されます。
1. **[開始方法]** タブの [ AWS Toolkit] セクションが更新され、プロセスが完了したときに IAM アイデンティティセンターに接続していることが示されます。
**IAM ユーザーロール認証情報を使用して認証および接続する**
1. **Amazon Q での開始方法: AWS ツールキット**画面から、 AWS ツールキットタイルの**サインイン**ボタンを選択して、** AWS ツールキットの認証のセットアップ**画面に移動します。
1. ** AWS ツールキットの認証のセットアップ**画面で、**プロファイルタイプの**ドロップダウンメニューから **IAM ユーザーロール**を選択します。
1. **[既存のプロファイルから選択するか、新しく追加する]** ドロップダウンメニューで、**Add new profile** を選択します。
**注記**
リストから既存のプロファイル名を選択する場合は、**ステップ 8** に進みます。
1. **[プロファイル名]** テキストフィールドに、新しいプロファイルの名前を入力します。
1. **[アクセスキー ID]** テキストフィールドに、認証するプロファイルの **Access Key ID** を入力します。
1. **[シークレットキー]** テキストフィールドに、認証するプロファイルの **Secret Key** を入力します。
1. **[ストレージの場所 (デフォルトでは共有認証情報ファイル)]** ドロップダウンメニューから、認証情報を **[共有認証情報]** ファイルに保存するか、**[.NET暗号化ストア]** に保存するかを指定します。
1. **[プロファイルリージョン (デフォルトは us-east-1)]** ドロップダウンメニューから、認証するプロファイルにアタッチされている **[パーティション]** と **[プロファイルリージョン]** を選択します。
1. このプロファイルを AWS ストレージの場所に追加したり、認証したりするには、**接続**ボタンを選択します AWS。
1. **[開始方法]** タブの [ AWS Toolkit] セクションが更新され、プロセスが完了すると、IAMユーザーロールの認証情報に接続したことが表示されます。
IAM Identity Center または IAM ユーザーロールの認証情報を使用して認証したら、Toolkit for Visual Studio の AWS Explorer にアクセスできます。また、**[開始方法]** タブから、**[サインアウト]** および **[ AWS Toolkit for Visual Studio with Amazon Q の無効化]** ができます。
## ドキュメントとチュートリアル
ドキュメントとチュートリアルセクションは、 AWS サービスおよび機能の設定に基づいてドキュメントとチュートリアルの提案で自動的に更新されます。これらの参照は、少なくとも 1 つの機能が有効になっている場合にのみ表示されます。
# 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 から探します。
1. Visual Studio アイコンのコンテキスト (右クリック) メニューを開きます。
1. コンテキストメニューから **[Run as administrator]** を選択します。
管理者のアクセス許可で Visual Studio をリモートで起動するには、以下の手順を実行します。
1. Visual Studio のリモートインスタンスへの接続に使用しているアプリケーションのアプリケーションランチャーを Windows から探します。
1. アプリケーションのコンテキスト (右クリック) メニューを開きます。
1. コンテキストメニューから **[Run as administrator]** を選択します。
**注記**
プログラムをローカルで起動するか、リモートで接続するかにかかわらず、Windows では管理者認証情報の確認を求められることがあります。
## インストールログの取得
上記の「**管理者のアクセス許可」セクションの手順を完了し、管理者のアクセス許可で Visual Studio を実行しているか Visual Studio に接続していることが確認できた場合は、インストールログファイルを取得することでその他の問題を診断できます。
`.vsix` ファイルから AWS Toolkit for Visual Studio を手動でインストールし、インストールログファイルを生成するには、次の手順を実行します。
1. [AWS Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/) のランディングページから **[ダウンロード]** リンクをクリックして、インストールする AWS Toolkit for Visual Studio のバージョンの `.vsix` ファイルを保存します。
1. Visual Studio のメインメニューから **[ツール]** ヘッダーを展開し、**[Command Line]** サブメニューを展開して、**[Visual Studio Developer Command Prompt]** を選択します。
1. **[Visual Studio Developer Command Prompt]** から、`vsixinstaller` コマンドを以下の形式で入力します。
`vsixinstaller /logFile:[file path to log file] [file path to Toolkit installation file]`
1. `[file path to log file]` を、インストールログを作成したいディレクトリのファイル名とフルファイルパスに置き換えます。ファイルパスとファイル名を指定した `vsixinstaller` コマンドの例は、以下のようになります。
`vsixinstaller /logFile:C:\Users\Documents\install-log.txt [file path to AWSToolkitPackage.vsix]`
1. `[file path to Toolkit installation file]` を、`AWSToolkitPackage.vsix` が置かれているディレクトリのフルファイルパスに置き換えます。
Toolkit インストールファイルへのフルファイルパスを含む `vsixinstaller` コマンドの例は、以下のようになります。
`vsixinstaller /logFile:[file path to log file] C:\Users\Downloads\AWSToolkitPackage.vsix`
1. ファイル名とパスが正しいことを確認し、`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](https://github.com/aws/aws-toolkit-visual-studio/issues/) サイトで過去の問題を確認したり、新しい問題を作成したりできます。
迅速な解決のために以下をお試しください。
+ 過去および現在の問題をチェックして、他のユーザーが同じような状況に見舞われていないか確認します。
+ 問題に対処するために行った各手順について詳細にメモしておきます。
+ AWS Toolkit for Visual Studio またはその他の拡張機能をインストールして取得したログファイルをすべて保存します。
+ AWS Toolkit for Visual Studio のインストールログファイルを新しい問題に添付します。
# プロファイルとウィンドウのバインド
## Toolkit for Visual Studio のプロファイルとウィンドウのバインド
Toolkit for Visual Studio の発行ツール、ウィザード、およびその他の機能を使用するときは、次の点に注意してください。
+ AWS Explorer ウィンドウは一度に 1 つのプロファイルおよびリージョンにバインドされます。AWS Explorer から開いたウィンドウはデフォルトで、バインドされたプロファイルとリージョンになります。
+ 新しいウィンドウを開くと、AWS Explorer のインスタンスを使用して別のプロファイルまたはリージョンに切り替えることができます。
+ Toolkit for Visual Studio の発行ツールと機能は、AWS Explorer で設定されたプロファイルとリージョンに自動的にデフォルト設定されます。
+ 発行ツール、ウィザード、または機能で新しいプロファイルまたはリージョンを指定した場合、それ以降に作成されたすべてのリソースは、新しいプロファイルとリージョンの設定を引き続き使用します。
+ 複数の Visual Studio のインスタンスが開いている場合は、各インスタンスが異なるプロファイルとリージョンにバインドされていることがあります。
+ AWS Explorer では、最後に指定されたプロファイルとリージョンが保存され、最後に閉じた Visual Studio インスタンスの値が保持されます。