az iot ops asset endpoint

  • Förhandsgranskning
  • Referens

Kommentar

Den här referensen är en del av azure-iot-ops-tillägget för Azure CLI (version 2.53.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az iot ops asset endpoint . Läs mer om tillägg.

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera tillgångsslutpunktsprofiler.

Kommandon

Name Description Typ Status
az iot ops asset endpoint certificate

Hantera ägda certifikat i en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate add

Lägg till ett ägt certifikat till en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate list

Visa en lista över ägda certifikat i en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate remove

Ta bort ett ägt certifikat i en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint create

Skapa en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint delete

Ta bort en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint query

Fråga Resource Graph efter tillgångsslutpunkter.

 Anknytning Förhandsversion
az iot ops asset endpoint show

Visa en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint update

Uppdatera en tillgångsslutpunkt.

 Anknytning Förhandsversion

az iot ops asset endpoint create

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapa en tillgångsslutpunkt.

Antingen måste du ange en anpassad plats eller ett klusternamn. Det här kommandot söker efter befintligheten för den associerade anpassade platsen och klustret och ser till att båda är korrekt konfigurerade med tillägget microsoft.deviceregistry.assets.

Azure IoT OPC UA Broker (förhandsversion) använder samma klientcertifikat för alla säkra kanaler mellan sig själv och de OPC UA-servrar som det ansluter till.

az iot ops asset endpoint create --name
                                 --resource-group
                                 --ta
                                 [--ac]
                                 [--cert]
                                 [--cert-ref]
                                 [--cg]
                                 [--cl]
                                 [--clg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

Exempel

Skapa en tillgångsslutpunkt med anonym användarautentisering med den angivna anpassade platsen.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --target-address {target_address}

Skapa en tillgångsslutpunkt med anonym användarautentisering med den angivna anpassade platsen och resursgruppen för den anpassade platsen. Resursgruppen måste inkluderas om det finns flera anpassade platser med samma namn i en prenumeration.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --target-address {target_address}

Skapa en tillgångsslutpunkt med användarautentisering med användarnamn och lösenord och förkonfigurerade ägda certifikat med förifyllda värden. Referenserna för användarnamn och lösenord anges via drivrutinen för Azure Keyvault Container Storage Interface.

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --cert secret=aio-opc-ua-broker-client-certificate thumbprint=000000000000000000 password=aio-opc-ua-broker-client-certificate-password

Skapa en tillgångsslutpunkt med användarautentisering med användarnamn och lösenord och ytterligare konfiguration med förfyllda värden (exempel på powershell-syntax).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Skapa en tillgångsslutpunkt med användarautentisering med användarnamn och lösenord och ytterligare konfiguration med förfyllda värden (exempel på cmd-syntax).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Skapa en tillgångsslutpunkt med användarautentisering med användarnamn och lösenord och ytterligare konfiguration med förfyllda värden (bash-syntaxexempel).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Obligatoriska parametrar

--name -n

Tillgångsslutpunktsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--ta --target-address

Måladress. Måste vara en giltig lokal adress.

Valfria parametrar

--ac --additional-config

Ytterligare konfiguration för anslutningstypen (t.ex. OPC UA, Modbus, ONVIF).

--cert

Blankstegsavgränsade nyckel=värdepar som motsvarar certifikat som är associerade med slutpunkten. Följande nyckelvärden stöds: secret (krävs), thumbprint (krävs), password.--cert kan användas 1 eller fler gånger. Granska hjälpexemplen för fullständig parameteranvändning.

--cert-ref --certificate-ref --cr

Referens för certifikatet som används i autentiseringen. Den här metoden för användarautentisering stöds inte ännu.

--cg --cluster-resource-group

Resursgrupp för kluster.

--cl --custom-location

Anpassad plats som används för att associera tillgångsslutpunkt med kluster.

--clg --custom-location-resource-group

Resursgrupp för anpassad plats.

--cls --custom-location-subscription

Prenumerations-ID för anpassad plats.

--cluster -c

Kluster som tillgången ska associeras med.

--cluster-subscription --cs

Prenumerations-ID för kluster.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--password-ref --pr

Referens för lösenordet som används i autentiseringen.

--tags

Resurstaggar för tillgångsslutpunkt. Egenskapsväska i nyckel/värde-par med följande format: a=b c=d.

--ur --username-reference

Referens för användarnamnet som används i autentiseringen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset endpoint delete

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort en tillgångsslutpunkt.

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

Exempel

Ta bort en tillgångsslutpunkt.

az iot ops asset endpoint delete --name {asset_endpoint} -g {resource_group}

Obligatoriska parametrar

--name -n

Tillgångsslutpunktsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset endpoint query

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Fråga Resource Graph efter tillgångsslutpunkter.

az iot ops asset endpoint query [--ac]
                                [--am]
                                [--cl]
                                [--location]
                                [--resource-group]
                                [--ta]

Exempel

Fråga efter tillgångsslutpunkter som har anonym autentisering.

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

Fråga efter tillgångsslutpunkter som har den angivna måladressen och den anpassade platsen.

az iot ops asset endpoint query --target-address {target_address} --custom-location {custom_location}

Valfria parametrar

--ac --additional-config

Ytterligare konfiguration för anslutningstypen (t.ex. OPC UA, Modbus, ONVIF).

--am --authentication-mode

Autentiseringsläge.

--cl --custom-location

Anpassad plats som används för att associera tillgångsslutpunkt med kluster.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--ta --target-address

Måladress. Måste vara en giltig lokal adress.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset endpoint show

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa en tillgångsslutpunkt.

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

Exempel

Visa information om en tillgångsslutpunkt.

az iot ops asset endpoint show --name {asset_endpoint} -g {resource_group}

Obligatoriska parametrar

--name -n

Tillgångsslutpunktsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset endpoint update

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Uppdatera en tillgångsslutpunkt.

Om du vill uppdatera ägda certifikat använder du kommandogruppen az iot ops asset endpoint certificate.

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--ac]
                                 [--am]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

Exempel

Uppdatera en tillgångsslutpunkts autentiseringsläge för att använda anonym användarautentisering.

az iot ops asset endpoint update --name {asset_endpoint} -g {resource_group} --authentication-mode Anonymous

Uppdatera en tillgångsslutpunkts användarnamn och lösenordsreferens med förfyllda värden. Detta omvandlar autentiseringsläget till användarnamn och lösenord om det inte redan är det.

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"

Uppdatera en tillgångsslutpunkts måladress och ytterligare konfiguration med förfyllda värden (exempel på powershell-syntax).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Uppdatera en tillgångsslutpunkts måladress och ytterligare konfiguration med förfyllda värden (exempel på cmd-syntax).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Uppdatera en tillgångsslutpunkts måladress och ytterligare konfiguration med förfyllda värden (bash-syntaxexempel).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Obligatoriska parametrar

--name -n

Tillgångsslutpunktsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--ac --additional-config

Ytterligare konfiguration för anslutningstypen (t.ex. OPC UA, Modbus, ONVIF).

--am --authentication-mode

Autentiseringsläge.

--cert-ref --certificate-ref --cr

Referens för certifikatet som används i autentiseringen. Den här metoden för användarautentisering stöds inte ännu.

--password-ref --pr

Referens för lösenordet som används i autentiseringen.

--ta --target-address

Måladress. Måste vara en giltig lokal adress.

--tags

Resurstaggar för tillgångsslutpunkt. Egenskapsväska i nyckel/värde-par med följande format: a=b c=d.

--ur --username-reference

Referens för användarnamnet som används i autentiseringen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.