az iot ops ns asset mgmt-group

Note

Questo riferimento fa parte dell'estensione azure-iot-ops per l'interfaccia della riga di comando di Azure (versione 2.70.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot ops ns asset mgmt-group . Altre informazioni sulle estensioni.

Gestire i gruppi di gestione per gli asset con spazio dei nomi in un'istanza di Operazioni IoT.

Il tipo di connettore viene rilevato automaticamente dall'asset esistente. Per i parametri specifici del connettore, usare --mgmt-group-config (json o file inline). Usare --show-template per individuare lo schema di configurazione supportato per il tipo di connettore dell'asset.

Comandi

Nome Descrizione Tipo Status
az iot ops ns asset mgmt-group add

Aggiungere un gruppo di gestione a un asset con spazio dei nomi in un'istanza di Operazioni IoT.

 Extension Preview
az iot ops ns asset mgmt-group export

Esportare i gruppi di gestione nel file.

 Extension Preview
az iot ops ns asset mgmt-group import

Importare gruppi di gestione da file.

 Extension Preview
az iot ops ns asset mgmt-group list

Elencare i gruppi di gestione per un asset con spazio dei nomi in un'istanza di IoT Operations.

 Extension Preview
az iot ops ns asset mgmt-group remove

Rimuovere un gruppo di gestione da un asset con spazio dei nomi in un'istanza di Operazioni IoT.

 Extension Preview
az iot ops ns asset mgmt-group show

Visualizzare i dettagli di un gruppo di gestione per un asset con spazio dei nomi in un'istanza di Operazioni IoT.

 Extension Preview
az iot ops ns asset mgmt-group update

Aggiornare un gruppo di gestione per un asset con spazio dei nomi in un'istanza di IoT Operations.

 Extension Preview

az iot ops ns asset mgmt-group add

Anteprima

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

Aggiungere un gruppo di gestione a un asset con spazio dei nomi in un'istanza di Operazioni IoT.

Il tipo di connettore viene rilevato dall'endpoint del dispositivo dell'asset. La configurazione specifica del connettore può essere fornita tramite --mgmt-group-config. Usare --show-template per individuare lo schema di configurazione supportato. Per i connettori non OPC UA, è necessario che nell'istanza esista un modello di connettore.

az iot ops ns asset mgmt-group add --asset
                                   --instance
                                   --name
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--data-source --ds]
                                   [--default-timeout --dto]
                                   [--default-topic --dt]
                                   [--mgc --mgmt-group-config]
                                   [--replace {false, true}]
                                   [--show-template {config, schema}]
                                   [--tr --type-ref]

Esempio

Aggiungere un gruppo di gestione di base a qualsiasi tipo di asset

az iot ops ns asset mgmt-group add --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls

Visualizzare il modello di configurazione del gruppo di gestione per il tipo di connettore dell'asset

az iot ops ns asset mgmt-group add --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --show-template config

Aggiungere un gruppo di gestione con configurazione specifica del connettore da JSON inline

az iot ops ns asset mgmt-group add --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --mgmt-group-config '{"managementGroupConfiguration": {"maxConcurrentRequests": 5}}'

Aggiungere un gruppo di gestione con la configurazione da un file

az iot ops ns asset mgmt-group add --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --mgmt-group-config ./mgmt_group_config.json

Sostituire un gruppo di gestione esistente

az iot ops ns asset mgmt-group add --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --replace

Parametri necessari

--asset -a

Nome asset.

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--name -n

Nome del gruppo di gestione.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--data-source --ds

Origine dati per il gruppo di gestione.

--default-timeout --dto

Timeout predefinito in secondi per le azioni del gruppo di gestione. Minimo: 0.

--default-topic --dt

Argomento predefinito per le azioni del gruppo di gestione.

--mgc --mgmt-group-config

Stringa JSON inline o percorso di un file JSON/YAML (.json, yaml .yml) contenente la configurazione del gruppo di gestione specifica del connettore. La chiave accettata è "managementGroupConfiguration" (oggetto config specifico del connettore). Usare --show-template per individuare le chiavi e lo schema supportati per il tipo di connettore dell'asset. Non può essere combinato con --show-template. Per i connettori non OPC UA, è necessario che nell'istanza esista un modello di connettore.

--replace

Sostituire il gruppo di gestione se è già presente un altro gruppo di gestione con lo stesso nome.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
--show-template

Mostrare un modello di configurazione del gruppo di gestione iniziale per il tipo di connettore dell'asset e uscire senza modificare il gruppo di gestione. Il tipo di connettore viene letto dall'asset esistente. config: campi visualizzati con i relativi valori predefiniti (null se nessun valore predefinito); l'output è utilizzabile direttamente come input --mgmt-group-config. schema: ogni campo include tipo, impostazione predefinita e vincoli (min, max, enum, pattern). Draft-07 $ref puntatori (#/definitions/...) vengono risolti inline in entrambe le modalità.

Proprietà Valore
Valori accettati: config, schema
--tr --type-ref

ID definizione del tipo o URI.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az iot ops ns asset mgmt-group export

Anteprima

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

Esportare i gruppi di gestione nel file.

az iot ops ns asset mgmt-group export --asset
                                      --instance
                                      --resource-group
                                      [--acquire-policy-token]
                                      [--change-reference]
                                      [--format {json, yaml}]
                                      [--od --output-dir]
                                      [--replace {false, true}]

Esempio

Esportare i gruppi di gestione in JSON

az iot ops ns asset mgmt-group export --asset myasset --instance myInstance -g myInstanceResourceGroup

Parametri necessari

--asset -a

Nome asset.

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--format -f

Esportare il formato di file (JSON o YAML).

Proprietà Valore
Valore predefinito: json
Valori accettati: json, yaml
--od --output-dir

Directory di output per l'esportazione.

Proprietà Valore
Valore predefinito: .
--replace

Sostituire il file locale, se presente.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az iot ops ns asset mgmt-group import

Anteprima

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

Importare gruppi di gestione da file.

az iot ops ns asset mgmt-group import --asset
                                      --if --input-file
                                      --instance
                                      --resource-group
                                      [--acquire-policy-token]
                                      [--change-reference]
                                      [--replace {false, true}]

Esempio

Importare gruppi di gestione da un file JSON

az iot ops ns asset mgmt-group import --asset myasset --instance myInstance -g myInstanceResourceGroup --input-file ./management_groups.json

Parametri necessari

--asset -a

Nome asset.

--if --input-file

Percorso del file di importazione (JSON o YAML).

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--replace

Sostituire i gruppi di gestione esistenti che condividono un nome con un gruppo di gestione importato.

Proprietà Valore
Valore predefinito: False
Valori accettati: false, true
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az iot ops ns asset mgmt-group list

Anteprima

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

Elencare i gruppi di gestione per un asset con spazio dei nomi in un'istanza di IoT Operations.

az iot ops ns asset mgmt-group list --asset
                                    --instance
                                    --resource-group

Esempio

Elencare tutti i gruppi di gestione per un asset

az iot ops ns asset mgmt-group list --asset myasset --instance myInstance -g myInstanceResourceGroup

Parametri necessari

--asset -a

Nome asset.

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az iot ops ns asset mgmt-group remove

Anteprima

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

Rimuovere un gruppo di gestione da un asset con spazio dei nomi in un'istanza di Operazioni IoT.

az iot ops ns asset mgmt-group remove --asset
                                      --instance
                                      --name
                                      --resource-group
                                      [--acquire-policy-token]
                                      [--change-reference]

Esempio

Rimuovere un gruppo di gestione da un asset

az iot ops ns asset mgmt-group remove --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls

Parametri necessari

--asset -a

Nome asset.

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--name -n

Nome del gruppo di gestione.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az iot ops ns asset mgmt-group show

Anteprima

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

Visualizzare i dettagli di un gruppo di gestione per un asset con spazio dei nomi in un'istanza di Operazioni IoT.

az iot ops ns asset mgmt-group show --asset
                                    --instance
                                    --name
                                    --resource-group

Esempio

Visualizzare i dettagli del gruppo di gestione

az iot ops ns asset mgmt-group show --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls

Parametri necessari

--asset -a

Nome asset.

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--name -n

Nome del gruppo di gestione.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az iot ops ns asset mgmt-group update

Anteprima

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

Aggiornare un gruppo di gestione per un asset con spazio dei nomi in un'istanza di IoT Operations.

Il tipo di connettore viene rilevato dall'endpoint del dispositivo dell'asset. Usare --mgmt-group-config per fornire una configurazione specifica del connettore. Usare --show-template config per visualizzare i valori correnti del gruppo di gestione precompilati nella struttura dello schema completo (pronti per la modifica e il passaggio tramite --mgmt-group-config). Usare lo schema --show-template per visualizzare lo schema completo del connettore con tipi e vincoli.

az iot ops ns asset mgmt-group update --asset
                                      --instance
                                      --name
                                      --resource-group
                                      [--acquire-policy-token]
                                      [--change-reference]
                                      [--data-source --ds]
                                      [--default-timeout --dto]
                                      [--default-topic --dt]
                                      [--mgc --mgmt-group-config]
                                      [--show-template {config, schema}]
                                      [--tr --type-ref]

Esempio

Mostra la configurazione corrente del gruppo di gestione precompilato con i valori esistenti (per la modifica prima dell'aggiornamento)

az iot ops ns asset mgmt-group update --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --show-template config

Visualizzare lo schema di configurazione del gruppo di gestione con tipi e vincoli

az iot ops ns asset mgmt-group update --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --show-template schema

Configurazione del gruppo di gestione degli aggiornamenti da JSON inline

az iot ops ns asset mgmt-group update --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --mgmt-group-config '{"managementGroupConfiguration": {"maxConcurrentRequests": 10}}'

Aggiornare l'origine dati del gruppo di gestione

az iot ops ns asset mgmt-group update --asset myasset --instance myInstance -g myInstanceResourceGroup --name boilerControls --data-source "boiler.controls"

Parametri necessari

--asset -a

Nome asset.

--instance -i

Nome dell'istanza di Operazioni di Azure IoT.

--name -n

Nome del gruppo di gestione.

--resource-group -g

Gruppo di risorse dell'istanza di Operazioni di Azure IoT.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--data-source --ds

Origine dati per il gruppo di gestione.

--default-timeout --dto

Timeout predefinito in secondi per le azioni del gruppo di gestione. Minimo: 0.

--default-topic --dt

Argomento predefinito per le azioni del gruppo di gestione.

--mgc --mgmt-group-config

Stringa JSON inline o percorso di un file JSON/YAML (.json, yaml .yml) contenente la configurazione del gruppo di gestione specifica del connettore. La chiave accettata è "managementGroupConfiguration" (oggetto config specifico del connettore). Usare --show-template per individuare le chiavi e lo schema supportati per il tipo di connettore dell'asset. Non può essere combinato con --show-template. Per i connettori non OPC UA, è necessario che nell'istanza esista un modello di connettore.

--show-template

Mostrare un modello di configurazione del gruppo di gestione iniziale per il tipo di connettore dell'asset e uscire senza modificare il gruppo di gestione. Il tipo di connettore viene letto dall'asset esistente. config: campi visualizzati con i relativi valori predefiniti (null se nessun valore predefinito); l'output è utilizzabile direttamente come input --mgmt-group-config. schema: ogni campo include tipo, impostazione predefinita e vincoli (min, max, enum, pattern). Draft-07 $ref puntatori (#/definitions/...) vengono risolti inline in entrambe le modalità.

Proprietà Valore
Valori accettati: config, schema
--tr --type-ref

ID definizione del tipo o URI.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False