教學課程:為您的環境設定 IoT 隨插即用 快速入門和教學課程

您必須先在 Azure 訂用帳戶中設定 IoT 中樞和裝置布建服務 (DPS),才能完成任何 IoT 隨插即用 快速入門和教學課程。 您也需要範例應用程式和 Azure IoT 總管工具所使用的模型檔案本機複本。

必要條件

如果您沒有 Azure 訂用帳戶,請在開始前建立免費帳戶

備妥環境以使用 Azure CLI

建立資源

建立資源的 Azure 資源群組:

az group create --name my-pnp-resourcegroup --location centralus

建立IoT中樞。 下列命令會使用 名稱 my-pnp-hub 作為要建立之IoT中樞名稱的範例。 選擇 IoT 中樞的唯一名稱,以取代 my-pnp-hub

az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2

建立 DPS 實例。 下列命令會使用 名稱 my-pnp-dps 作為要建立之 DPS 實例名稱的範例。 為您的 DPS 實例選擇唯一的名稱,以取代 my-pnp-dps

az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup

若要將 DPS 實例連結至 IoT 中樞,請使用下列命令。 將與 my-pnp-hub 取代my-pnp-dps為您先前選擇的唯一名稱:

hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString

擷取設定

一些快速入門和教學課程會針對IoT中樞使用 連接字串。 當您設定 Azure IoT 總管工具時,也需要 連接字串。 擷取 連接字串,並立即記下它。 取代為 my-pnp-hub 您為 IoT 中樞選擇的唯一名稱:

az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString

大部分的快速入門和教學課程都使用 DPS 組態的標識碼範圍 。 擷取標識符範圍,並立即加以記下。 取代為 my-pnp-dps 您為 DPS 實體選擇的唯一名稱:

az iot dps show --name my-pnp-dps --query properties.idScope

所有快速入門和教學課程都會使用 DPS 裝置註冊。 使用下列命令,在您的 DPS 實例中建立 my-pnp-device個別裝置註冊 。 將取代 my-pnp-dps 為您為 DPS 實例選擇的唯一名稱。 記下快速入門和教學課程中要使用的註冊標識碼和主鍵值:

az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'

建立環境變數

建立五個環境變數,以在快速入門和教學課程中設定範例,以使用裝置布建服務 (DPS) 連線到 IoT 中樞:

  • IOTHUB_DEVICE_SECURITY_TYPE:值 DPS
  • IOTHUB_DEVICE_DPS_ID_SCOPE:您先前記下的 DPS 識別符範圍。
  • IOTHUB_DEVICE_DPS_DEVICE_ID:值 my-pnp-device
  • IOTHUB_DEVICE_DPS_DEVICE_KEY:您先前記下的註冊主鍵。
  • IOTHUB_DEVICE_DPS_ENDPOINT:值global.azure-devices-provisioning.net

服務範例需要下列環境變數來識別要連線的中樞和裝置:

  • IOTHUB_CONNECTION_STRING:您先前記下的 IoT 中樞 連接字串。
  • IOTHUB_DEVICE_IDmy-pnp-device

例如,在Linux bash殼層中:

export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"

例如,在 Windows 命令行:

set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device

下載模型檔案

快速入門和教學課程會針對溫度控制器和控溫器裝置使用範例模型檔案。 若要下載範例模型檔案:

  1. 在您的本機電腦上建立名為 models 的資料夾。

  2. 以滑鼠右鍵按兩下 TemperatureController.json ,並將 JSON 檔案儲存至 models 資料夾。

  3. 以滑鼠右鍵按兩下 Thermostat.json ,並將 JSON 檔案儲存至 models 資料夾。

安裝 Azure IoT 總管

快速入門和教學課程會使用 Azure IoT 總管工具。 移至 Azure IoT 總管版本 ,並展開最新版本的資產清單。 下載並安裝您作業系統的最新版應用程式。

第一次執行此工具時,系統會提示您輸入IoT中樞 連接字串。 使用您先前記下 連接字串。

設定工具以使用您先前下載的模型檔案。 從工具的首頁,選取 [IoT 隨插即用 設定],然後選取 [+ 新增>本機] 資料夾 選取您先前建立的 models 資料夾。 然後選取 [ 儲存 ] 以儲存設定。

若要深入瞭解,請參閱 安裝和使用 Azure IoT 總管

清除資源

您可以針對所有 IoT 隨插即用 快速入門和教學課程使用IoT中樞和 DPS 實例,因此您只需要完成本文中的步驟一次。 完成時,您可以使用下列命令從訂用帳戶中移除它們:

az group delete --name my-pnp-resourcegroup

下一步

現在您已設定環境,您可以嘗試下列其中一個快速入門或教學課程: