az iot ops

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

Gestione degli asset.

Estensione Anteprima
az iot ops asset create

Creare un asset.

Estensione Anteprima
az iot ops asset dataset

Gestire i set di dati in un asset.

Estensione Anteprima
az iot ops asset dataset list

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

Estensione Anteprima
az iot ops asset dataset point

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

Estensione Anteprima
az iot ops asset dataset point add

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

Estensione Anteprima
az iot ops asset dataset point export

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

Estensione Anteprima
az iot ops asset dataset point import

Importare punti dati in un set di dati di asset.

Estensione Anteprima
az iot ops asset dataset point list

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

Estensione Anteprima
az iot ops asset dataset point remove

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

Estensione Anteprima
az iot ops asset dataset show

Visualizzare un set di dati all'interno di 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 create

Creare profili endpoint asset.

Estensione Anteprima
az iot ops asset endpoint create opcua

Creare un profilo endpoint asset con un connettore OPCUA.

Estensione Anteprima
az iot ops asset endpoint delete

Eliminare un profilo endpoint asset.

Estensione Anteprima
az iot ops asset endpoint query

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

Estensione Anteprima
az iot ops asset endpoint show

Visualizzare un profilo endpoint asset.

Estensione Anteprima
az iot ops asset endpoint update

Aggiornare un profilo endpoint 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 broker

Gestione broker Mqtt.

Estensione Anteprima
az iot ops broker authn

Gestione dell'autenticazione broker.

Estensione Anteprima
az iot ops broker authn delete

Eliminare una risorsa di autenticazione broker mqtt.

Estensione Anteprima
az iot ops broker authn list

Elencare le risorse di autenticazione broker mqtt associate a un'istanza di .

Estensione Anteprima
az iot ops broker authn show

Mostra i dettagli di una risorsa di autenticazione broker mqtt.

Estensione Anteprima
az iot ops broker authz

Gestione delle autorizzazioni broker.

Estensione Anteprima
az iot ops broker authz delete

Eliminare una risorsa di autorizzazione del broker mqtt.

Estensione Anteprima
az iot ops broker authz list

Elencare le risorse di autorizzazione del broker mqtt associate a un'istanza di .

Estensione Anteprima
az iot ops broker authz show

Mostra i dettagli di una risorsa di autorizzazione del broker mqtt.

Estensione Anteprima
az iot ops broker delete

Eliminare un broker mqtt.

Estensione Anteprima
az iot ops broker list

Elencare i broker mqtt associati a un'istanza di .

Estensione Anteprima
az iot ops broker listener

Gestione del listener broker.

Estensione Anteprima
az iot ops broker listener delete

Eliminare un listener broker mqtt.

Estensione Anteprima
az iot ops broker listener list

Elencare i listener broker mqtt associati a un broker.

Estensione Anteprima
az iot ops broker listener show

Mostra i dettagli di un listener broker mqtt.

Estensione Anteprima
az iot ops broker show

Mostra i dettagli di un broker mqtt.

Estensione Anteprima
az iot ops broker stats

Visualizzare le statistiche di esecuzione di dmqtt.

Estensione Anteprima
az iot ops check

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

Estensione Anteprima
az iot ops connector

Gestione dei connettori.

Estensione Anteprima
az iot ops connector opcua

Gestione del connettore OPC UA.

Estensione Anteprima
az iot ops connector opcua client

Gestire il certificato dell'istanza dell'applicazione client di livello aziendale per OPC UA Broker.

Estensione Anteprima
az iot ops connector opcua client add

Aggiungere un certificato dell'istanza dell'applicazione client di livello aziendale.

Estensione Anteprima
az iot ops connector opcua issuer

Gestire i certificati dell'autorità emittente per il broker OPC UA.

Estensione Anteprima
az iot ops connector opcua issuer add

Aggiungere un certificato dell'autorità di certificazione all'elenco di certificati dell'autorità di certificazione OPC UA Broker.

Estensione Anteprima
az iot ops connector opcua trust

Gestire i certificati attendibili per il broker OPC UA.

Estensione Anteprima
az iot ops connector opcua trust add

Aggiungere un certificato attendibile all'elenco di certificati attendibili di OPC UA Broker.

Estensione Anteprima
az iot ops create

Creare un'istanza di Operazioni IoT.

Estensione Anteprima
az iot ops dataflow

Gestione dei flussi di dati.

Estensione Anteprima
az iot ops dataflow endpoint

Gestione degli endpoint del flusso di dati.

Estensione Anteprima
az iot ops dataflow endpoint list

Elencare le risorse dell'endpoint del flusso di dati associate a un'istanza di .

Estensione Anteprima
az iot ops dataflow endpoint show

Visualizzare i dettagli di una risorsa endpoint del flusso di dati.

Estensione Anteprima
az iot ops dataflow list

Elencare i flussi di dati associati a un profilo del flusso di dati.

Estensione Anteprima
az iot ops dataflow profile

Gestione del profilo del flusso di dati.

Estensione Anteprima
az iot ops dataflow profile list

Elencare i profili del flusso di dati associati a un'istanza di .

Estensione Anteprima
az iot ops dataflow profile show

Mostra i dettagli di un profilo del flusso di dati.

Estensione Anteprima
az iot ops dataflow show

Visualizzare i dettagli di un flusso di dati associato a un profilo del flusso di dati.

Estensione Anteprima
az iot ops delete

Eliminare le operazioni IoT dal cluster.

Estensione Anteprima
az iot ops identity

Gestione delle identità dell'istanza.

Estensione Anteprima
az iot ops identity assign

Assegnare un'identità gestita assegnata dall'utente con l'istanza di .

Estensione Anteprima
az iot ops identity remove

Rimuovere un'identità gestita assegnata dall'utente dall'istanza.

Estensione Anteprima
az iot ops identity show

Mostra le identità dell'istanza.

Estensione Anteprima
az iot ops init

Bootstrap del cluster abilitato per Arc per la distribuzione di operazioni IoT.

Estensione Anteprima
az iot ops list

Elencare le istanze delle operazioni IoT.

Estensione Anteprima
az iot ops schema

Gestione dello schema e del Registro di sistema.

Estensione Anteprima
az iot ops schema create

Creare uno schema all'interno di un registro schemi.

Estensione Anteprima
az iot ops schema delete

Eliminare uno schema di destinazione all'interno di un registro schemi.

Estensione Anteprima
az iot ops schema list

Elencare gli schemi all'interno di un registro schemi.

Estensione Anteprima
az iot ops schema registry

Gestione del Registro di sistema dello schema.

Estensione Anteprima
az iot ops schema registry create

Creare un registro schemi.

Estensione Anteprima
az iot ops schema registry delete

Eliminare un Registro di sistema dello schema di destinazione.

Estensione Anteprima
az iot ops schema registry list

Elencare i registri dello schema in un gruppo di risorse o in una sottoscrizione.

Estensione Anteprima
az iot ops schema registry show

Visualizzare i dettagli di un Registro di sistema dello schema.

Estensione Anteprima
az iot ops schema show

Visualizzare i dettagli di uno schema all'interno di un registro schemi.

Estensione Anteprima
az iot ops schema show-dataflow-refs

Visualizzare i riferimenti allo schema usati per i flussi di dati.

Estensione Anteprima
az iot ops schema version

Gestione delle versioni dello schema.

Estensione Anteprima
az iot ops schema version add

Aggiungere una versione dello schema a uno schema.

Estensione Anteprima
az iot ops schema version list

Elencare le versioni dello schema per uno schema specifico.

Estensione Anteprima
az iot ops schema version remove

Rimuovere una versione dello schema di destinazione.

Estensione Anteprima
az iot ops schema version show

Mostra i dettagli di una versione dello schema.

Estensione Anteprima
az iot ops secretsync

Gestione della sincronizzazione dei segreti dell'istanza.

Estensione Anteprima
az iot ops secretsync disable

Disabilitare la sincronizzazione dei segreti per un'istanza di .

Estensione Anteprima
az iot ops secretsync enable

Abilitare la sincronizzazione dei segreti per un'istanza di .

Estensione Anteprima
az iot ops secretsync list

Elencare le configurazioni di sincronizzazione dei segreti associate a un'istanza di .

Estensione Anteprima
az iot ops show

Visualizzare un'istanza di Operazioni IoT.

Estensione Anteprima
az iot ops support

Operazioni di supporto per le operazioni IoT.

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 update

Aggiornare un'istanza di Operazioni IoT.

Estensione Anteprima
az iot ops upgrade

Aggiornare un'istanza di Operazioni IoT alla versione più recente.

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'idoneità sul lato cluster e l'integrità del runtime dei servizi operativi IoT distribuiti.

Il comando per impostazione predefinita mostra una visualizzazione di riepilogo descrittiva generale di tutti i servizi. Usare l'opzione '--svc' per specificare i controlli per un singolo servizio e configurare la dettaglio tramite l'argomento --detail-level . Nota: il tipo di risorsa (--resources) e il filtro name (--resource-name) possono essere usati solo con l'argomento '--svc'.

{API del servizio supportate}

  • deviceregistry.microsoft.com/[v1beta2]
  • mqttbroker.iotoperations.azure.com/[v1beta1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]
  • connectivity.iotoperations.azure.com/[v1beta1]

Per altre informazioni sui requisiti del cluster, vedere https://aka.ms/iot-ops-cluster-requirements.

az iot ops check [--as-object {false, true}]
                 [--context]
                 [--detail-level {0, 1, 2}]
                 [--ops-service {akri, broker, dataflow, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile}]

Esempio

Utilizzo di base. Controlla l'integrità complessiva delle operazioni IoT con l'output di riepilogo.

az iot ops check

Controlla l'integrità e la configurazione del servizio 'broker' con output dettagliato.

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

Valutare solo il servizio "flusso di dati" con output ottimizzato per l'integrazione continua.

az iot ops check --svc dataflow --as-object

Controlla l'integrità di "deviceregistry" con output dettagliato, ma vincola i risultati alle risorse 'asset'.

az iot ops check --svc deviceregistry --detail-level 2 --resources asset

Usare il nome della risorsa per vincolare i risultati alle risorse 'asset' con il prefisso del nome 'my-asset-'

az iot ops check --svc deviceregistry --resources asset --resource-name 'my-asset-*'

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, broker, dataflow, deviceregistry, opcua
--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. Per il nome non viene fatta 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, dataflow, dataflowendpoint, dataflowprofile
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 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'istanza di Operazioni IoT.

È necessaria un'esecuzione corretta di init prima di eseguire questo comando.

Il risultato del comando nets un'istanza di operazioni IoT con un set di risorse predefinite configurate per la funzione coesiva.

az iot ops create --cluster
                  --name
                  --resource-group
                  --sr-resource-id
                  [--add-insecure-listener {false, true}]
                  [--bp]
                  [--br]
                  [--broker-backend-workers]
                  [--broker-config-file]
                  [--broker-frontend-replicas]
                  [--broker-frontend-workers]
                  [--broker-listener-type {ClusterIp, LoadBalancer, NodePort}]
                  [--broker-mem-profile {High, Low, Medium, Tiny}]
                  [--cluster-namespace]
                  [--custom-location]
                  [--description]
                  [--df-profile-instances]
                  [--enable-rsync {false, true}]
                  [--kubernetes-distro {K3s, K8s, MicroK8s}]
                  [--location]
                  [--no-progress {false, true}]
                  [--ops-config]
                  [--ops-version]
                  [--runtime-socket]
                  [--tags]
                  [--trust-settings]

Esempio

Creare l'istanza di destinazione con input minimo.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

Nell'esempio seguente viene aggiunta la personalizzazione alla risorsa dell'istanza broker predefinita, nonché alla descrizione e ai tag dell'istanza.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --broker-mem-profile High --broker-backend-workers 4 --description 'Contoso Factory' --tags tier=testX1

Questo esempio mostra la distribuzione di un listener broker aggiuntivo non sicuro (senza autenticazione o autenticazione) configurato per la porta 1883 del servizio di bilanciamento del carico. Utile per test e/o demo. Non usare l'opzione non sicura nell'ambiente di produzione.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --add-insecure-listener

Questo modulo illustra come abilitare la sincronizzazione delle risorse per la distribuzione dell'istanza. Per abilitare la scrittura dell'assegnazione di ruolo di sincronizzazione risorse, è necessario nel gruppo di risorse di destinazione.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --enable-rsync

In questo esempio vengono evidenziate le impostazioni di attendibilità per un utente che ha fornito la configurazione cert-manager. Si noti che il cluster deve essere stato inizializzato con "--user-trust" e deve essere presente una distribuzione di cert-manager utente.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --trust-settings configMapName=example-bundle configMapKey=trust-bundle.pem issuerKind=ClusterIssuer issuerName=trust-manager-selfsigned-issuer

Parametri necessari

--cluster

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

--name -n

Nome dell'istanza di IoT Operations. È necessario specificare un nome di istanza per distribuire un'istanza durante l'orchestrazione di init.

--resource-group -g

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

--sr-resource-id

ID risorsa del Registro di sistema dello schema da usare con operazioni IoT.

Parametri facoltativi

--add-insecure-listener

Se abilitata la distribuzione del broker mqtt includerà un listener di tipo di servizio LoadBalancer, associato alla porta 1883 senza autenticazione O authZ. Solo per carichi di lavoro non di produzione.

Valori accettati: false, true
--bp --broker-backend-part

Partizioni back-end del broker Mqtt. Valore minimo: 1, valore massimo: 16.

Valore predefinito: 2
--br --broker-backend-rf

Fattore di ridondanza back-end del broker Mqtt. Valore minimo: 1, valore massimo: 5.

Valore predefinito: 2
--broker-backend-workers --bw

Ruoli di lavoro back-end del broker Mqtt. Valore minimo: 1, valore massimo: 16.

Valore predefinito: 2
--broker-config-file

Percorso di un file JSON con proprietà di configurazione del broker personalizzato. Il contenuto della configurazione dei file viene usato sui singoli parametri di configurazione del broker. Utile per scenari avanzati. Il formato previsto è descritto in https://aka.ms/aziotops-broker-config.

--broker-frontend-replicas --fr

Repliche front-end broker mqtt. Valore minimo: 1, valore massimo: 16.

Valore predefinito: 2
--broker-frontend-workers --fw

Ruoli di lavoro front-end broker mqtt. Valore minimo: 1, valore massimo: 16.

Valore predefinito: 2
--broker-listener-type --lt

Tipo di servizio associato al listener broker mqtt predefinito.

Valori accettati: ClusterIp, LoadBalancer, NodePort
Valore predefinito: ClusterIp
--broker-mem-profile --mp

Profilo di memoria broker Mqtt.

Valori accettati: High, Low, Medium, Tiny
Valore predefinito: Medium
--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
--custom-location

Nome del percorso personalizzato corrispondente alla distribuzione delle operazioni IoT. Il valore predefinito è nel formato 'location-{hash(5)}'.

--description

Descrizione dell'istanza di Operazioni IoT.

--df-profile-instances

Numero di istanze associato al profilo del flusso di dati predefinito.

Valore predefinito: 1
--enable-rsync

Le regole di sincronizzazione delle risorse verranno incluse nella distribuzione delle operazioni IoT.

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

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

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Valori accettati: false, true
--ops-config

Configurazione personalizzata dell'estensione arc per operazioni IoT. Il formato è coppie chiave=valore separate da spazi. --ops-config può essere usato uno o più volte. Per i casi d'uso avanzati.

--ops-version
Deprecato

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

Usare per eseguire l'override della versione predefinita dell'estensione dell'arco di operazioni IoT.

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

--tags

Tag di istanza. Contenitore delle proprietà in coppie chiave-valore con il formato seguente: a=b c=d. Usare --tags "" per rimuovere tutti i tag.

--trust-settings

Impostazioni per il bundle di attendibilità fornito dall'utente. Usato per il componente TLS. Il formato è coppie chiave=valore separate da spazi. Sono necessarie le chiavi seguenti: issuerKind, configMapName, configMapKey, issuerName. Se non viene usato, viene configurato un bundle di attendibilità autofirmato fornito dal sistema.

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 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 le operazioni IoT dal cluster.

È necessario specificare il nome dell'istanza o del cluster.

L'operazione usa Azure Resource Graph per determinare le risorse correlate. La coerenza finale di Resource Graph non garantisce uno stato sincronizzato al momento dell'esecuzione.

az iot ops delete --resource-group
                  [--cluster]
                  [--force {false, true}]
                  [--include-deps {false, true}]
                  [--name]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

Esempio

Input minimo per l'eliminazione completa.

az iot ops delete -n myinstance -g myresourcegroup

Ignorare la richiesta di conferma e continuare con il processo di eliminazione. Utile per gli scenari di integrazione continua.

az iot ops delete -n myinstance -g myresourcegroup -y

Forzare l'eliminazione indipendentemente dagli avvisi. Può causare errori.

az iot ops delete -n myinstance -g myresourcegroup --force

Usare il nome del cluster anziché l'istanza per la ricerca.

az iot ops delete --cluster mycluster -g myresourcegroup

Applicazione inversa di init.

az iot ops delete -n myinstance -g myresourcegroup --include-deps

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--cluster

Nome del cluster di destinazione per l'eliminazione delle operazioni IoT.

--force

Forzare l'esecuzione dell'operazione.

Valori accettati: false, true
--include-deps

Indica che il comando deve rimuovere le dipendenze delle operazioni IoT. Questa opzione è progettata per invertire l'applicazione di init.

Valori accettati: false, true
--name -n

Nome dell'istanza di IoT Operations.

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Valori accettati: false, true
--yes -y

Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.

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 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 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 del cluster abilitato per Arc per la distribuzione di operazioni IoT.

Per distribuire le operazioni IoT, è necessario un cluster abilitato per Arc. Per altre informazioni https://aka.ms/aziotops-arcconnect, vedere la risorsa seguente.

L'operazione init funzionerà durante l'installazione e la configurazione di un livello di base di servizi perimetrali necessari per la distribuzione delle operazioni IoT.

Dopo aver installato il livello di base, è necessario usare il az iot ops create comando per distribuire un'istanza di .

az iot ops init --cluster
                --resource-group
                [--enable-fault-tolerance {false, true}]
                [--ensure-latest {false, true}]
                [--no-progress {false, true}]
                [--user-trust {false, true}]

Esempio

Utilizzo con input minimo. Questo modulo distribuirà il livello di base di IoT Operations.

az iot ops init --cluster mycluster -g myresourcegroup

Analogamente all'esempio precedente ma con la tolleranza di errore di Archiviazione contenitori Arc abilitata (richiede almeno 3 nodi).

az iot ops init --cluster mycluster -g myresourcegroup --enable-fault-tolerance

Questo esempio evidenzia l'abilitazione delle impostazioni di attendibilità utente per una configurazione cert-manager personalizzata. In questo modo si ignora la distribuzione del sistema cert-manager e trust-manager.

az iot ops init --cluster mycluster -g myresourcegroup --user-trust

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

--enable-fault-tolerance

Abilitare la tolleranza di errore per Archiviazione azure Arc Container. Sono necessari almeno 3 nodi del cluster.

Valori accettati: false, true
--ensure-latest

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

Valori accettati: false, true
--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Valori accettati: false, true
--user-trust --ut

Ignorare la distribuzione del sistema cert-manager e trust-manager a favore di una configurazione fornita dall'utente.

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

Anteprima

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

Elencare le istanze delle operazioni IoT.

Usare --query con la sintassi JMESPath desiderata per eseguire query sul risultato.

az iot ops list [--resource-group]

Esempio

Elencare tutte le istanze nella sottoscrizione.

az iot ops list

Elencare tutte le istanze di un determinato gruppo di risorse.

az iot ops list -g myresourcegroup

Elencare le istanze nella sottoscrizione con un valore di tag specifico.

az iot ops list -g myresourcegroup --query "[?tags.env == 'prod']"

Parametri facoltativi

--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 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'istanza di Operazioni IoT.

Facoltativamente, il comando può restituire una struttura ad albero di risorse associate che rappresenta la distribuzione delle operazioni IoT nel cluster di backup. Se questo comando non riesce, usare az iot ops upgrade per aggiornare l'istanza alla versione più recente prima di continuare.

az iot ops show --name
                --resource-group
                [--tree {false, true}]

Esempio

Utilizzo di base per visualizzare un'istanza di .

az iot ops show --name myinstance -g myresourcegroup

Restituisce una struttura ad albero delle risorse associate che rappresentano la distribuzione delle operazioni IoT.

az iot ops show --name myinstance -g myresourcegroup --tree

Parametri necessari

--name -n

Nome dell'istanza di IoT Operations.

--resource-group -g

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

Parametri facoltativi

--tree

Usare per visualizzare la distribuzione delle operazioni IoT nel cluster di backup.

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 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 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'istanza di Operazioni IoT.

Attualmente è possibile aggiornare i tag e la descrizione dell'istanza. Se si vuole aggiornare l'istanza a una versione più recente, usare az iot ops upgrade invece .

az iot ops update --name
                  --resource-group
                  [--description]
                  [--tags]

Esempio

Aggiornare i tag dell'istanza. Equivale a una sostituzione.

az iot ops update --name myinstance -g myresourcegroup --tags a=b c=d

Rimuovere i tag di istanza.

az iot ops update --name myinstance -g myresourcegroup --tags ""

Aggiornare la descrizione dell'istanza.

az iot ops update --name myinstance -g myresourcegroup --desc "Fabrikam Widget Factory B42"

Parametri necessari

--name -n

Nome dell'istanza di IoT Operations.

--resource-group -g

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

Parametri facoltativi

--description

Descrizione dell'istanza di Operazioni IoT.

--tags

Tag di istanza. Contenitore delle proprietà in coppie chiave-valore con il formato seguente: a=b c=d. Usare --tags "" per rimuovere tutti i tag.

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 upgrade

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'istanza di Operazioni IoT alla versione più recente.

AVVISO: questo comando potrebbe non riuscire e richiedere l'eliminazione e la ricreazione del cluster e dell'istanza.

Aggiornare un'istanza di Operazioni IoT, incluso l'aggiornamento delle estensioni alle versioni più recenti. Usare questo comando se az iot ops show o comandi simili hanno esito negativo.

L'ID risorsa del Registro di sistema dello schema è un parametro facoltativo e può essere necessario in scenari specifici.

az iot ops upgrade --name
                   --resource-group
                   [--no-progress {false, true}]
                   [--sr-resource-id]
                   [--yes {false, true}]

Esempio

Aggiornare l'istanza con input minimi.

az iot ops upgrade --name myinstance -g myresourcegroup

Ignorare la richiesta di conformità durante l'aggiornamento dell'istanza.

az iot ops upgrade --name myinstance -g myresourcegroup -y

Aggiornare l'istanza e specificare l'ID risorsa del Registro di sistema dello schema.

az iot ops upgrade --name myinstance -g myresourcegroup --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

Parametri necessari

--name -n

Nome dell'istanza di IoT Operations.

--resource-group -g

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

Parametri facoltativi

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Valori accettati: false, true
--sr-resource-id

ID risorsa del Registro di sistema dello schema da usare con operazioni IoT. Obbligatorio se l'ID risorsa del Registro di sistema dello schema non viene più trovato nelle operazioni IoT.

--yes -y

Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.

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