az iot ops asset

Anteprima
Riferimento

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 . 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 le risorse.

Comandi

Nome	Descrizione	Tipo	Status
az iot ops asset create	Creare un asset.	Estensione	Anteprima
az iot ops asset data-point	Gestire i punti dati in un asset.	Estensione	Anteprima
az iot ops asset data-point add	Aggiungere un punto dati a un asset.	Estensione	Anteprima
az iot ops asset data-point export	Esportare i punti dati in un asset.	Estensione	Anteprima
az iot ops asset data-point import	Importare punti dati in un asset.	Estensione	Anteprima
az iot ops asset data-point list	Elencare i punti dati in un asset.	Estensione	Anteprima
az iot ops asset data-point remove	Rimuovere un punto dati in un asset.	Estensione	Anteprima
az iot ops asset delete	Eliminare un asset.	Estensione	Anteprima
az iot ops asset endpoint	Gestire i profili endpoint degli asset.	Estensione	Anteprima
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 event	Gestire gli eventi in un asset.	Estensione	Anteprima
az iot ops asset event add	Aggiungere un evento a un asset.	Estensione	Anteprima
az iot ops asset event export	Esportare eventi in un asset.	Estensione	Anteprima
az iot ops asset event import	Importare eventi in un asset.	Estensione	Anteprima
az iot ops asset event list	Elencare gli eventi in un asset.	Estensione	Anteprima
az iot ops asset event remove	Rimuovere un evento in un asset.	Estensione	Anteprima
az iot ops asset query	Eseguire una query su Resource Graph per gli asset.	Estensione	Anteprima
az iot ops asset show	Visualizzare un asset.	Estensione	Anteprima
az iot ops asset update	Aggiornare un asset.	Estensione	Anteprima

az iot ops asset 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 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.

È necessario definire almeno un punto dati o un evento durante la creazione di asset. Per esempi di formati di file, vedere aka.ms/aziotops-assets.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--cg]
                        [--cl]
                        [--clg]
                        [--cls]
                        [--cluster]
                        [--cluster-subscription]
                        [--data]
                        [--data-file]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Esempio

Creare un asset usando la posizione personalizzata specificata.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data data_source={data_source}

Creare un asset 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 create --name {asset_name} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --endpoint {endpoint} --data data_source={data_source}

Creare un asset usando il nome del cluster specificato. Il gruppo di risorse deve essere incluso se sono presenti più cluster con lo stesso nome all'interno di una sottoscrizione.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --cluster-resource-group {cluster_resource_group} --endpoint {endpoint} --event event_notifier={event_notifier}

Creare un asset usando il nome del cluster specificato e la posizione personalizzata.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --custom-location {custom_location} --endpoint {endpoint} --event event_notifier={event_notifier}

Creare un asset con valori predefiniti di punto dati e eventi personalizzati.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval} --event event_notifier={event_notifier}

Creare un asset con attributi personalizzati aggiuntivi.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --custom-attribute {attribute_key}={attribute_value} --custom-attribute {attribute_key}={attribute_value}

Creare un asset con tipo di asset personalizzato, descrizione, URI della documentazione, ID risorsa esterna, revisione hardware, codice prodotto e revisione software.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision} --data data_source={data_source}

Creare un asset con due eventi, produttore, URI produttore, modello, numero di serie.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --event capability_id={capability_id} event_notifier={event_notifier} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --event event_notifier={event_notifier} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

Creare un asset disabilitato con due punti dati.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --disable --data capability_id={capability_id} data_source={data_source} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --data data_source={data_source}

Creare un asset usando un file contenente i punti dati e un altro file contenente eventi.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data-file /path/to/myasset_datapoints.json --event-file /path/to/myasset_events.csv

Creare un asset con i valori precompilati specificati.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data capability_id=myTagId data_source=NodeID1 name=myTagName1 observability_mode=counter sampling_interval=10 queue_size=2 --data data_source=NodeID2 --data-publish-int 1000 --data-queue-size 1 --data-sample-int 30 --asset-type customAsset --description 'Description for a test asset.' --documentation-uri www.help.com --external-asset-id 000-000-0000 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

Parametri necessari

--endpoint

Nome dell'endpoint dell'asset.

--name -n

Nome asset.

--resource-group -g

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

Parametri facoltativi

--asset-type --at

Tipo di asset.

--attr --custom-attribute

Coppie chiave=valore separate da spazi corrispondenti ad attributi personalizzati aggiuntivi per l'asset.

--cg --cluster-resource-group

Gruppo di risorse per il cluster.

--cl --custom-location

Percorso personalizzato usato per associare l'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. Se non specificato, verrà usato l'ID sottoscrizione asset.

--cluster -c

Cluster a cui associare l'asset.

--cluster-subscription --cs

ID sottoscrizione per il cluster. Se non specificato, verrà usato l'ID sottoscrizione asset.

--data

Coppie chiave=valore separate da spazi corrispondenti alle proprietà del punto dati da creare. Sono supportati i valori di chiave seguenti: capability_id, data_source (obbligatorio), name, observability_mode (none, misuratore, contatore, istogramma o log) (int), sampling_interval queue_size (int). --data può essere usato 1 o più volte. Esaminare gli esempi della Guida per l'utilizzo completo dei parametri.

--data-file --df

Percorso del file contenente i punti dati. Sono supportati i tipi di file seguenti: csv, json, portal-csv, yaml.

--data-publish-int --dpi

Intervallo di pubblicazione predefinito per i punti dati.

Valore predefinito: 1000

--data-queue-size --dqs

Dimensioni della coda predefinite per i punti dati.

Valore predefinito: 1

--data-sample-int --dsi

Intervallo di campionamento predefinito (in millisecondi) per i punti dati.

Valore predefinito: 500

--description -d

Descrizione.

--disable

Disabilitare un asset.

Valori accettati: false, true

Valore predefinito: False

--display-name --dn

Nome visualizzato.

--documentation-uri --du

URI della documentazione.

--eai --external-asset-id

ID risorsa esterna.

--ef --event-file

Percorso del file contenente gli eventi. Sono supportati i tipi di file seguenti: csv, json, portal-csv, yaml.

--epi --event-publish-int

Intervallo di pubblicazione predefinito per gli eventi.

Valore predefinito: 1000

--eqs --event-queue-size

Dimensioni della coda predefinite per gli eventi.

Valore predefinito: 1

--esi --event-sample-int

Intervallo di campionamento predefinito (in millisecondi) per gli eventi.

Valore predefinito: 500

--event

Coppie chiave=valore separate da spazi corrispondenti alle proprietà dell'evento da creare. Sono supportati i valori di chiave seguenti: capability_id, event_notifier (obbligatorio), name, observability_mode (nessuno o log), (int), queue_size sampling_interval (int). --event può essere usato 1 o più volte. Esaminare gli esempi della Guida per l'utilizzo completo dei parametri.

--hardware-revision --hr

Revisione hardware.

--location -l

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

--manufacturer

Fabbricante.

--manufacturer-uri --mu

URI produttore.

--model

Modello.

--pc --product-code

Codice prodotto.

--serial-number --sn

Numero di serie.

--software-revision --sr

Revisione software.

--tags

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

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 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 asset.

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

Esempio

Eliminare un asset.

az iot ops asset delete --name {asset_name} -g {resource_group}

Parametri necessari

--name -n

Nome 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 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 asset.

az iot ops asset query [--asset-type]
                       [--cl]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint]
                       [--hardware-revision]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]

Esempio

Eseguire una query per gli asset disabilitati all'interno di un determinato gruppo di risorse.

az iot ops asset query -g {resource_group} --disabled

Eseguire una query per gli asset con il modello, il produttore e il numero di serie specificati.

az iot ops asset query --model {model} --manufacturer {manufacturer} --serial-number {serial_number}

Parametri facoltativi

--asset-type --at

Tipo di asset.

--cl --custom-location

Percorso personalizzato usato per associare l'asset al cluster.

--description -d

Descrizione.

--disabled

Stato dell'asset.

Valori accettati: false, true

--display-name --dn

Nome visualizzato.

--documentation-uri --du

URI della documentazione.

--eai --external-asset-id

ID risorsa esterna.

--endpoint

Nome dell'endpoint dell'asset.

--hardware-revision --hr

Revisione hardware.

--location -l

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

--manufacturer

Fabbricante.

--manufacturer-uri --mu

URI produttore.

--model

Modello.

--pc --product-code

Codice prodotto.

--resource-group -g

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

--serial-number --sn

Numero di serie.

--software-revision --sr

Revisione software.

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 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 asset.

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

Esempio

Visualizzare i dettagli di un asset.

az iot ops asset show --name {asset_name} -g {resource_group}

Parametri necessari

--name -n

Nome 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 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 asset.

Per aggiornare i punti dati e gli eventi, usare rispettivamente i gruppi az iot ops asset data-point az iot ops asset events di comandi.

az iot ops asset update --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Esempio

Aggiornare le impostazioni predefinite per il punto dati e l'evento di un asset.

az iot ops asset update --name {asset_name} -g {resource_group} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval}

Aggiornare il tipo di asset, la descrizione, l'URI della documentazione, l'ID risorsa esterna, la revisione hardware, il codice prodotto e la revisione software.

az iot ops asset update --name {asset_name} -g {resource_group} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision}

Aggiornare il produttore, l'URI del produttore, il modello, il numero di serie e l'attributo personalizzato di un asset.

az iot ops asset update --name {asset_name} -g {resource_group} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number} --custom-attribute {attribute_key}={attribute_value}

Disabilitare un asset e rimuovere un attributo personalizzato denominato "work_site".

az iot ops asset update --name {asset_name} -g {resource_group} --disable --custom-attribute work_site=""

Parametri necessari

--name -n

Nome asset.

--resource-group -g

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

Parametri facoltativi

--asset-type --at

Tipo di asset.

--attr --custom-attribute

Coppie chiave=valore separate da spazi corrispondenti ad attributi personalizzati aggiuntivi per l'asset. Per rimuovere un attributo personalizzato, impostare il valore dell'attributo su "".

--data-publish-int --dpi

Intervallo di pubblicazione predefinito per i punti dati.

--data-queue-size --dqs

Dimensioni della coda predefinite per i punti dati.

--data-sample-int --dsi

Intervallo di campionamento predefinito (in millisecondi) per i punti dati.

--description -d

Descrizione.

--disable

Disabilitare un asset.

Valori accettati: false, true

--display-name --dn

Nome visualizzato.

--documentation-uri --du

URI della documentazione.

--eai --external-asset-id

ID risorsa esterna.

--epi --event-publish-int

Intervallo di pubblicazione predefinito per gli eventi.

--eqs --event-queue-size

Dimensioni della coda predefinite per gli eventi.

--esi --event-sample-int

Intervallo di campionamento predefinito (in millisecondi) per gli eventi.

--hardware-revision --hr

Revisione hardware.

--manufacturer

Fabbricante.

--manufacturer-uri --mu

URI produttore.

--model

Modello.

--pc --product-code

Codice prodotto.

--serial-number --sn

Numero di serie.

--software-revision --sr

Revisione software.

--tags

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

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.

Condividi tramite

az iot ops asset

Comandi

az iot ops asset create

Esempio

Parametri necessari

Parametri facoltativi

az iot ops asset delete

Esempio

Parametri necessari

az iot ops asset query

Esempio

Parametri facoltativi

az iot ops asset show

Esempio

Parametri necessari

az iot ops asset update

Esempio

Parametri necessari

Parametri facoltativi

Risorse aggiuntive