Condividi tramite

az iot ops asset

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

Gestione degli asset.

Per altre informazioni sulla gestione degli asset, vedere aka.ms/asset-overview.

Comandi

Nome Descrizione Tipo Status
az iot ops asset create

Creare un asset.

 Estensione GA
az iot ops asset dataset

Gestire i set di dati in un asset.

 Estensione GA
az iot ops asset dataset list

Elencare i set di dati all'interno di un asset.

 Estensione GA
az iot ops asset dataset point

Gestire i punti dati in un set di dati di asset.

 Estensione GA
az iot ops asset dataset point add

Aggiungere un punto dati a un set di dati di asset.

 Estensione GA
az iot ops asset dataset point export

Esportare i punti dati in un set di dati di asset.

 Estensione GA
az iot ops asset dataset point import

Importare punti dati in un set di dati di asset.

 Estensione GA
az iot ops asset dataset point list

Elencare i punti dati in un set di dati di asset.

 Estensione GA
az iot ops asset dataset point remove

Rimuovere un punto dati in un set di dati di asset.

 Estensione GA
az iot ops asset dataset show

Visualizzare un set di dati all'interno di un asset.

 Estensione GA
az iot ops asset delete

Eliminare un asset.

 Estensione GA
az iot ops asset endpoint

Gestire i profili endpoint degli asset.

 Estensione GA
az iot ops asset endpoint create

Creare profili endpoint asset.

 Estensione GA
az iot ops asset endpoint create opcua

Creare un profilo endpoint asset con un connettore OPCUA.

 Estensione GA
az iot ops asset endpoint delete

Eliminare un profilo endpoint asset.

 Estensione GA
az iot ops asset endpoint query

Eseguire una query su Resource Graph per i profili endpoint degli asset.

 Estensione GA
az iot ops asset endpoint show

Visualizzare un profilo endpoint asset.

 Estensione GA
az iot ops asset endpoint update

Aggiornare un profilo endpoint asset.

 Estensione GA
az iot ops asset event

Gestire gli eventi in un asset.

 Estensione GA
az iot ops asset event add

Aggiungere un evento a un asset.

 Estensione GA
az iot ops asset event export

Esportare eventi in un asset.

 Estensione GA
az iot ops asset event import

Importare eventi in un asset.

 Estensione GA
az iot ops asset event list

Elencare gli eventi in un asset.

 Estensione GA
az iot ops asset event remove

Rimuovere un evento in un asset.

 Estensione GA
az iot ops asset query

Eseguire una query su Resource Graph per gli asset.

 Estensione GA
az iot ops asset show

Visualizzare un asset.

 Estensione GA
az iot ops asset update

Aggiornare un asset.

 Estensione GA

az iot ops asset create

Creare un asset.

Per esempi di formati di file, vedere aka.ms/aziotops-assets.

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Esempio

Creare un asset usando l'istanza specificata nello stesso gruppo di risorse.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

Creare un asset usando l'istanza specificata in un gruppo di risorse diverso ma nella stessa sottoscrizione. Si noti che l'esperienza operazioni digitali potrebbe non visualizzare l'asset se si trova in una sottoscrizione diversa dall'istanza.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

Creare un asset disabilitato usando un file contenente eventi.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

Creare un asset con i valori precompilati specificati.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --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-profile --ep

Nome del profilo dell'endpoint asset.

--instance

Nome dell'istanza a cui associare l'asset creato.

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

--attr --custom-attribute

Coppie chiave=valore separate da spazi corrispondenti ad attributi personalizzati aggiuntivi per l'asset. Questo parametro può essere usato più volte.

--dataset-publish-int --dpi

Intervallo di pubblicazione predefinito per i set di dati.

Valore predefinito: 1000
--dataset-queue-size --dqs

Dimensioni della coda predefinite per i set di dati.

Valore predefinito: 1
--dataset-sample-int --dsi

Intervallo di campionamento predefinito (in millisecondi) per i set di 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: json, 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: event_notifier (obbligatorio), name (obbligatorio), observability_mode (nessuno o log), sampling_interval (int), queue_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.

--ig --instance-resource-group

Gruppo di risorse dell'istanza. Se non specificato, verrà usato il gruppo di risorse asset.

--instance-subscription --is
Deprecato

L'argomento 'instance_subscription' è stato deprecato e verrà rimosso in una versione futura.

ID sottoscrizione dell'istanza. Se non specificato, verrà usato l'ID sottoscrizione asset.

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

--topic-path --tp

Percorso dell'argomento predefinito.

--topic-retain --tr

L'argomento predefinito mantiene i criteri.

Valori accettati: Keep, Never
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

Eliminare un asset.

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

Esempio

Eliminare un asset.

az iot ops asset delete --name myasset -g myresourcegroup

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

Eseguire una query su Resource Graph per gli asset.

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {Keep, Never}]

Esempio

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

az iot ops asset query -g myresourcegroup --disabled

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

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

Parametri facoltativi

--cq --custom-query

Query personalizzata da usare. Tutti gli altri argomenti di query verranno ignorati.

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

Nome del profilo dell'endpoint asset.

--hardware-revision --hr

Revisione hardware.

--ig --instance-resource-group

Gruppo di risorse dell'istanza. Se non specificato, verrà usato il gruppo di risorse asset.

--instance

Nome dell'istanza a cui associare l'asset creato.

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

--name -n

Nome asset.

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

--topic-path --tp

Percorso dell'argomento predefinito.

--topic-retain --tr

L'argomento predefinito mantiene i criteri.

Valori accettati: Keep, Never
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

Visualizzare un asset.

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

Esempio

Visualizzare i dettagli di un asset.

az iot ops asset show --name myasset -g myresourcegroup

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

Aggiornare un asset.

Per aggiornare set di dati ed eventi, usare rispettivamente i gruppi di comandi az iot ops asset dataset e az iot ops asset event.

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

Esempio

Aggiornare il set di dati e le impostazioni predefinite dell'evento di un asset.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

Aggiornare la descrizione, l'URI della documentazione, la revisione hardware, il codice prodotto e la revisione software di un asset.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

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 myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

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

az iot ops asset update --name myasset -g myresourcegroup --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

--attr --custom-attribute

Coppie chiave=valore separate da spazi corrispondenti ad attributi personalizzati aggiuntivi per l'asset. Questo parametro può essere usato più volte. Per rimuovere un attributo personalizzato, impostare il valore dell'attributo su "".

--dataset-publish-int --dpi

Intervallo di pubblicazione predefinito per i set di dati.

--dataset-queue-size --dqs

Dimensioni della coda predefinite per i set di dati.

--dataset-sample-int --dsi

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

--description -d

Descrizione.

--disable

Disabilitare un asset.

Valori accettati: false, true
--display-name --dn

Nome visualizzato.

--documentation-uri --du

URI della documentazione.

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

--topic-path --tp

Percorso dell'argomento predefinito.

--topic-retain --tr

L'argomento predefinito mantiene i criteri.

Valori accettati: Keep, Never
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.