從遠端管理資產設定

重要

Azure IoT Operations Preview – 由 Azure Arc 啟用目前處於預覽狀態。 您不應該在生產環境中使用此預覽軟體。

請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

Azure IoT Operations Preview 中的資產是您建立來代表實際資產的邏輯實體。 Azure IoT Operations 資產可以有描述其行為和特性的屬性、標籤和事件。

OPC UA 伺服器 是與資產通訊的軟體應用程式。 OPC UA 伺服器會公開 代表數據點的 OPC UA 標記 。 OPC UA 標記提供資產狀態、效能、品質或條件的即時或歷程記錄數據。

資產端點是 Kubernetes 叢集中的自訂資源，會將 OPC UA 伺服器連線到 OPC UA 連接器模組。 此連線可讓 OPC UA 連接器存取資產的數據點。 如果沒有資產端點，數據就無法從 OPC UA 伺服器流向 Azure IoT OPC UA Broker 預覽實例和 Azure IoT MQ 預覽實例。 在叢集中設定自定義資源之後，會建立與下游 OPC UA 伺服器的連線，而伺服器會將遙測轉送至 OPC UA Broker 實例。

網站是 Azure IoT 作業實例的集合。 網站可協助您組織實例及管理訪問控制。 IT 系統管理員會建立網站、為其指派實例，以及授與組織中 OT 使用者的存取權。

在 Azure IoT 作業 （預覽版） 入口網站中， 實例 代表 Azure IoT 作業叢集。 實例可以有一或多個資產端點。

本文說明如何使用 Azure IoT 作業（預覽版）入口網站和 Azure CLI 來：

• 定義資產端點
• 新增資產，並定義標籤和事件

這些資產、標記和事件會將 OPC UA 伺服器的輸入數據對應至您可以在 MQ 訊息代理程式和 Azure IoT 數據處理者預覽管線中使用的易記名稱。

必要條件

若要設定資產端點，您需要執行中的 Azure IoT 作業實例。

登入

Azure IoT 作業入口網站

若要登入 Azure IoT Operations （預覽） 入口網站，請瀏覽至瀏覽器中的 Azure IoT Operations （預覽） 入口網站，並使用您的 Microsoft Entra ID 認證登入。

選取您的網站

登入之後，入口網站會顯示您有權存取的網站清單。 每個網站都是 Azure IoT Operations 實例的集合，您可以在其中設定資產。 IT 系統管理員負責將 實例組織到網站 ，並授與組織中 OT 使用者的存取權。 不屬於月臺的實例會出現在 [未指派的 實例] 節點中。 選取您想要使用的網站：

提示

您可以使用篩選方塊來搜尋網站。

如果您沒有看到任何網站，您可能不在正確的 Azure Active Directory 租使用者中。 您可以從入口網站右上方功能表變更租使用者。 如果您仍然看不到任何表示您尚未新增至任何網站的網站。 連絡IT系統管理員以要求存取權。

選取您的實例

選取月臺之後，入口網站會顯示屬於月臺一部分的 Azure IoT 作業實例清單。 選取您想要使用的實體：

提示

您可以使用篩選方塊來搜尋實例。

Azure CLI

使用 az iot ops asset 命令之前，請先登入包含 Azure IoT 作業部署的訂用帳戶：

az login

建立資產端點

根據預設，Azure IoT 作業部署包含內建 OPC PLC 模擬器。 若要建立使用內建 OPC PLC 模擬器的資產端點：

Azure IoT 作業入口網站

1. 選取 [資產端點]，然後選取 [建立資產端點]：

   

   提示

   您可以使用篩選方塊來搜尋資產端點。

2. 輸入下列端點資訊：

   欄位	值
   名稱	opc-ua-connector-0
   OPC UA Broker URL	opc.tcp://opcplc-000000:50000
   使用者驗證	Anonymous
   傳輸驗證	Do not use transport authentication certificate

3. 若要儲存定義，請選取 [ 建立]。

Azure CLI

執行以下命令：

az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} 

提示

用來 az connectedk8s list 列出您有權存取的叢集。

若要深入瞭解，請參閱 az iot ops asset endpoint。

此組態會將名為 opc-ua-connector-0 的新assetendpointprofile資源部署到叢集。 定義資產之後，OPC UA 連接器 Pod 會探索它。 Pod 會使用您在資產定義中指定的資產端點來連線到 OPC UA 伺服器。

當 OPC PLC 模擬器執行時，數據會從模擬器、連接器流向 OPC UA 訊息代理程式，最後流向 MQ 訊息代理程式。

設定資產端點以使用使用者名稱和密碼

上述範例會 Anonymous 使用驗證模式。 此模式不需要使用者名稱或密碼。

Azure IoT 作業入口網站

若要使用 UsernamePassword 驗證模式，請完成下列步驟：

1. 依照使用使用者名稱和密碼設定 OPC UA 用戶驗證中的步驟，在 Azure 金鑰保存庫 中新增使用者名稱和密碼的秘密，並將其投影到 Kubernetes 叢集中。
2. 在 Azure IoT 作業 （預覽） 入口網站中，選取 [用戶驗證] 欄位的使用者名稱和密碼，以設定資產端點以使用這些秘密。 然後，針對 [使用者名稱參考] 和 [密碼參考] 欄位輸入下列值：

欄位	值
用戶名稱參考	aio-opc-ua-broker-user-authentication/username
密碼參考	aio-opc-ua-broker-user-authentication/password

Azure CLI

若要使用 UsernamePassword 驗證模式，請完成下列步驟：

1. 依照使用使用者名稱和密碼設定 OPC UA 用戶驗證中的步驟，在 Azure 金鑰保存庫 中新增使用者名稱和密碼的秘密，並將其投影到 Kubernetes 叢集中。

2. 使用類似下列範例的命令來建立資產端點：

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

設定資產端點以使用傳輸驗證憑證

若要將資產端點設定為使用傳輸驗證憑證，請完成下列步驟：

Azure IoT 作業入口網站

1. 請遵循設定相互信任的步驟，將傳輸憑證和私鑰新增至 Azure 金鑰保存庫，並將其投影至 Kubernetes 叢集。
2. 在 Azure IoT 作業 （預覽） 入口網站中，針對 [傳輸驗證] 欄位選取 [使用傳輸驗證憑證]，然後輸入憑證指紋。

Azure CLI

1. 請遵循設定相互信任的步驟，將傳輸憑證和私鑰新增至 Azure 金鑰保存庫，並將其投影至 Kubernetes 叢集。

2. 使用類似下列範例的命令來建立資產端點：

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

若要深入瞭解，請參閱 az iot ops asset。

新增資產、標記和事件

Azure IoT 作業入口網站

若要在 Azure IoT 作業 （預覽版） 入口網站中新增資產：

1. 選取 [ 資產] 索引標籤。建立任何資產之前，您會看到下列畫面：

   

   提示

   您可以使用篩選方塊來搜尋資產。

   選取 [ 建立資產]。

2. 在 [資產詳細數據] 畫面上，輸入下列資產資訊：

   • 資產名稱
   • 資產端點。 從清單中選取您的資產端點。
   • 描述

   

3. 設定您想要與資產建立關聯的屬性集。 您可以接受預設的屬性清單，或新增您自己的屬性。 預設會提供下列屬性：

   • 製造商
   • 製造商 URI
   • 模型
   • 產品代碼
   • 硬體版本
   • 軟體版本
   • 序號
   • 檔 URI

4. 選取 [下一步 ] 以移至 [ 新增卷標 ] 頁面。

將個別標記新增至資產

現在您可以定義與資產相關聯的標記。 若要新增 OPC UA 標籤：

1. 選取 [新增卷標] 或 [ CSV > 新增標籤]。

2. 輸入您的標籤詳細資料：

   • 節點標識碼。 此值是 OPC UA 伺服器的節點識別碼。
   • 標籤名稱（選擇性）。 此值是您要用於標記的易記名稱。 如果您未指定標籤名稱，則會使用節點識別碼作為標籤名稱。
   • 具有下列選項的可檢視模式（選擇性）：
     • 無
     • 量測計
     • 計數器
     • 長條圖
     • 記錄
   • 取樣間隔（毫秒）。 您可以覆寫此標籤的預設值。
   • 佇列大小。 您可以覆寫此標籤的預設值。

   

   下表顯示可與內建 OPC PLC 模擬器搭配使用的一些範例標記值：

   節點識別碼	標籤名稱	可檢視模式
   ns=3;s=FastUInt10	溫度	none
   ns=3;s=FastUInt100	標記 10	none

3. 選取 [管理預設設定 ] 以設定資產的預設遙測設定。 這些設定適用於屬於資產的所有 OPC UA 標籤。 您可以覆寫您新增的每個標籤的這些設定。 預設遙測設定包括：

   • 取樣間隔 （毫秒）：取樣間隔指出 OPC UA 伺服器應該取樣其基礎來源以進行數據變更的最快速率。
   • 發佈間隔（毫秒）：OPC UA 伺服器應該發佈數據的速率。
   • 佇列大小：在發佈取樣數據之前，要保存取樣數據的佇列深度。

將大量標記新增至資產

您一次最多可以從 CSV 檔案匯入 1000 個 OPC UA 標籤：

1. 建立類似下列範例的 CSV 檔案：

   NodeID	TagName	取樣間隔毫秒	QueueSize	ObservabilityMode
   ns=3;s=FastUInt1000	標記 1000	1000	5	none
   ns=3;s=FastUInt1001	標記 1001	1000	5	none
   ns=3;s=FastUInt1002	標記 1002	5000	10	none

2. 選取 [新增卷標] 或 [ CSV > 匯入 CSV][.csv] 檔案。 選取您建立的 CSV 檔案，然後選取 [ 開啟]。 CSV 檔案中定義的標籤會匯入：

   

   如果您匯入包含現有標籤的 CSV 檔案，Azure IoT 作業 （預覽） 入口網站會顯示下列訊息：

   

   您可以取代重複的標籤，並從匯入檔案新增新的標籤，也可以取消匯入。

3. 若要將所有標籤從資產匯出至 CSV 檔案，請選取 [全部匯出 ]，然後選擇檔案的位置：

   

4. 在 [ 標記] 頁面上，選取 [下一步 ] 以移至 [ 新增事件 ] 頁面。

提示

您可以使用篩選方塊來搜尋標籤。

Azure CLI

使用下列命令，使用 Azure CLI 新增「控溫器」資產。 命令會使用 --data 參數，將兩個標記新增至資產：

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --data  data_source='ns=3;s=FastUInt10', name=temperature --data data_source='ns=3;s=FastUInt100', name='Tag 10'

當您使用 Azure CLI 建立資產時，您可以定義：

• 多次使用 --data 參數的多個標記。
• 多次使用 --event 參數的多個事件。
• 資產的選擇性資訊，例如：
  • 製造商
  • 製造商 URI
  • 模型
  • 產品代碼
  • 硬體版本
  • 軟體版本
  • 序號
  • 檔 URI
• 取樣間隔、發佈間隔和佇列大小的預設值。
• 標記取樣間隔、發佈間隔和佇列大小的特定值。
• 取樣發佈間隔和佇列大小的事件特定值。
• 每個標記和事件的可觀察性模式

將個別事件新增至資產

Azure IoT 作業入口網站

現在您可以定義與資產相關聯的事件。 若要新增 OPC UA 事件：

1. 選取 [新增事件] 或 [ CSV > 新增事件]。

2. 輸入您的事件詳細資料：

   • 事件通知器。 此值是 OPC UA 伺服器的事件通知器。
   • 事件名稱（選擇性）。 此值是您想要用於事件的易記名稱。 如果您未指定事件名稱，則會使用事件通知器作為事件名稱。
   • 具有下列選項的可檢視模式（選擇性）：
     • 無
     • 量測計
     • 計數器
     • 長條圖
     • 記錄
   • 佇列大小。 您可以覆寫此標籤的預設值。

   

3. 選取 [管理預設設定 ] 以設定資產的預設事件設定。 這些設定適用於屬於資產的所有 OPC UA 事件。 您可以針對您新增的每個事件覆寫這些設定。 預設事件設定包括：

   • 發佈間隔（毫秒）：OPC UA 伺服器應該發佈數據的速率。
   • 佇列大小：在發佈取樣數據之前，要保存取樣數據的佇列深度。

將事件大量新增至資產

您一次可以從 CSV 檔案匯入最多 1000 個 OPC UA 事件。

若要將所有事件從資產匯出至 CSV 檔案，請選取 [全部匯出 ]，然後選擇檔案的位置。

在 [ 事件] 頁面上，選取 [下一步 ] 以移至 [ 檢閱] 頁面。

提示

您可以使用篩選方塊來搜尋事件。

檢閱變更

檢閱您的資產和 OPC UA 標籤和事件詳細數據，並進行任何您需要的調整：

Azure CLI

當您使用 Azure CLI 建立資產時，可以使用 參數多次定義多個事件 --event 。 參數的 --event 語法類似於 --data 參數：

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

針對您定義的每個事件，您可以指定：

• 事件通知器。 此值是 OPC UA 伺服器的事件通知器。
• 事件名稱。 此值是您想要用於事件的易記名稱。 如果您未指定事件名稱，則會使用事件通知器作為事件名稱。
• 可檢視模式。
• 佇列大小。

更新資產

Azure IoT 作業入口網站

尋找並選取您先前建立的資產。 使用 [ 資產詳細數據]、 [卷標] 和 [事件 ] 索引卷標來進行任何變更：

在 [ 卷標] 索引標籤上，您可以新增標籤、更新現有的標籤，或移除標籤。

若要更新標籤，請選取現有的標籤並更新標籤資訊。 然後選取 [ 更新]：

若要移除標籤，請選取一或多個標籤，然後選取 [ 移除卷標]：

您也可以以相同方式新增、更新和刪除事件和屬性。

當您完成變更時，請選取 [ 儲存 ] 以儲存變更。

Azure CLI

若要列出您的資產，請使用下列命令：

az iot ops asset query -g {your resource group name}

提示

您可以精簡查詢命令，以搜尋符合特定準則的資產。 例如，您可以依製造商搜尋資產。

若要檢視控溫器資產的詳細數據，請使用下列命令：

az iot ops asset show --name thermostat -g {your resource group}

若要更新資產，請使用 az iot ops asset update 命令。 例如，若要更新資產的描述，請使用類似下列範例的命令：

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

若要列出控溫器資產的標籤，請使用下列命令：

az iot ops asset data-point list --asset thermostat -g {your resource group}

若要列出控溫器資產的事件，請使用下列命令：

az iot ops asset event list --asset thermostat -g {your resource group}

若要將新的標籤新增至控溫器資產，請使用類似下列範例的命令：

az iot ops asset data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

若要刪除標記，請使用 az iot ops asset data-point remove 命令。

您可以使用 命令來管理資產的事件 az iot ops asset event 。

刪除資產

Azure IoT 作業入口網站

若要刪除資產，請選取您要刪除的資產。 在 [ 資產 詳細數據] 頁面上，選取 [ 刪除]。 確認您的變更以刪除資產：

Azure CLI

若要刪除資產，請使用類似下列範例的命令：

az iot ops asset delete --name thermostat -g {your resource group name}

通知

每當您在 Azure IoT 作業 （預覽） 入口網站中變更資產時，您會看到報告作業狀態的通知：

相關內容

• Azure OPC UA Broker 概觀
• Azure IoT Akri 概觀
• az iot ops asset
• az iot ops asset endpoint