Share via

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.46.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 Stato
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.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--cl]
                        [--clrg]
                        [--cls]
                        [--cluster]
                        [--cluster-resource-group]
                        [--cluster-subscription]
                        [--data]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--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 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 con i valori precompilati specificati.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint example.com --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

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.

--cl --custom-location

Percorso personalizzato usato per associare l'asset al cluster.

--clrg --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-resource-group --crg

Gruppo di risorse per il cluster.

--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_intervalqueue_size (int). --data può essere usato 1 o più volte. Esaminare gli esempi della Guida per l'utilizzo completo dei parametri.

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

--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 (none, misuratore, contatore, istogramma o log) (int), sampling_intervalqueue_size (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

Produttore.

--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 sottoscrizione predefinita 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 sottoscrizione predefinita 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

Produttore.

--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 sottoscrizione predefinita 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 sottoscrizione predefinita 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-pointaz iot ops asset events di comandi.

az iot ops asset update --name
                        --resource-group
                        [--asset-type]
                        [--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 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}

Disabilitare un asset.

az iot ops asset update --name {asset_name} -g {resource_group} --disable

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.

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

Produttore.

--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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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