共用方式為

az iot ops asset endpoint

  • 參考

注意

此參考是 Azure CLI 的 azure-iot-ops 擴充功能的一部分（2.53.0 版或更高版本）。 擴充功能會在您第一次執行 az iot ops asset endpoint 命令時自動安裝。 深入了解擴充功能。

管理資產端點配置檔。

命令

名稱 Description 類型 狀態
az iot ops asset endpoint create

建立資產端點配置檔。

 副檔名 加語
az iot ops asset endpoint create opcua

使用 OPCUA 連接器建立資產端點配置檔。

 副檔名 加語
az iot ops asset endpoint delete

刪除資產端點配置檔。

 副檔名 加語
az iot ops asset endpoint query

查詢 Resource Graph 以取得資產端點配置檔。

 副檔名 加語
az iot ops asset endpoint show

顯示資產端點配置檔。

 副檔名 加語
az iot ops asset endpoint update

更新資產端點配置檔。

 副檔名 加語

az iot ops asset endpoint delete

刪除資產端點配置檔。

az iot ops asset endpoint delete --name
                                 --resource-group

範例

刪除資產端點配置檔。

az iot ops asset endpoint delete --name myprofile -g myresourcegroup

必要參數

--name -n

資產端點配置檔名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset endpoint query

查詢 Resource Graph 以取得資產端點配置檔。

az iot ops asset endpoint query [--am {Anonymous, Certificate, UsernamePassword}]
                                [--cq]
                                [--endpoint-profile-type]
                                [--ig]
                                [--instance]
                                [--location]
                                [--name]
                                [--resource-group]
                                [--ta]

範例

查詢具有匿名驗證的資產端點配置檔。

az iot ops asset endpoint query --authentication-mode Anonymous

查詢具有指定目標地址和實例名稱的資產端點配置檔。

az iot ops asset endpoint query --target-address opc.tcp://opcplc-000000:50000 --instance myinstance

選擇性參數

--am --authentication-mode

驗證模式。

接受的值: Anonymous, Certificate, UsernamePassword
--cq --custom-query

要使用的自訂查詢。 所有其他查詢自變數都會被忽略。

--endpoint-profile-type --ept

端點配置檔的連接器類型。

--ig --instance-resource-group

實例資源群組。 如果未提供，則會使用資產端點配置檔資源群組。

--instance

要與所建立資產建立關聯的實例名稱。

--location -l

位置。​​ 值的來源：az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--name -n

資產端點配置檔名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--ta --target-address

目標位址。 必須是遵循 opc.tcp 通訊協定的有效本機位址。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset endpoint show

顯示資產端點配置檔。

az iot ops asset endpoint show --name
                               --resource-group

範例

顯示資產端點配置檔的詳細數據。

az iot ops asset endpoint show --name myprofile -g myresourcegroup

必要參數

--name -n

資產端點配置檔名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset endpoint update

更新資產端點配置檔。

若要更新擁有的憑證，請使用命令群組 az iot ops asset endpoint certificate。

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--am {Anonymous, Certificate, UsernamePassword}]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

範例

更新資產端點配置檔的驗證模式，以使用匿名用戶驗證。

az iot ops asset endpoint update --name myprofile -g myresourcegroup --authentication-mode Anonymous

使用預先填入的值更新資產端點配置檔的使用者名稱和密碼參考。 如果驗證模式尚未這麼做，這會將驗證模式轉換成 username-password。

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password"

必要參數

--name -n

資產端點配置檔名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--am --authentication-mode

驗證模式。

接受的值: Anonymous, Certificate, UsernamePassword
--cert-ref --certificate-ref --cr

驗證中使用的憑證參考。 尚不支援這個用戶驗證方法。

--password-ref --pr

驗證中使用的密碼參考。

--ta --target-address

目標位址。 必須是遵循 opc.tcp 通訊協定的有效本機位址。

--tags

資產端點配置檔資源標籤。 索引鍵/值組中的屬性包，格式如下：a=b c=d。

--ur --username-reference

驗證中使用的用戶名稱參考。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。