快速入門：使用 Bicep 設定 IoT 中樞裝置佈建服務 (DPS)

發行項
05/11/2024

您可以使用 Bicep 檔案，以程式設計方式設定佈建裝置所需的 Azure 雲端資源。這些步驟說明如何使用 Bicep 檔案建立 IoT 中樞和新的 IoT 中樞裝置佈建服務執行個體。 IoT 中樞也會使用 Bicep 檔案連結至 DPS 資源。此連結可讓 DPS 資源根據您設定的配置原則，將裝置指派給中樞。

Bicep 是使用宣告式語法來部署 Azure 資源的特定領域語言 (DSL)。其提供簡潔的語法、可靠的類型安全，並支援程式碼重複使用。 Bicep 能夠為您在 Azure 中的基礎結構即程式碼解決方案，提供最佳的製作體驗。

本快速入門使用 Azure PowerShell 和 Azure CLI 來執行建立資源群組及部署範本所需的程式設計步驟，但您可以輕鬆地 .NET、Ruby 或其他程式設計語言來執行這些步驟及部署您的 Bicep 檔案。

必要條件

如果您沒有 Azure 訂用帳戶，請在開始之前先建立 Azure 免費帳戶。

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

如果您選擇在本機使用 Azure PowerShell：
- 安裝最新版的 Az PowerShell 模組。
- 使用 Connect-AzAccount Cmdlet 連線至 Azure 帳戶。
如果您選擇使用 Azure Cloud Shell：
- 請參閱 Azure Cloud Shell 概觀以取得詳細資訊。

檢閱 Bicep 檔案

此快速入門中使用的 Bicep 檔案是來自 Azure 快速入門範本。

注意

目前沒有 Bicep 檔案支援使用新的 DPS 資源建立註冊。這是考慮實作時常見且可理解的要求。

@description('Specify the name of the Iot hub.')
param iotHubName string

@description('Specify the name of the provisioning service.')
param provisioningServiceName string

@description('Specify the location of the resources.')
param location string = resourceGroup().location

@description('The SKU to use for the IoT Hub.')
param skuName string = 'S1'

@description('The number of IoT Hub units.')
param skuUnits int = 1

var iotHubKey = 'iothubowner'

resource iotHub 'Microsoft.Devices/IotHubs@2021-07-02' = {
  name: iotHubName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {}
}

resource provisioningService 'Microsoft.Devices/provisioningServices@2022-02-05' = {
  name: provisioningServiceName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {
    iotHubs: [
      {
        connectionString: 'HostName=${iotHub.properties.hostName};SharedAccessKeyName=${iotHubKey};SharedAccessKey=${iotHub.listkeys().value[0].primaryKey}'
        location: location
      }
    ]
  }
}

以上 Bicep 檔案中定義了兩個 Azure 資源：

Microsoft.Devices/iothubs：建立新的 Azure IoT 中樞。
Microsoft.Devices/provisioningservices：使用已連結的新 IoT 中樞，建立新的 Azure IoT 中樞裝置佈建服務。

在本機上將 Bicep 檔案的複本儲存為 main.bicep。

部署 Bicep 檔案

登入您的 Azure 帳戶並選取您的訂用帳戶。

在命令提示字元登入 Azure：
- CLI
- PowerShell
```
az login
```
```
Connect-AzAccount
```
依照指示使用程式碼進行驗證，並透過網頁瀏覽器登入 Azure 帳戶。
如果您有多個 Azure 訂用帳戶，則登入 Azure 會授予您所有與認證相關聯之 Azure 帳戶的存取權。
- CLI
- PowerShell
```
az account list -o table
```
```
Get-AzSubscription
```
使用下列命令，選取您想要用來執行命令以建立 IoT 中樞和 DPS 資源的訂用帳戶。您可以使用來自上一個命令之輸出內的訂用帳戶名稱或識別碼︰
- CLI
- PowerShell
```
az account set --subscription {your subscription name or id}
```
```
Set-AzContext -Subscription {your subscription name or id}
```

使用下列命令來部署 Bicep 檔案。

提示

命令會提示您輸入資源群組位置。請先執行下列命令，以便檢視可用位置清單：

CLI
PowerShell

az account list-locations -o table

CLI
PowerShell

az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters iotHubName={IoT-Hub-name} provisioningServiceName={DPS-name}

New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -iotHubName "{IoT-Hub-name}" -provisioningServiceName "{DPS-name}"

將 {IoT-Hub-name} 取代為全域唯一的 IoT 中樞名稱，將 {DPS-name} 取代為全域唯一的裝置佈建服務 (DPS) 資源名稱。

建立資源需要一些時間。

檢閱已部署的資源

若要驗證部署，請執行下列命令，並在輸出中尋找新的佈建服務和 IoT 中樞：
- CLI
- PowerShell
```
 az resource list -g exampleRg
```
```
Get-AzResource -ResourceGroupName exampleRG
```

若要驗證中樞已連結至 DPS 資源，請執行下列命令。

CLI
PowerShell

az iot dps show --name <Your provisioningServiceName>

Get-AzIoTDeviceProvisioningService -ResourceGroupName exampleRG -Name "{DPS-name}"

請注意，中樞會連結至 iotHubs 成員。

清除資源

此集合中的其他快速入門會以本快速入門為基礎。如果您打算繼續進行後續的快速入門或教學課程，請勿清除在此快速入門中建立的資源。如果您不打算繼續，可以使用 Azure PowerShell 或 Azure CLI 刪除資源群組及其所有資源。

若要從 Azure 入口網站刪除資源群組及其資源，只要開啟資源群組，然後選取頂端的 [刪除資源群組]。

若要刪除已部署的資源群組：

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -name exampleRG

您也可以使用 Azure 入口網站、PowerShell 或 REST API，或使用支援的平台 SDK 來刪除資源群組和個別資源。

下一步

在本快速入門中，您已部署 IoT 中樞和裝置佈建服務執行個體，並已連結這兩個資源。若要了解如何使用這項設定來佈建裝置，請繼續進行建立裝置的快速入門。

快速入門：佈建模擬對稱金鑰裝置

Share via