本文說明如何在 Azure IoT Central 應用程式中管理裝置。 您可以:
- 使用 [裝置] 頁面來檢視、新增和刪除連線至 Azure IoT Central 應用程式的裝置。
- 透過從您的檢視中變更裝置屬性中儲存的值來保持裝置中繼資料最新。
- 透過從您的檢視中更新特定裝置上的設定來控制裝置的行為。
若要瞭解如何大量管理裝置,請參閱 在 Azure IoT Central 應用程式中大量管理裝置。
若要瞭解如何使用 IoT Central REST API 來管理裝置,請參閱如何使用 IoT Central REST API 來管理裝置。
檢視您的裝置
若要檢視個別裝置:
選擇左側窗格中的 裝置 。 在這裡,您會看到裝置範本的清單,以及組織可存取的所有裝置清單。
選擇裝置範本。
在 [裝置] 頁面的右側窗格中,您會看到組織可從該裝置範本建立的裝置清單:
選擇個別裝置以查看該裝置的裝置詳細資料頁面。
小提示
您可以使用此頁面上的篩選工具來檢視特定組織中的裝置。
監控您的設備
使用 「裝置」 頁面來監視和管理您的裝置。
下列影片會引導您監控裝置的連線狀態:
裝置狀態值
每個裝置在 UI 中都有一個狀態值。 裝置狀態可以是下列其中一項:
裝置狀態為 [先註冊]。 此狀態表示裝置是在 IoT Central 中建立,並具有裝置識別碼。 在下列情況下,會註冊裝置:
- 新的真實裝置會在 「裝置」 頁面上新增。
- 使用「裝置」頁面上的「匯入」新增一組裝置。
當已註冊的裝置使用裝置布建服務 (DPS) 完成布建步驟時,裝置狀態會變更為 [已佈建]。 若要完成佈建程式,裝置需要用來註冊裝置的 裝置識別碼 (SAS 金鑰或 X.509 憑證) ,以及 識別碼範圍。 DPS 佈建裝置之後,它可以連線到您的 IoT Central 應用程式並開始傳送資料。
已封鎖的裝置狀態為 「已封鎖」。 操作員可以封鎖和解除封鎖裝置。 當裝置遭到封鎖時,它無法將資料傳送至 IoT Central 應用程式。 操作員必須先解除封鎖裝置,才能繼續傳送資料。 當操作員解除封鎖裝置時,狀態會回到其先前的值, 即已註冊 或 已佈建。
如果裝置狀態為等待核准,則表示在裝置連線群組頁面上停用自動核准選項。 操作員必須先明確核准裝置,才能佈建裝置並傳送資料。 未在「裝置」頁面上手動註冊,但使用有效認證連線的裝置狀態為「等待核准」。 操作員可以使用 [核准] 按鈕從 [裝置] 頁面核准這些裝置。
下表顯示 UI 中裝置的狀態值如何對應至 REST API 用來與裝置互動的值:
| UI 裝置狀態 | 註釋 | REST API Get |
|---|---|---|
| 等待批准 | 自動核准選項在裝置連線群組中已停用,且裝置未透過 UI 新增。 使用者必須先透過 UI 手動核准裝置,才能使用裝置。 |
Provisioned: false Enabled: false |
| 已登錄 | 設備被自動或手動核准。 | Provisioned: false Enabled: true |
| 已佈建 | 裝置已佈建,而且可以連線到您的 IoT Central 應用程式。 | Provisioned: true Enabled: true |
| 已封鎖 | 裝置不允許連線到您的 IoT Central 應用程式。 您可以封鎖處於任何其他狀態的裝置。 |
Provisioned: 取決於 Waiting for approval/Registered/Provisioned status Enabled: false |
裝置也可以具有 [未指派] 狀態。 此狀態不會顯示在 UI 的 裝置狀態 欄位中,而是顯示在 UI 的 裝置範本 欄位中。 不過,您可以篩選裝置清單,以尋找狀態 為「未指派」 的裝置。 如果裝置狀態為 [未指派],則連線到 IoT Central 的裝置不會指派給裝置範本。 這種情況通常發生在以下情況下:
- 使用「裝置」頁面上的「匯入」新增一組裝置,而不指定裝置範本。
- 裝置是在 [裝置] 頁面上手動註冊的,而沒有指定裝置範本。 裝置接著會使用有效的認證來連線。
操作員可以使用 移轉 按鈕,從[裝置] 頁面將裝置指派給裝置範本。
裝置連線狀態
當裝置或邊緣裝置使用 MQTT 通訊協定連線時,會產生裝置的 已連接 及 中斷連線 事件。 裝置不會傳送這些事件,IoT Central 會在內部產生這些事件。
以下圖示顯示,當裝置連線時,如何在時間窗口結束時完成連線註冊。 如果發生多個連線和中斷連線事件,IoT Central 會註冊最接近時間範圍結尾的事件。 例如,如果裝置在時間範圍內中斷連線並重新連線,IoT Central 會註冊連線事件。 目前,時間範圍約為一分鐘。
觀看下列影片,以深入瞭解如何監控裝置連線狀態:
您可以使用 Blob 儲存體將 IoT 資料匯出至雲端目的地,其中包含連線和中斷連線事件。 若要深入瞭解,請參閱 使用事件方格觸發動作 > 來回應 IoT 中樞事件裝置連線狀態事件的限制。
新增裝置
若要將裝置新增至 Azure IoT Central 應用程式:
選擇左側窗格中的 裝置 。
選擇您要從中建立裝置的裝置範本。
選擇 + 新增。
輸入裝置名稱和 ID 或接受預設值。 裝置名稱的長度上限為 148 個字元。 裝置 ID 的長度上限為 128 個字元。
將 模擬開關設為 開啟 或 關閉。 您連線到 Azure IoT Central 應用程式的實體裝置即為真實裝置。 模擬裝置具有 Azure IoT Central 為您產生的範例資料。
如果您的應用程式使用組織,請選擇裝置所屬的組織。
小提示
您可以設定 預設組織 顯示在組織下拉式清單中。
選取 ,創建。
此裝置現在會出現在此範本的裝置清單中。 選取裝置以查看包含裝置所有檢視的裝置詳細資料頁面。
取得裝置連線資訊
當裝置佈建並連線到 IoT Central 時,它需要來自 IoT Central 應用程式的連線資訊:
- 識別 DPS 應用程式的 識別碼範圍 。
- 用來註冊裝置的 裝置識別碼 。
- SAS 金鑰或 X.509 憑證。
若要尋找這些值:
選擇左側窗格中的 裝置 。
若要查看裝置詳細資料,請在裝置清單中選取裝置。
選取 [ 連線 ] 以檢視連線資訊。 QR 碼會編碼 JSON 檔,其中包含衍生自預設 SAS-IoT-Devices 裝置連線群組的識別碼範圍、裝置識別碼和主索引鍵。
備註
如果驗證類型是 共用存取簽章,則顯示的金鑰衍生自預設的 SAS-IoT-Devices 裝置連線群組。
改變組織
若要將裝置移至其他組織,您必須同時具有來源和目的地組織的存取權。 若要移動裝置:
將裝置移轉至範本
如果您在 [所有裝置] 下開始匯入來註冊裝置,則會在沒有任何裝置範本關聯的情況下建立裝置。 必須將裝置分配到範本,才能探索裝置的資料和其他詳細資料。 請遵循下列步驟,將裝置指派給範本:
選擇左側窗格中的 裝置 。
在左側面板上,選擇 [ 所有裝置]。
選取您要指派給範本的 未指派 裝置:
選取 [移轉]:
從可用範本清單中選擇範本,然後選取 [移轉]。
選取的裝置會分配到您所選擇的裝置範本中。
刪除裝置
若要從 Azure IoT Central 應用程式刪除實際或模擬裝置:
選擇左側窗格中的 裝置 。
選擇您要刪除的裝置的裝置範本。
使用篩選工具來篩選和搜尋您的裝置。 勾選要刪除的裝置旁邊的方塊。
選擇 [刪除]。 您可以在「裝置操作」面板中追蹤此刪除的狀態。
變更屬性
雲端屬性是與裝置相關聯的裝置中繼資料,例如城市和序號。 雲端屬性只存在於 IoT Central 應用程式中,不會同步處理至您的裝置。 可寫入屬性可控制裝置的行為,並可讓您從遠端設定裝置的狀態,例如設定恆溫器裝置的目標溫度。 裝置會設定裝置屬性,這些屬性在 IoT Central 內是唯讀的。 您可以在裝置的 「裝置詳細資料」 檢視上檢視及更新屬性。
選擇左側窗格中的 裝置 。
選擇您要變更其屬性之裝置的裝置範本,然後選取目標裝置。
選擇包含裝置屬性的檢視,此檢視可讓您輸入值,然後選取頁面頂端的 [儲存 ]。 在這裡,您會看到裝置具有的屬性及其目前值。 雲端屬性和可寫屬性具有可編輯欄位,而裝置屬性是唯讀的。 對於可寫入的屬性,您可以在欄位底部看到其同步狀態。
將屬性修改為您需要的值。 您可以一次修改多個屬性,並同時更新所有屬性。
選擇儲存。 如果您儲存了可寫入的內容,則這些值會傳送到您的裝置。 當裝置確認可寫入屬性的變更時,狀態會變回已同步。 如果您儲存了雲端屬性,該值會被更新。