Visual Studio Code的Azure IoT 中樞擴充功能
Visual Studio Code (VS Code) 可讓您將語言、偵錯工具和工具等擴充功能新增至 VS Code 安裝,以支援您的開發工作流程。 Visual Studio Code的Azure IoT 中樞延伸模組可讓您在開發期間,將Azure IoT 中樞支援新增至 VS Code 安裝,以便管理和與 IoT 中樞、裝置和模組互動。 Azure IoT 中樞擴充功能可從Visual Studio Code Marketplace取得。
注意
本文中提及的某些功能 (例如雲端對裝置傳訊、裝置對應項和裝置管理) 僅適用於 IoT 中樞的標準層。 如需基本和標準/免費IoT 中樞層的詳細資訊,請參閱為您的解決方案選擇正確的IoT 中樞層。
安裝延伸模組
您可以從Visual Studio Code或Visual Studio Code Marketplace中找到並安裝擴充功能。
從 Visual Studio Code 安裝
若要從Visual Studio Code內尋找並安裝擴充功能,請執行下列步驟。
在 VS Code 中,選取檢視列中的 [ 延伸模組 ] 檢視圖示或選取 Ctrl+Shift+X,以選取 [ 延伸 模組] 檢視。
在搜尋方塊中輸入Azure IoT 中樞,以篩選 Marketplace 供應專案。 您應該會在清單中看到Azure IoT 中樞延伸模組。 從清單中選取延伸模組以顯示延伸模組詳細資料頁面。
確認所選延伸模組的唯一識別碼會顯示在延伸模組詳細資料頁面的 [詳細資訊] 區段中,設定為
vsciot-vscode.azure-iot-toolkit
。從清單或延伸模組詳細資料頁面選取所選延伸模組的 [安裝 ] 按鈕,以安裝延伸模組。
從 Visual Studio Code Marketplace 安裝
若要從 VS Code Marketplace 尋找並安裝擴充功能,請執行下列步驟。
在瀏覽器中,流覽至 VS Code Marketplace 中的[Azure IoT 中樞擴充功能] 頁面。
確認所選延伸模組的唯一識別碼會顯示在 [Azure IoT 中樞延伸模組] 頁面的 [詳細資訊] 區段中,設定為
vsciot-vscode.azure-iot-toolkit
。選取 [安裝] 按鈕以啟動Visual Studio Code,如果尚未執行,並在 VS Code 中顯示延伸模組的詳細資料頁面。
在 VS Code 中,從延伸模組詳細資料頁面選取 [ 安裝 ] 按鈕以安裝延伸模組。
安裝適用于 Visual Studio Code 的 Azure IoT 中樞 擴充功能也會安裝適用于 Visual Studio Code 的 Azure 帳戶擴充功能,以提供所有其他 Azure 擴充功能的單一 Azure 登入和訂用帳戶篩選體驗。 Azure 帳戶擴充功能也會讓 AZURE Cloud Shell服務可在 VS Code 的整合式終端機中使用。
注意
Azure IoT 中樞擴充功能取決於 Azure 帳戶擴充功能以進行連線。 您無法卸載 Azure 帳戶擴充功能,而不需要卸載Azure IoT 中樞擴充功能。
登入您的 Azure 帳戶
在擴充功能可以與Azure IoT 中樞互動之前,您必須從 Visual Studio Code登入您的 Azure 帳戶。 您可以使用 Azure 帳戶擴充功能來:
- 建立 Azure 帳戶
- 登入和登出您的 Azure 帳戶
- 從您的 Azure 帳戶篩選可供Azure IoT 中樞擴充功能的 Azure 訂用帳戶
- 將檔案上傳至 Azure Cloud Shell儲存體帳戶
請遵循下列步驟登入 Azure,並從您的 Azure 訂用帳戶中選取您的 IoT 中樞:
在 VS Code 的[總管] 檢視中,展開側邊列中的 [Azure IoT 中樞] 區段。
選取 [Azure IoT 中樞]區段的省略號 (...) 按鈕以顯示動作功能表,然後從動作功能表中選取 [選取IoT 中樞]。
如果您未登入 Azure,則會在右下角顯示快顯通知,讓您登入 Azure。 選取 [登入 ],然後依照指示登入 Azure。
從 [ 選取訂用帳戶 ] 下拉式清單中選取您的 Azure 訂用帳戶。
從 [選取IoT 中樞] 下拉式清單中選取您的 IoT 中樞。
IoT 中樞的裝置會從IoT 中樞擷取,並顯示在側邊列的 [Azure IoT 中樞] 區段中的 [裝置] 節點底下。
注意
您也可以使用連接字串來存取 IoT 中樞,方法是從動作功能表中選取 [設定IoT 中樞連接字串],然後在[IoT 中樞 連接字串] 輸入方塊中輸入 IoT 中樞的iothubowner原則連接字串。
登入之後,您可以從 VS Code 總管檢視中的命令選擇區或動作功能表,與中樞、裝置和模組互動。 如需與延伸模組互動的詳細資訊,包括常見問題和互動範例,請參閱 Azure IoT 中樞 延伸模組的wiki。
管理 IoT 中樞
您可以從擴充功能執行下列 IoT 中樞管理工作:
- 建立新的 IoT 中樞 ,並將其選取為擴充功能的目前 IoT 中樞
- 選取現有的 IoT 中樞 作為擴充功能的目前 IoT 中樞
- 在 [總管] 檢視中選取 [Azure IoT 中樞] 區段的 [重新整理] 按鈕,以列出目前 IoT 中樞的現有內建和自訂端點
- 將目前 IoT 中樞的連接字串複製到 剪貼簿
- 產生目前 IoT 中樞的 SAS 權杖 ,並將其複製到剪貼簿
管理您的裝置
您可以從擴充功能執行目前 IoT 中樞的下列裝置管理工作:
- 建立新的IoT 中樞裝置
- 建立新的IoT Edge裝置
- 在檔案總管檢視中選取目前 IoT 中樞的 [重新整理] 按鈕,或指定命令選擇區中的Azure IoT 中樞 [列出裝置] 命令,以列出現有的裝置
- 取得所選取裝置的相關資訊 作為 JSON 檔,如 VS Code 的 [輸出] 面板中所示
- 在 VS Code 編輯器中,編輯所選裝置的裝置對應項作為 JSON 檔
- 將所選裝置的連接字串複製到 剪貼簿
- 產生所選裝置的 SAS 權杖 ,並將其複製到剪貼簿
- 叫用所選裝置的直接方法 ,並在 VS Code 的 [輸出] 面板中顯示結果
- 從目前的 IoT 中樞刪除選取的裝置
提示
您可以啟用 IoT 資源的鎖定,以防止意外或惡意刪除這些資源。 如需 Azure 中資源鎖定的詳細資訊,請參閱 鎖定您的資源以保護基礎結構。
管理模組
您可以針對目前 IoT 中樞內所選裝置執行下列模組管理工作:
- 建立新的模組
- 在 VS Code 總管檢視中選取目前裝置的 [重新整理] 按鈕,以列出現有的模組
- 取得所選取模組的相關資訊 作為 JSON 檔,如 VS Code 的 [輸出] 面板中所示
- 編輯所選模組的模組對應 項,做為 VS Code 編輯器中的 JSON 檔
- 將所選模組的連接字串複製到 剪貼簿
- 叫用所選模組的直接方法 ,並在 VS Code 的 [輸出] 面板中顯示結果
- 從目前的裝置刪除選取的模組
注意
Azure IoT Edge系統模組是唯讀的,而且無法修改。 您可以藉由部署相關IoT Edge裝置的組態來提交變更。
與IoT 中樞互動
您可以針對目前 IoT 中樞內的資源執行下列互動式工作:
- 以 選取的程式設計語言產生程式碼來執行一般工作,例如傳送裝置到雲端訊息給所選資源
- 將裝置到雲端 (D2C) 訊息傳送至所選裝置的IoT 中樞
- 啟動和停止 監視目前 IoT 中樞的內建事件端點 ,並在 VS Code 的 [輸出] 面板中顯示結果
- 將雲端到裝置 (C2D) 訊息傳送至 目前 IoT 中樞的所選裝置,並在 VS Code 的 [輸出] 面板中顯示結果
- 啟動和停止監視目前 IoT 中樞 所選裝置的 C2D 訊息 ,並在 VS Code 的 [輸出] 面板中顯示結果
- 更新裝置的分散式追蹤設定
- 啟動和停止 監視目前 IoT 中樞的自訂事件中樞端點 ,並在 VS Code 的 [輸出] 面板中顯示結果
與IoT Edge互動
您可以針對目前 IoT 中樞內的Azure IoT Edge裝置執行下列互動式工作:
- 建立所選IoT Edge裝置的部署,並在 VS Code 的 [輸出] 面板中顯示結果
- 如果您有適當的部署資訊清單,請針對多個IoT Edge裝置大規模建立部署,並在 VS Code 的 [輸出] 面板中顯示結果