az iot ops

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 . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire le operazioni di Azure IoT.

Le operazioni IoT di Azure sono un set di servizi Kubernetes altamente allineati, ma ad accoppiamento libero, che consentono di aggregare i dati dagli asset locali in un broker MQTT di livello industriale, aggiungere calcolo perimetrale e configurare un flusso di dati bidirezionale con un'ampia gamma di servizi nel cloud.

Per impostazione predefinita, i comandi dell'interfaccia della riga di comando delle operazioni IoT verificheranno periodicamente se è disponibile una nuova versione dell'estensione. Questo comportamento può essere disabilitato con az config set iotops.check_latest=false.

Comandi

Nome	Descrizione	Tipo	Stato
az iot ops asset	Gestire le risorse.	Estensione	Anteprima
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 check	Valutare l'integrità del runtime sul lato cluster dei servizi operativi IoT distribuiti.	Estensione	Anteprima
az iot ops init	Bootstrap, configurare e distribuire operazioni IoT nel cluster con abilitazione dell'arco di destinazione.	Estensione	Anteprima
az iot ops mq	Strumenti specifici mq.	Estensione	Anteprima
az iot ops mq get-password-hash	Genera un hash PBKDF2 della passphrase che applica PBKDF2-HMAC-SHA512. Un sale a 128 bit viene usato da os.urandom.	Estensione	Anteprima
az iot ops mq stats	Visualizzare le statistiche di esecuzione di dmqtt.	Estensione	Anteprima
az iot ops support	Le operazioni IoT supportano lo spazio dei comandi.	Estensione	Anteprima
az iot ops support create-bundle	Crea un archivio ZIP del bundle di supporto standard da usare per la risoluzione dei problemi e la diagnostica.	Estensione	Anteprima
az iot ops verify-host	Esegue un set di verifiche dell'host del cluster per la compatibilità della distribuzione delle operazioni IoT.	Estensione	Anteprima

az iot ops check

Anteprima

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

Valutare l'integrità del runtime sul lato cluster dei servizi operativi IoT distribuiti.

Il comando per impostazione predefinita mostra una visualizzazione di riepilogo descrittiva del servizio selezionato. È possibile richiedere altri dettagli tramite --detail-level.

{API del servizio supportate}

• akri.sh/[v0]
• dataprocessor.iotoperations.azure.com/[v1]
• deviceregistry.microsoft.com/[v1beta1]
• layerednetworkmgmt.iotoperations.azure.com/[v1beta1]
• mq.iotoperations.azure.com/[v1beta1]
• opcuabroker.iotoperations.azure.com/[v1beta1].

az iot ops check [--as-object {false, true}]
                 [--context]
                 [--detail-level {0, 1, 2}]
                 [--ops-service {akri, dataprocessor, deviceregistry, lnm, mq, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, datalakeconnector, dataset, diagnosticservice, instance, kafkaconnector, lnm, mqttbridgeconnector, pipeline}]

Esempio

Utilizzo di base. Controlla l'integrità di 'mq' con l'output di riepilogo.

az iot ops check

Valuta "mq" come l'esempio precedente, ma l'output è ottimizzato per l'integrazione continua.

az iot ops check --as-object

Verifica l'integrità e la configurazione del "dataprocessore" con output dettagliato.

az iot ops check --svc dataprocessor --detail-level 1

Come nell'esempio precedente, ad eccezione del vincolo dei risultati alla risorsa 'pipeline'.

az iot ops check --svc dataprocessor --detail-level 1 --resources pipeline

Usare il nome della risorsa per vincolare i risultati alla risorsa 'pipeline' esattamente corrispondente al nome 'pipeline'.

az iot ops check --svc dataprocessor  --resources pipeline --resource-name pipeline

Usare il nome della risorsa per vincolare i risultati ai nomi delle risorse che iniziano con "pipeline-name".

az iot ops check --svc dataprocessor --detail-level 1 --resource-name pipeline-name*

Usare il modello glob '?' per vincolare i risultati ai nomi delle risorse che contengono "pipeline" e terminano con un singolo carattere.

az iot ops check --svc dataprocessor --detail-level 1 --resource-name pipeline?

Parametri facoltativi

--as-object

Controllare il contenuto e le convalide di output in una struttura di dati descrittiva dell'integrazione continua.

valori accettati: false, true

--context

Nome del contesto Kubeconfig da usare per la comunicazione del cluster k8s. Se non viene fornito alcun contesto current_context viene usato.

--detail-level

Controlla il livello di dettaglio visualizzato nell'output del controllo. Scegliere 0 per una visualizzazione di riepilogo (output minimo), 1 per una visualizzazione dettagliata (informazioni più complete) o 2 per una visualizzazione dettagliata (tutte le informazioni disponibili).

valori accettati: 0, 1, 2

valore predefinito: 0

--ops-service --svc

Distribuzione del servizio operazioni IoT che verrà valutata.

valori accettati: akri, dataprocessor, deviceregistry, lnm, mq, opcua

valore predefinito: mq

--post

Eseguire controlli post-distribuzione.

valori accettati: false, true

--pre

Eseguire i controlli dei prerequisiti per determinare se vengono soddisfatti i requisiti minimi di una distribuzione del servizio.

valori accettati: false, true

--resource-name --rn

Eseguire solo i controlli per il nome della risorsa specifico. Il nome non fa distinzione tra maiuscole e minuscole. Sono supportati i modelli GLOB '' e '?'. Nota: sono consentiti solo caratteri alfanumerici, trattini, '?' e ''.

--resources

Eseguire solo controlli su tipi di risorse specifici. Usare valori separati da spazi.

valori accettati: asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, datalakeconnector, dataset, diagnosticservice, instance, kafkaconnector, lnm, mqttbridgeconnector, pipeline

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 init

Anteprima

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

Bootstrap, configurare e distribuire operazioni IoT nel cluster con abilitazione dell'arco di destinazione.

Per altre risorse, tra cui come abilitare un cluster, vedere https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-prepare-cluster.

az iot ops init --cluster
                --resource-group
                [--ca-dir]
                [--ca-file]
                [--ca-key-file]
                [--ca-valid-days]
                [--cluster-namespace]
                [--context]
                [--csi-driver-ver]
                [--custom-location]
                [--disable-rotation {false, true}]
                [--disable-rsync-rules {false, true}]
                [--dp-instance]
                [--ensure-latest {false, true}]
                [--kubernetes-distro {k3s, k8s, microk8s}]
                [--kv-id]
                [--kv-spc-secret-name]
                [--location]
                [--mq-authn]
                [--mq-backend-part]
                [--mq-backend-rf]
                [--mq-backend-workers]
                [--mq-broker]
                [--mq-frontend-replicas]
                [--mq-frontend-server]
                [--mq-frontend-workers]
                [--mq-insecure {false, true}]
                [--mq-instance]
                [--mq-listener]
                [--mq-mem-profile {high, low, medium, tiny}]
                [--mq-mode {auto, distributed}]
                [--mq-service-type {clusterIp, loadBalancer, nodePort}]
                [--no-block {false, true}]
                [--no-deploy {false, true}]
                [--no-progress {false, true}]
                [--no-tls {false, true}]
                [--opcua-discovery-url]
                [--rotation-int]
                [--runtime-socket]
                [--show-template {false, true}]
                [--simulate-plc {false, true}]
                [--sp-app-id]
                [--sp-object-id]
                [--sp-secret]
                [--sp-secret-valid-days]
                [--target]

Esempio

Input minimo per la configurazione completa. Sono inclusi la configurazione di Key Vault, la distribuzione del driver CSI, la configurazione e la distribuzione tls delle operazioni IoT.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id /subscriptions/2cb3a427-1abc-48d0-9d03-dd240819742a/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mykeyvault

Stessa configurazione dell'esempio precedente, ad eccezione dell'utilizzo di un ID app esistente e di un flag per includere un server PLC simulato come parte della distribuzione. L'inclusione dell'ID app impedirà a 'init' di creare una registrazione dell'app.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --simulate-plc

Per ignorare la distribuzione e concentrarsi solo sul driver CSI di Key Vault e sui flussi di lavoro di configurazione TLS, il passaggio semplice '--no-deploy'. Ciò può essere utile quando si desidera eseguire la distribuzione da uno strumento diverso, ad esempio il portale.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-deploy

Per distribuire solo le operazioni IoT in un cluster già predefinito, è sufficiente omettere '--kv-id' e includere '--no-tls'.

az iot ops init --cluster mycluster -g myresourcegroup --no-tls

Usare "--no-block" per eseguire altre operazioni mentre la distribuzione è in corso rispetto all'attesa del completamento della distribuzione prima di avviare l'altro lavoro.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-block

Per evitare di chiamare MS Graph, ad esempio per gli scenari di integrazione continua in cui le autorizzazioni dell'entità servizio dell'interfaccia della riga di comando sono limitate o è necessario usare nuovamente un'entità servizio esistente, specificare tutti gli scenari '--sp-app-id', '-sp-object-id' e '--sp-secret'. Questi valori devono riflettere l'entità servizio desiderata che verrà usata per la configurazione del driver CSI di Key Vault.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --sp-object-id 224a7a3f-c63d-4923-8950-c4a85f0d2f29 --sp-secret $SP_SECRET

Parametri necessari

--cluster

Nome del cluster di destinazione per la distribuzione delle operazioni IoT.

--resource-group -g

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

Parametri facoltativi

--ca-dir

La directory locale in cui verrà inserita la CA di test generata e la chiave privata. Se non viene fornita alcuna directory, nessun file verrà scritto su disco. Applicabile quando non viene fornito alcun file --ca-file e --ca-key-file.

--ca-file

Percorso del file CA desiderato in formato PEM.

--ca-key-file

Percorso del file di chiave privata della CA in formato PEM. ! Obbligatorio! quando viene specificato --ca-file.

--ca-valid-days

Opzione per controllare la durata in giorni della CA x509 generata da init. Applicabile se non vengono forniti --ca-file e --ca-key-file.

valore predefinito: 365

--cluster-namespace

L'infrastruttura operazioni IoT dello spazio dei nomi del cluster verrà distribuita in . Deve essere costituito da caratteri minuscoli.

valore predefinito: azure-iot-operations

--context

Nome del contesto Kubeconfig da usare per la comunicazione del cluster k8s. Se non viene fornito alcun contesto current_context viene usato.

--csi-driver-ver

Versione del driver CSI.

valore predefinito: 1.5.2

--custom-location

Nome del percorso personalizzato corrispondente alla distribuzione delle operazioni IoT. Il valore predefinito è nel formato '{cluster_name}-ops-init-cl'.

--disable-rotation

Flag per disabilitare la rotazione dei segreti.

valori accettati: false, true

--disable-rsync-rules

Le regole di sincronizzazione delle risorse non verranno incluse nella distribuzione.

valori accettati: false, true

--dp-instance

Nome dell'istanza per il responsabile del trattamento dei dati. Il valore predefinito è nel formato '{cluster_name}-ops-init-processor'.

--ensure-latest

Verificare che l'interfaccia della riga di comando di IoT Ops più recente sia installata, generando un errore se è disponibile un aggiornamento.

valori accettati: false, true

--kubernetes-distro

Distribuzione di Kubernetes da usare per la configurazione di Akri. La distribuzione selezionata implica il percorso del socket di runtime del contenitore predefinito quando non viene specificato alcun valore --runtime-socket.

valori accettati: k3s, k8s, microk8s

valore predefinito: k8s

--kv-id

ID risorsa ARM di Key Vault. Se si specifica questo ID risorsa, il client potrà configurare tutte le risorse necessarie e la configurazione lato cluster per abilitare il driver CSI dell'insieme di credenziali delle chiavi per le operazioni IoT.

--kv-spc-secret-name

Nome del segreto dell'insieme di credenziali delle chiavi da usare come segreto SPC predefinito. Se il segreto non esiste, verrà creato con un valore segnaposto sicuro crittograficamente.

valore predefinito: azure-iot-operations

--location

Posizione arm che verrà usata per il materiale collaterale RPSaaS di cui è stato effettuato il provisioning. Se non viene specificato il percorso del cluster connesso verrà usato.

--mq-authn

Nome dell'autenticazione mq. Il valore predefinito è 'authn'.

--mq-backend-part

Partizioni back-end MQ.

valore predefinito: 2

--mq-backend-rf

Fattore di ridondanza back-end MQ.

valore predefinito: 2

--mq-backend-workers

Ruoli di lavoro back-end MQ.

valore predefinito: 2

--mq-broker

Nome broker mq. Il valore predefinito è 'broker'.

--mq-frontend-replicas

Repliche front-end MQ.

valore predefinito: 2

--mq-frontend-server

Nome del server front-end mq. Il valore predefinito è 'mq-dmqtt-frontend'.

--mq-frontend-workers

Ruoli di lavoro front-end MQ.

valore predefinito: 2

--mq-insecure

Se abilitata la distribuzione mq includerà un listener associato alla porta 1883 senza autenticazioneN o authZ. L'impostazione broker encryptInternalTraffic verrà impostata su false. Solo per carichi di lavoro non di produzione.

valori accettati: false, true

--mq-instance

Nome dell'istanza mq. Il valore predefinito è nel formato 'init-{hash}-mq-instance'.

--mq-listener

Nome del listener mq. Il valore predefinito è 'listener'.

--mq-mem-profile

Profilo di memoria MQ.

valori accettati: high, low, medium, tiny

valore predefinito: medium

--mq-mode

Modalità MQ dell'operazione.

valori accettati: auto, distributed

valore predefinito: distributed

--mq-service-type

Tipo di servizio MQ.

valori accettati: clusterIp, loadBalancer, nodePort

valore predefinito: clusterIp

--no-block

Restituisce immediatamente dopo l'avvio della distribuzione delle operazioni IoT.

valori accettati: false, true

--no-deploy

Il flusso di lavoro di distribuzione delle operazioni IoT verrà ignorato.

valori accettati: false, true

--no-progress

Disabilitare l'indicatore di stato init.

valori accettati: false, true

--no-tls

Il flusso di lavoro di configurazione TLS verrà ignorato.

valori accettati: false, true

--opcua-discovery-url

Configura un endpoint server OPC-UA per i gestori di individuazione Akri. Se non specificato e viene impostato --simulate-plc, questo valore diventa 'opc.tcp://opcplc-000000. {cluster_namespace}:50000'.

--rotation-int

Intervallo di polling di rotazione.

valore predefinito: 1h

--runtime-socket

Percorso del nodo predefinito del socket di runtime del contenitore. Se non specificato (impostazione predefinita), il percorso del socket è determinato dalla distribuzione --kubernetes-distro.

--show-template

Contrassegno quando impostato restituirà il modello destinato alla distribuzione.

valori accettati: false, true

--simulate-plc

Contrassegnare quando impostato, configurerà il programma di installazione del broker OPC-UA per avviare un server PLC.

valori accettati: false, true

--sp-app-id

ID app dell'entità servizio. Se specificato verrà usato per l'installazione del driver CSI. In caso contrario, verrà creata una registrazione dell'app. Obbligatorio se l'entità di accesso non dispone delle autorizzazioni per eseguire query sul grafico.

--sp-object-id

ID oggetto dell'entità servizio (sp). Se specificato verrà usato per l'installazione del driver CSI. In caso contrario, l'ID oggetto verrà sottoposto a query dall'ID app, creando lo sp se non esiste. Obbligatorio se l'entità di accesso non dispone delle autorizzazioni per eseguire query sul grafico. Utilizzare az ad sp show --id <app Id> --query id -o tsv per produrre l'ID oggetto appropriato. In alternativa, è possibile passare a Applicazioni aziendali nel tenant Entra Id.

--sp-secret

Segreto corrispondente all'ID app dell'entità servizio fornito. Se specificato verrà usato per l'installazione del driver CSI. In caso contrario, verrà creato un nuovo segreto. Obbligatorio se l'entità di accesso non dispone delle autorizzazioni per eseguire query sul grafico.

--sp-secret-valid-days

Opzione per controllare la durata in giorni del segreto dell'entità servizio generata da init. Applicabile se non viene specificato --sp-secret.

valore predefinito: 365

--target

Nome di destinazione per l'agente di orchestrazione delle operazioni. Il valore predefinito è nel formato '{cluster_name}-ops-init-target'.

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

Anteprima

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

Esegue un set di verifiche dell'host del cluster per la compatibilità della distribuzione delle operazioni IoT.

Deve essere eseguito direttamente in un host del cluster di destinazione. Il comando può richiedere di applicare un set di azioni con privilegi, ad esempio l'installazione di una dipendenza. In questo caso, l'interfaccia della riga di comando deve essere eseguita con autorizzazioni elevate. Ad esempio, sudo AZURE_EXTENSION_DIR=~/.azure/cliextensions az iot ops verify-host.

az iot ops verify-host [--no-progress {false, true}]

Parametri facoltativi

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

valori accettati: false, true

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.