az iot ops asset endpoint

Nota

Questo riferimento fa parte dell'estensione azure-iot-ops per l'interfaccia della riga di comando di Azure (versione 2.53.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot ops asset endpoint . Altre informazioni sulle estensioni.

Il gruppo di comandi 'iot ops' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire i profili endpoint degli asset.

Comandi

Nome Descrizione Tipo Status
az iot ops asset endpoint certificate

Gestire i certificati di proprietà in un endpoint di asset.

Estensione Anteprima
az iot ops asset endpoint certificate add

Aggiungere un certificato di proprietà a un endpoint dell'asset.

Estensione Anteprima
az iot ops asset endpoint certificate list

Elencare i certificati di proprietà in un endpoint di asset.

Estensione Anteprima
az iot ops asset endpoint certificate remove

Rimuovere un certificato di proprietà in un endpoint di asset.

Estensione Anteprima
az iot ops asset endpoint create

Creare un endpoint dell'asset.

Estensione Anteprima
az iot ops asset endpoint delete

Eliminare un endpoint dell'asset.

Estensione Anteprima
az iot ops asset endpoint query

Eseguire una query su Resource Graph per gli endpoint degli asset.

Estensione Anteprima
az iot ops asset endpoint show

Visualizzare un endpoint dell'asset.

Estensione Anteprima
az iot ops asset endpoint update

Aggiornare un endpoint dell'asset.

Estensione Anteprima

az iot ops asset endpoint create

Anteprima

Il gruppo di comandi 'iot ops' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare un endpoint dell'asset.

È necessario specificare la posizione personalizzata o il nome del cluster. Questo comando verificherà l'esistenza del percorso e del cluster personalizzati associati e garantirà che entrambi siano configurati correttamente con l'estensione microsoft.deviceregistry.assets.

Azure IoT OPC UA Broker (anteprima) usa lo stesso certificato client per tutti i canali sicuri tra se stesso e i server OPC UA a cui si connette.

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]

Esempio

Creare un endpoint di asset con autenticazione utente anonima usando la posizione personalizzata specificata.

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

Creare un endpoint di asset con autenticazione utente anonima usando la posizione personalizzata e il gruppo di risorse specificati per la posizione personalizzata. Il gruppo di risorse deve essere incluso se sono presenti più percorsi personalizzati con lo stesso nome all'interno di una sottoscrizione.

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}

Creare un endpoint di asset con autenticazione utente-password utente e certificati di proprietà preconfigurati con valori precompilato. I riferimenti a nome utente e password vengono impostati tramite il driver dell'interfaccia di archiviazione contenitori di Azure KeyVault.

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

Creare un endpoint di asset con l'autenticazione utente con password utente e una configurazione aggiuntiva con valori precompilato (esempio di sintassi di PowerShell).

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}}'

Creare un endpoint di asset con l'autenticazione utente con password utente e una configurazione aggiuntiva con valori precompilato (esempio di sintassi cmd).

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}}"

Creare un endpoint di asset con l'autenticazione utente con password utente e una configurazione aggiuntiva con valori precompilato (esempio di sintassi bash).

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}}'

Parametri necessari

--name -n

Nome endpoint asset.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--ta --target-address

Indirizzo di destinazione. Deve essere un indirizzo locale valido.

Parametri facoltativi

--ac --additional-config

Configurazione aggiuntiva per il tipo di connettività (ad esempio: OPC UA, Modbus, ONVIF).

--cert

Coppie chiave=valore separate da spazi corrispondenti ai certificati associati all'endpoint. Sono supportati i valori di chiave seguenti: secret (obbligatorio), thumbprint (obbligatorio), password.--cert può essere usato 1 o più volte. Esaminare gli esempi della Guida per l'utilizzo completo dei parametri.

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

Riferimento per il certificato usato nell'autenticazione. Questo metodo di autenticazione utente non è ancora supportato.

--cg --cluster-resource-group

Gruppo di risorse per il cluster.

--cl --custom-location

Percorso personalizzato usato per associare l'endpoint dell'asset al cluster.

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

Gruppo di risorse per la posizione personalizzata.

--cls --custom-location-subscription

ID sottoscrizione per la posizione personalizzata.

--cluster -c

Cluster a cui associare l'asset.

--cluster-subscription --cs

ID sottoscrizione per il cluster.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--password-ref --pr

Informazioni di riferimento sulla password usata nell'autenticazione.

--tags

Tag di risorsa endpoint asset. Contenitore delle proprietà in coppie chiave-valore con il formato seguente: a=b c=d.

--ur --username-reference

Riferimento per il nome utente usato nell'autenticazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot ops asset endpoint delete

Anteprima

Il gruppo di comandi 'iot ops' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un endpoint dell'asset.

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

Esempio

Eliminare un endpoint dell'asset.

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

Parametri necessari

--name -n

Nome endpoint asset.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot ops asset endpoint query

Anteprima

Il gruppo di comandi 'iot ops' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eseguire una query su Resource Graph per gli endpoint degli asset.

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

Esempio

Eseguire una query per gli endpoint di asset che eseguono l'autenticazione anonima.

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

Eseguire una query per gli endpoint di asset con l'indirizzo di destinazione e la posizione personalizzata specificati.

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

Parametri facoltativi

--ac --additional-config

Configurazione aggiuntiva per il tipo di connettività (ad esempio: OPC UA, Modbus, ONVIF).

--am --authentication-mode

Modalità di autenticazione.

--cl --custom-location

Percorso personalizzato usato per associare l'endpoint dell'asset al cluster.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--ta --target-address

Indirizzo di destinazione. Deve essere un indirizzo locale valido.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot ops asset endpoint show

Anteprima

Il gruppo di comandi 'iot ops' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Visualizzare un endpoint dell'asset.

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

Esempio

Visualizzare i dettagli di un endpoint dell'asset.

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

Parametri necessari

--name -n

Nome endpoint asset.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot ops asset endpoint update

Anteprima

Il gruppo di comandi 'iot ops' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare un endpoint dell'asset.

Per aggiornare i certificati di proprietà, usare il gruppo az iot ops asset endpoint certificatedi comandi .

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

Esempio

Aggiornare la modalità di autenticazione di un endpoint asset per usare l'autenticazione utente anonima.

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

Aggiornare il nome utente e la password di un endpoint asset con valori precompilato. In questo modo la modalità di autenticazione verrà trasformata in username-password se non è già così.

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"

Aggiornare l'indirizzo di destinazione di un endpoint asset e una configurazione aggiuntiva con valori precompilato (esempio di sintassi di PowerShell).

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}}'

Aggiornare l'indirizzo di destinazione di un endpoint asset e una configurazione aggiuntiva con valori precompilato (esempio di sintassi cmd).

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}}"

Aggiornare l'indirizzo di destinazione di un endpoint asset e una configurazione aggiuntiva con valori precompilato (esempio di sintassi bash).

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}}'

Parametri necessari

--name -n

Nome endpoint asset.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--ac --additional-config

Configurazione aggiuntiva per il tipo di connettività (ad esempio: OPC UA, Modbus, ONVIF).

--am --authentication-mode

Modalità di autenticazione.

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

Riferimento per il certificato usato nell'autenticazione. Questo metodo di autenticazione utente non è ancora supportato.

--password-ref --pr

Informazioni di riferimento sulla password usata nell'autenticazione.

--ta --target-address

Indirizzo di destinazione. Deve essere un indirizzo locale valido.

--tags

Tag di risorsa endpoint asset. Contenitore delle proprietà in coppie chiave-valore con il formato seguente: a=b c=d.

--ur --username-reference

Riferimento per il nome utente usato nell'autenticazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.