Visual Studio Code 用の Azure IoT Hub 拡張機能

  • [アーティクル]

Visual Studio Code (VS Code) を使用すると、言語、デバッガー、ツールなどの拡張機能を VS Code インストールに追加して、開発ワークフローをサポートできます。 Visual Studio Code 向け Azure IoT Hub 拡張機能を使用すると、VS Code のインストールに Azure IoT Hub サポートを追加できるため、開発中に IoT ハブ、デバイス、モジュールを管理および操作できます。 Azure IoT Hub 拡張機能は、Visual Studio Code Marketplace から入手できます。

注意

この記事で言及されている一部の機能 (cloud-to-device メッセージング、デバイス ツイン、デバイス管理など) は、IoT Hub の Standard レベルだけで使用することができます。 Basic および Standard または Free レベルの IoT Hub の詳細については、ソリューションに適した IoT Hub のレベルの選択に関するページを参照してください。

拡張機能をインストールする

拡張機能は、 Visual Studio Code または Visual Studio Code Marketplace で検索してインストールできます。

Visual Studio Code からインストールする

Visual Studio Code 内から拡張機能を検索してインストールするには、次の手順を実行します。

  1. VS Code で、[拡張機能] ビューを選択するには、ビュー バーから [拡張機能] ビュー アイコンを選択するか、Ctrl + Shift + X キーを押します。

    Visual Studio Code の [拡張機能] ビュー アイコンとショートカットを示すスクリーンショット。

  2. 検索ボックスに、「Azure IoT Hub」と入力して、Marketplace オファリングをフィルター処理します。 一覧に Azure IoT Hub 拡張子が表示されます。 一覧から拡張機能を選択して、拡張機能の詳細ページを表示します。

    Visual Studio Code の [拡張機能] ビューの検索バーとリストを示すスクリーンショット。

  3. 拡張機能の詳細ページの [詳細情報] セクションに表示される、選択した拡張機能の一意の識別子が vsciot-vscode.azure-iot-toolkit に設定されていることを確認します。

    拡張機能の詳細ページからの Azure IoT Hub 拡張機能の拡張機能識別子を示すスクリーンショット。

  4. 拡張機能をインストールするには、一覧または拡張機能の詳細ページから、選択した拡張機能の [インストール] ボタンを選択します。

Visual Studio Code Marketplace からインストールする

VS Code Marketplace から拡張機能を検索してインストールするには、次の手順を実行します。

  1. ブラウザーで、VS Code Marketplace の [Azure IoT Hub] 拡張機能ページに移動します。

  2. Azure IoT Hub 拡張機能の詳細ページの [詳細情報] セクションに表示される、選択した拡張機能の一意の識別子が vsciot-vscode.azure-iot-toolkit に設定されていることを確認します。

  3. Visual Studio Code がまだ実行されていない場合は、[インストール] ボタンを選択して起動し、VS Code で拡張機能の拡張機能の詳細ページを表示します。

  4. VS Code で、拡張機能の詳細ページから [インストール] ボタンを選択して拡張機能をインストールします。

Visual Studio Code 用の Azure IoT Hub 拡張機能をインストールすると、Visual Studio Code 用 Azure アカウント拡張機能もインストールされます。これにより、他のすべての Azure 拡張機能に対して 1 つの Azure サインインとサブスクリプションのフィルター処理エクスペリエンスが提供されます。 また、Azure アカウント拡張機能を使用すると、VS Code の統合ターミナルで Azure Cloud Shell サービスを使用できるようになります。

注意

Azure IoT Hub 拡張機能は、接続用の Azure アカウント拡張機能によって異なります。 Azure IoT Hub 拡張機能をアンインストールしなければ、Azure アカウント拡張機能をアンインストールすることはできません。

Azure アカウントへのサインイン

拡張機能が Azure IoT Hub と対話するには、Visual Studio Code から Azure アカウントにサインインする必要があります。 Azure Account 拡張機能を使用すると、次のことができます。

  • Azure アカウントの作成
  • Azure アカウントからサインインおよびサインアウトする
  • Azure アカウントから Azure IoT Hub 拡張機能で使用できる Azure サブスクリプションをフィルター処理する
  • お使いの Azure Cloud Shell ストレージ アカウントにファイルをアップロードする

Azure にサインインし、Azure サブスクリプションから IoT ハブに選択するには、次の手順に従います。

  1. VS Code の[エクスプローラー] ビューで、サイド バーの [Azure IoT Hub] セクションを展開します。

  2. [Azure IoT Hub] セクションの省略記号 (...) ボタンを選択してアクション メニューを表示し、アクション メニューから [IoT Hub の選択] を選択します。

  3. Azure にサインインしていない場合は、右下隅にポップアップ通知が表示され、Azure にサインインできます。 [サインイン] を選択し、指示に従って Azure にサインインします。

  4. [サブスクリプションの選択]ドロップダウン リストから Azure サブスクリプションを選択します。

  5. [IoT Hub の選択] ドロップダウン リストから IoT ハブを選択します。

  6. IoT ハブのデバイスが IoT Hub から取得され、サイド バーの [Azure IoT Hub] セクションの [デバイス] ノードの下に表示されます。

    注意

    接続文字列を使用して IoT ハブにアクセスすることもできます。そのためには、アクション メニューから [IoT Hub 接続文字列の設定] を選択し、[IoT Hub 接続文字列] 入力ボックスに IoT ハブの iothubowner ポリシー接続文字列を入力します。

サインインすると、VS Code のエクスプローラー ビューのコマンド パレットまたはアクション メニューからハブ、デバイス、およびモジュールを操作できます。 拡張機能との対話の詳細 (よく寄せられる質問や対話の例などを含む) については、Azure IoT Hub 拡張機能の Wiki を参照してください。

IoT ハブの管理

拡張機能から次の IoT ハブ管理タスクを実行できます。

デバイスを管理する

拡張機能から、現在の IoT ハブに対して次のデバイス管理タスクを実行できます。

ヒント

IoT リソースのロックを有効にすると、誤ってまたは悪意を持って削除されるのを防ぐことができます。 リソースのロックについて詳しくは、「Azure でリソースをロックしてインフラストラクチャを保護する」をご覧ください。

モジュールを管理する

現在の IoT ハブで選択したデバイスに対して、次のモジュール管理タスクを実行できます。

注意

Azure IoT Edge システム モジュールは読み取り専用であり、変更できません。 変更は、関連する IoT Edge デバイスの構成をデプロイすることで送信できます。

IoT Hub との対話

現在の IoT ハブ内のリソースに対して、次の対話型タスクを実行できます。

IoT Edge との対話

現在の IoT ハブ内の Azure IoT Edge デバイスに対して、次の対話型タスクを実行できます。