如何在 Azure IoT 中樞內使用裝置對應項標記來管理裝置 | Microsoft Docs

發行項
04/24/2023

本文示範如何使用標記，以使用裝置對應項標記來管理 IoT 裝置

裝置對應項標記可以用作功能強大的工具，協助您組織裝置。當您在 IoT 解決方案中有多種類型的裝置時，這特別重要，您可以使用標記來設定類型、位置等等。例如：

{
    "deviceId": "mydevice1",
    "status": "enabled",
    "connectionState": "Connected",
    "cloudToDeviceMessageCount": 0,
    "authenticationType": "sas",
    "tags": {
        "deploymentLocation": {
            "building": "43",
            "floor": "1"
        },
		"deviceType":"HDCamera"
    },
    "properties": {
     ...
    }
}

必要條件

IoT 中樞。使用 CLI 或 Azure 入口網站建立一個。
至少兩個已註冊的裝置。在 Azure 入口網站中註冊裝置。

使用 Azure 入口網站新增和檢視裝置對應項標記

本節將說明如何使用 Azure 入口網站建立 IoT 中樞。

登入 Azure 入口網站，並移至您的 IoT 中樞。
選取左側導覽中的 [裝置] 索引標籤。
選取所需的裝置，然後選取 [指派標記]。
在已開啟的檢視中，您可以看到裝置已經具有的標記。若要新增基本標記，請提供標記的「名稱」和「值」。名稱與值組的格式位於標記和屬性格式中。選取 [儲存] 以儲存標記。
儲存之後，您可以再次選取 [指派標記]，以檢視所新增的標記。

新增和檢視巢狀標記

在上述範例之後，您可以選取 [指派標記] 中的 [進階] 索引標籤來新增巢狀標記，然後新增具有兩個值的巢狀 json 物件。
```
{
    "deploymentLocation": {
        "building": "43",
        "floor": "1"
    }
}
```
選取 [儲存]
再次選取裝置，然後選取 [指派標記] 以檢視新增的標記

使用裝置對應項標記來篩選裝置

裝置對應項標記是依類型、位置等將裝置進行分組的絕佳方式，而且您可以透過裝置標記進行篩選來管理您的裝置。

選取 [+ 新增篩選]，然後選取 [裝置標記] 作為篩選類型
輸入所需的標記名稱和值，並選取 [套用] 以擷取符合準則的裝置清單

使用 Azure 入口網站更新和刪除多個裝置中的裝置對應項標記

選取兩個以上的裝置，然後選取 [指派標記]。
在已開啟的面板中，您可以在 [名稱] 欄位中輸入目標標記名稱，然後在 [值] 欄位中輸入新字串，以更新現有標記。
若要刪除多個裝置中的某個標記，請在 [名稱] 欄位中輸入目標標記名稱，然後選取 [刪除標記] 按鈕。
選取 [儲存]，以從包含相符標記名稱的裝置中刪除標記。

使用 Azure CLI 管理裝置對應項標記

下節逐步解說數個使用 Azure CLI 進行標記的範例。如需裝置對應項 CLI 的完整參考

在命令提示字元中，執行登入命令：
```
az login
```
依照指示使用程式碼進行驗證，並透過網頁瀏覽器登入 Azure 帳戶。
如果您有多個 Azure 訂用帳戶，則登入 Azure 會授予您所有與認證相關聯之 Azure 帳戶的存取權。使用 az account list 來檢視完整帳戶清單：
```
az account list
```
使用下列命令，來選取您想要用來執行命令以建立 IoT 中樞的訂用帳戶。您可以使用來自上一個命令之輸出內的訂用帳戶名稱或識別碼︰
```
az account set --subscription {your subscription name or id}
```
下列命令會啟用檔案通知，並將檔案通知屬性設定為其預設值。 (檔案上傳通知存留時間會設定為一小時，而鎖定持續時間會設定為 60 秒。)
```
az iot hub device-twin update -n {iothub_name} \
    -d {device_id} --tags '{"country": "USA"}'
```

您可以匯入 json 檔案，或直接將 json 新增至輸入，以新增複雜的巢狀標記：

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags /path/to/file

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags '{"country":{"county":"king"}}'

在現有標記上使用命令，來更新值：

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags '{"country": "Germany"}'

下列命令將值設定為 null 以移除所新增的標記。

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags '{"country": null}'

注意

如果您使用 PowerShell 或 CloudShell>Powershell 模式，則需要新增正斜線 '\' 以逸出所有雙引號。範例：--tags '{\"country\":\"US\"}'

使用 Azure CLI 建立工作以設定標記

如需 IoT 中樞工作 CLI 的完整參考

下一步

現在您已了解裝置對應項，接下來您可能會對下列 IoT 中樞開發人員指南主題感興趣︰

若要嘗試本文所述的一些概念，請參閱下列「IoT 中樞」教學課程：

Share via