針對 Azure IoT 中心設(shè)備管理，使用適用于 Azure CLI 的 IoT 擴(kuò)展

備注

在開始本教程前，請完成Raspberry Pi聯(lián)機(jī)模擬器教程或其中一個設(shè)備教程；例如，將Raspberry Pi與Node.js配合使用。在這些文章中，你將設(shè)置Azure IoT設(shè)備和IoT中心，并部署一個在設(shè)備上運(yùn)行的示例應(yīng)用程序。該應(yīng)用程序會將收集的傳感器數(shù)據(jù)發(fā)送到IoT中心。

適用于Azure CLI的IoT擴(kuò)展是一個開放源代碼IoT擴(kuò)展，它增強(qiáng)了Azure CLI的功能。Azure CLI包含用于與Azure資源管理器和管理終結(jié)點(diǎn)進(jìn)行交互的命令。例如，可使用Azure CLI創(chuàng)建Azure VM或IoT中心。CLI擴(kuò)展使Azure服務(wù)能夠擴(kuò)展Azure CLI，從而可訪問其他特定于服務(wù)的功能。IoT擴(kuò)展為IoT開發(fā)人員提供了對所有IoT中心、IoT Edge和IoT中心設(shè)備預(yù)配服務(wù)功能的命令行訪問。

備注

本文使用最新版本的Azure IoT擴(kuò)展（稱為azure-iot）。舊版本稱為azure-cli-iot-ext。只應(yīng)同時安裝有一個版本?？梢允褂妹頰z extension list來驗證當(dāng)前安裝的擴(kuò)展。

使用az extension remove--name azure-cli-iot-ext可刪除擴(kuò)展的舊版本。

使用az extension add--name azure-iot可添加擴(kuò)展的新版本。

若要查看已安裝了哪些擴(kuò)展，請使用az extension list。

備注

本文所述的功能只能用于IoT中心的標(biāo)準(zhǔn)層。有關(guān)IoT中心基本層和標(biāo)準(zhǔn)/免費(fèi)層的詳細(xì)信息，請參閱選擇合適的IoT中心層。

有關(guān)這些選項的差異和使用指導(dǎo)的更詳細(xì)說明，請參閱設(shè)備到云通信指南和云到設(shè)備通信指南。

設(shè)備孿生是存儲設(shè)備狀態(tài)信息（元數(shù)據(jù)、配置和條件）的JSON文檔。IoT中心為連接到它的每臺設(shè)備保留一個設(shè)備孿生。有關(guān)設(shè)備孿生的詳細(xì)信息，請參閱設(shè)備孿生入門。

學(xué)習(xí)內(nèi)容

了解如何在開發(fā)計算機(jī)上通過各種管理選項使用適用于Azure CLI的IoT擴(kuò)展。

準(zhǔn)備工作

使用各種管理選項運(yùn)行Azure CLI和適用于Azure CLI的IoT擴(kuò)展。

所需條件

完成Raspberry Pi聯(lián)機(jī)模擬器教程或其中一個設(shè)備教程；例如將Raspberry Pi與Node.js配合使用。這些項包括以下要求：

一個有效的Azure訂閱。

已在訂閱中創(chuàng)建一個Azure IoT中心。

一個可向Azure IoT中心發(fā)送消息的客戶端應(yīng)用程序。

在學(xué)習(xí)本教程期間，確保設(shè)備與客戶端應(yīng)用程序均處于運(yùn)行狀態(tài)。

Python 2.7x或Python 3.x

Azure CLI。如需進(jìn)行安裝，請參閱安裝Azure CLI。Azure CLI版本必須至少是2.0.70或更高版本。請使用az–version驗證版本。

備注

本文使用最新版本的Azure IoT擴(kuò)展（稱為azure-iot）。舊版本稱為azure-cli-iot-ext。只應(yīng)同時安裝有一個版本。可以使用命令az extension list來驗證當(dāng)前安裝的擴(kuò)展。

使用az extension remove--name azure-cli-iot-ext可刪除擴(kuò)展的舊版本。

使用az extension add--name azure-iot可添加擴(kuò)展的新版本。

若要查看已安裝了哪些擴(kuò)展，請使用az extension list。

安裝IoT擴(kuò)展。最簡單的方法是運(yùn)行az extension add--name azure-iot。IoT擴(kuò)展自述文件介紹了該擴(kuò)展的多種安裝方法。

登錄到Azure帳戶

通過運(yùn)行以下命令登錄到Azure帳戶：

Azure CLI

az login

直接方法

Azure CLI

az iot hub invoke-device-method--device-id<your device id>

--hub-name<your hub name>

--method-name<the method name>

--method-payload<the method payload>

設(shè)備孿生所需屬性

通過運(yùn)行以下命令將所需屬性間隔設(shè)置為3000：

Azure CLI

az iot hub device-twin update-n<your hub name>

-d<your device id>--set properties.desired.interval=3000

可從設(shè)備讀取此屬性。

設(shè)備孿生報告屬性

通過運(yùn)行以下命令獲取報告的設(shè)備屬性：

Azure CLI

az iot hub device-twin show-n<your hub name>-d<your device id>

其中一個克隆的已報告屬性是$metadata。$lastUpdated，它顯示設(shè)備應(yīng)用程序更新其報告屬性集的最后時間。

設(shè)備孿生標(biāo)記

通過運(yùn)行以下命令顯示設(shè)備的標(biāo)記和屬性：

Azure CLI

az iot hub device-twin show--hub-name<your hub name>--device-id<your device id>

通過運(yùn)行以下命令向設(shè)備添加字段角色=溫度和濕度：

Azure CLI

az iot hub device-twin update

--hub-name<your hub name>

--device-id<your device id>

--set tags='{"role":"temperature&humidity"}}'

設(shè)備孿生查詢

通過運(yùn)行以下命令查詢角色標(biāo)記=“溫度和濕度”的設(shè)備：

Azure CLI

az iot hub query--hub-name<your hub name>

--query-command"SELECT*FROM devices WHERE tags.role='temperature&humidity'"

通過運(yùn)行以下命令查詢除角色標(biāo)記=“溫度和濕度”的設(shè)備以外的所有設(shè)備：

Azure CLI

az iot hub query--hub-name<your hub name>

--query-command"SELECT*FROM devices WHERE tags.role!='temperature&humidity'"