az iot ops mgmt-actions

Annotazioni

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

Configurazione delle azioni di gestione delle istanze.

Comandi

Nome	Descrizione	Tipo	Status
az iot ops mgmt-actions disable	Disabilitare le azioni di gestione per un'istanza di operazioni IoT.	Estensione	GA
az iot ops mgmt-actions enable	Abilitare le azioni di gestione per un'istanza di operazioni IoT.	Estensione	GA
az iot ops mgmt-actions execute	Eseguire un'azione di gestione su un asset dello spazio dei nomi.	Estensione	GA
az iot ops mgmt-actions show	Mostra la configurazione delle azioni di gestione per un'istanza di operazioni IoT.	Estensione	GA

az iot ops mgmt-actions disable

Disabilitare le azioni di gestione per un'istanza di operazioni IoT.

Rimuove le risorse delle azioni di gestione associate all'istanza, tra cui il grafico del flusso di dati, il flusso di dati di risposta, l'endpoint del flusso di dati EG, lo spazio degli argomenti EG, le associazioni di autorizzazioni e la voce dell'endpoint di gestione dello spazio dei nomi ADR.

Le assegnazioni di ruolo non vengono rimosse perché possono essere condivise con altre risorse.

Lo spazio dei nomi di Griglia di eventi viene individuato dalla configurazione dell'endpoint di gestione dello spazio dei nomi ADR. Se la voce dell'endpoint di gestione è già stata rimossa, la pulizia di Griglia di eventi viene ignorata normalmente.

az iot ops mgmt-actions disable --instance
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--no-progress {false, true}]
                                [--yes {false, true}]

Esempio

Disabilitare le azioni di gestione per un'istanza di .

az iot ops mgmt-actions disable --instance myinstance -g myresourcegroup

Disabilitare le azioni di gestione senza richiesta di conferma.

az iot ops mgmt-actions disable --instance myinstance -g myresourcegroup --yes

Parametri necessari

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

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

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Proprietà	Valore
Valori accettati:	false, true

--yes -y

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

Proprietà	Valore
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 mgmt-actions enable

Abilitare le azioni di gestione per un'istanza di operazioni IoT.

Esegue il bootstrap dell'infrastruttura che abilita la chiamata basata sul cloud delle azioni di gestione sugli asset tramite l'integrazione del broker MQTT di Griglia di eventi.

L'operazione configura le risorse in tre domini:

Spazio dei nomi di Griglia di eventi: spazio degli argomenti, modelli di argomento e associazioni di autorizzazioni.
Spazio dei nomi del Registro di sistema dispositivi: abilitazione dell'identità gestita e configurazione dell'endpoint di gestione.
Istanza operativa IoT: endpoint del flusso di dati, grafico del flusso di dati e flusso di dati di risposta.

Il comando è idempotente. Se esiste già una risorsa, viene ignorata. In caso di errore parziale, eseguire di nuovo il comando per raggiungere lo stato desiderato.

Per impostazione predefinita, le assegnazioni di ruolo (Event Grid TopicSpaces Publisher e Subscriber) vengono create sia per lo spazio dei nomi ADR che per l'estensione AIO mi rispetto allo spazio dei nomi EG. Usare --skip-ra per ignorare la creazione dell'assegnazione di ruolo o --adr-role-ids / --ops-role-ids per fornire ID ruolo personalizzati.

az iot ops mgmt-actions enable --eg-resource-id
                               --instance
                               --resource-group
                               [--acquire-policy-token]
                               [--adr-role-ids]
                               [--change-reference]
                               [--dataflow-profile]
                               [--eg-client-group]
                               [--mi-user-assigned]
                               [--no-progress {false, true}]
                               [--ops-role-ids]
                               [--registry-endpoint]
                               [--skip-ra {false, true}]

Esempio

Abilitare le azioni di gestione per un'istanza usando l'identità gestita dal sistema.

az iot ops mgmt-actions enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID

Abilitare le azioni di gestione usando un'identità gestita assegnata dall'utente per l'endpoint del flusso di dati EG.

az iot ops mgmt-actions enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --mi-user-assigned $UA_MI_RESOURCE_ID

Abilitare le azioni di gestione e ignorare le assegnazioni di ruolo.

az iot ops mgmt-actions enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --skip-ra

Parametri necessari

--eg-resource-id

ID risorsa ARM dello spazio dei nomi di Griglia di eventi.

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

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

--adr-role-ids

ID ruolo personalizzati per le assegnazioni di ruolo dell'identità gestita dello spazio dei nomi di Active Directory rispetto allo spazio dei nomi EG. Impostazione predefinita: 'Event Grid TopicSpaces Publisher' e 'Event Grid TopicSpaces Subscriber'.

Proprietà	Valore
Gruppo di parametri:	Role Assignment Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--dataflow-profile

Nome del profilo del flusso di dati per le risorse del grafico e del flusso di dati. Impostazione predefinita: 'default'.

--eg-client-group

Gruppo client per associazioni di autorizzazioni EG. Impostazione predefinita: $all.

--mi-user-assigned

ID risorsa identità gestita assegnata dall'utente per l'autenticazione dell'endpoint del flusso di dati EG. Impostazione predefinita: identità gestita dal sistema.

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Proprietà	Valore
Valori accettati:	false, true

--ops-role-ids

ID ruolo personalizzati per le assegnazioni di ruolo dell'identità gestita dell'estensione AIO rispetto allo spazio dei nomi EG. Impostazione predefinita: 'Event Grid TopicSpaces Publisher' e 'Event Grid TopicSpaces Subscriber'.

Proprietà	Valore
Gruppo di parametri:	Role Assignment Arguments

--registry-endpoint

Nome dell'endpoint del Registro di sistema per il grafico del flusso di dati. Impostazione predefinita: 'default'.

--skip-ra

Quando viene usato il passaggio di assegnazione di ruolo dell'operazione verrà ignorato.

Proprietà	Valore
Gruppo di parametri:	Role Assignment Arguments
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 mgmt-actions execute

Eseguire un'azione di gestione su un asset dello spazio dei nomi.

Richiama un'azione di gestione definita in un asset dello spazio dei nomi tramite l'operazione executeAction del Registro di sistema dispositivi. L'infrastruttura delle azioni di gestione deve essere abilitata (az iot ops mgmt-actions enable) prima di poter eseguire le azioni.

Il comando risolve lo spazio dei nomi ADR dall'istanza di Operazioni IoT e invia l'azione come operazione a esecuzione prolungata. Il risultato include lo stato dell'azione, qualsiasi risposta dell'asset e i dettagli dell'errore se l'azione non è riuscita.

Quando viene fornito un payload, l'interfaccia della riga di comando la convalida rispetto allo schema di richiesta dell'azione (se disponibile) prima di inviare la richiesta. Usare --no-validate per ignorare questo controllo. Usare --show-schema per visualizzare lo schema della richiesta dell'azione senza eseguire.

az iot ops mgmt-actions execute --action
                                --asset
                                --group
                                --instance
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--no-validate]
                                [--payload]
                                [--show-schema]

Esempio

Eseguire un'azione di gestione senza payload.

az iot ops mgmt-actions execute --instance myinstance -g myresourcegroup --asset myasset --group mygroup --action reboot

Eseguire un'azione di gestione con payload JSON inline.

az iot ops mgmt-actions execute --instance myinstance -g myresourcegroup --asset myasset --group mygroup --action configure -p '{"temperature": {"setpoint": 72}}'

Eseguire un'azione di gestione con payload dal file.

az iot ops mgmt-actions execute --instance myinstance -g myresourcegroup --asset myasset --group mygroup --action configure -p payload.json

Visualizzare lo schema della richiesta per un'azione di gestione.

az iot ops mgmt-actions execute --instance myinstance -g myresourcegroup --asset myasset --group mygroup --action configure --show-schema

Eseguire con payload, ignorando la convalida dello schema.

az iot ops mgmt-actions execute --instance myinstance -g myresourcegroup --asset myasset --group mygroup --action configure -p '{"temperature": {"setpoint": 72}}' --no-validate

Parametri necessari

--action

Nome dell'azione di gestione da eseguire.

--asset

Nome dell'asset dello spazio dei nomi in cui eseguire l'azione di gestione.

--group

Nome del gruppo di gestione con cui viene definita l'azione.

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

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

--no-validate

Ignorare la convalida del payload sul lato client rispetto allo schema di richiesta dell'azione.

Proprietà	Valore
Valore predefinito:	False

--payload -p

Payload JSON per l'azione di gestione. Stringa JSON inline o percorso del file (ad esempio, payload.json).

--show-schema

Risolvere e visualizzare lo schema di richiesta dell'azione. Non viene eseguita alcuna azione.

Proprietà	Valore
Valore predefinito:	False

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 mgmt-actions show

Mostra la configurazione delle azioni di gestione per un'istanza di operazioni IoT.

Controlla lo stato delle risorse delle azioni di gestione in tre aree: spazio dei nomi del Registro di dispositivi (ADR), risorse di Griglia di eventi e risorse del flusso di dati AIO.

Restituisce un riepilogo strutturato con un flag abilitato complessivo e sezioni di dettaglio per dominio. Un dominio che non può essere sottoposto a probe (ad esempio, riferimento dello spazio dei nomi ADR mancante) restituisce Null per tale sezione senza impedire la verifica di altri domini.

az iot ops mgmt-actions show --instance
                             --resource-group
                             [--no-progress {false, true}]

Esempio

Mostra la configurazione delle azioni di gestione per un'istanza di .

az iot ops mgmt-actions show --instance myinstance -g myresourcegroup

Parametri necessari

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

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

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Proprietà	Valore
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

Commenti e suggerimenti

Questa pagina è stata utile?