使用 Azure CLI 監視裝置連線能力
使用 Azure CLI IoT 延伸模組可以:
- 查看裝置傳送至 IoT Central 的訊息。
- 觀察裝置對應項中的變更。
- 診斷裝置訊息無法連線到雲端的問題。
- 診斷裝置未回應對應項變更的問題。
必要條件
Azure 中的公司或學校帳戶已新增為 IoT Central 應用程式中的使用者。
備妥環境以使用 Azure CLI
在 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。
安裝 IoT Central 擴充功能
從您的命令列執行下列命令以安裝:
az extension add --name azure-iot
如需檢查擴充功能的版本,請執行下列命令:
az --version
您應該會看到 azure-iot 延伸模組為 0.14.1 或更高版本。 如果不是,請執行:
az extension update --name azure-iot
使用延伸模組
下列各節說明您在執行 az iot central
時可以使用的常見命令和選項。 若要檢視完整的命令和選項,請將 --help
傳遞至 az iot central
或其任何子命令。
登入
首先,登入 Azure CLI:
az login
取得您 IoT Central 應用程式的識別碼
依序前往 [應用程式] > [管理],複製應用程式識別碼。 稍後的步驟中需要用到這個值。
監視訊息
監視從您的裝置傳送至您 IoT Central 應用程式的訊息, 輸出包含所有標頭和註釋。
az iot central diagnostics monitor-events --app-id <app-id> --properties all
檢視裝置屬性
檢視指定裝置目前的讀取和讀取/寫入裝置屬性。
az iot central device twin show --app-id <app-id> --device-id <device-id>