Modalità interattiva dell'interfaccia della riga di comando di Azure Sphere (anteprima)

Importante

Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).

L'interfaccia della riga di comando di Azure Sphere supporta la modalità interattiva che offre un ambiente interattivo per eseguire i comandi dell'interfaccia della riga di comando di Azure Sphere, ideale per i nuovi utenti che apprendeno le funzionalità, le strutture dei comandi e i formati di output dell'interfaccia della riga di comando. È possibile avviare la modalità interattiva usando il comando azsphere interactive in un'interfaccia della riga di comando usando PowerShell, il prompt dei comandi di Windows o la shell Bash. Il prompt dei comandi cambia per azsphere>> indicare che sono ora in esecuzione comandi nella shell interattiva.

Importante

Questa funzionalità si trova in anteprima. Potrebbe essere modificato o rimosso in una versione futura.

Configurare

La modalità interattiva mostra, facoltativamente, le descrizioni dei comandi, le descrizioni dei parametri ed esempi di comando.

Opzione	Descrizione
F1	Attiva o disattiva descrizioni ed esempi.
F2	Attiva o disattiva la visualizzazione delle impostazioni predefinite dei parametri.
F3	Attiva o disattiva la visualizzazione di alcuni movimenti chiave.
[CTRL+D]	Esce dalla modalità interattiva.

Ambito set

La modalità interattiva consente di definire l'ambito dei comandi in un gruppo specifico di comandi. Se si vogliono usare device certificate solo i comandi, è possibile usare quanto segue per impostare l'ambito corretto in modo che non sia necessario digitare device certificate con tutti i comandi successivi.

Ad esempio, quando si imposta l'ambito come %%device certificate:

azsphere>> %%device certificate
defaulting: device
defaulting: certificate
azsphere device certificate>>

Per rimuovere l'ambito immettere $ %% .. e rimuovere tutte le informazioni di ambito, %%.

Esempi

La modalità interattiva elenca esempi per alcuni comandi contestualmente durante la digitazione dei comandi. Se il comando contiene troppi esempi per adattarsi alla finestra del terminale, è possibile esaminare tutti gli esempi scorrendo il riquadro di esempio con CTRL+Y e CTRL+N rispettivamente per 'su' e 'giù'.

La modalità interattiva offre diversi modi per creare ed eseguire il comando. Il numero di esempio è indicato nel riquadro di esempio. È possibile selezionare uno specifico da visualizzare nel riquadro di esempio. Ad esempio:

Completamento automatico

La modalità interattiva visualizza il risultato del comando immesso. Fornisce una casella di riepilogo a discesa completamento automatico, suggerimenti memorizzati automaticamente nella cache e documentazione dinamica, inclusi esempi di come viene usato ogni comando. Il completamento del valore del parametro è supportato per i --application-updateparametri , --device--debug-mode, --device-group, --none--tenant--os-feed--manual-start--product--full--role--state--force--enable-rt-core-debugging--targeted-scan--temporary--style--typee .--user

Comandi usati di frequente

La modalità interattiva tiene traccia dei comandi digitati in precedenza e dei comandi usati più di frequente. Il comando viene visualizzato quando i caratteri iniziali vengono digitati nell'interfaccia del prompt dei comandi.

Codice di uscita

L'opzione $ consente di visualizzare il codice di uscita dell'ultimo comando eseguito per verificare che sia stato eseguito correttamente. Ad esempio:

azsphere>> $
Success: 0

Comandi esterni alla modalità interattiva

La modalità interattiva dell'interfaccia della riga di comando di Azure Sphere consente a un utente di eseguire comandi all'esterno dell'interfaccia della riga di comando di Azure Sphere senza uscire dalla modalità interattiva usando #[command] nell'interfaccia della riga di comando. Ad esempio:

azsphere>> #git --version
git version 2.28.0.windows.1

Query comando precedente

È possibile eseguire una query JMESPath sui risultati dell'ultimo comando eseguito usando ?? seguito da una query JMESPath. Ad esempio, dopo aver elencato tutti i prodotti, è possibile eseguire la query per elencare solo i nomi dei prodotti.

azsphere>> azsphere product list
 ------------------------------------ ------------------------------------ --------------- --------------------
 Id                                   TenantId                             Name            Description
 ==============================================================================================================
 a2cd64be-adc2-4bfd-8f34-7d8c90293893 143adbc9-1bf0-4be2-84a2-084a331d81cb MyFridgeProduct None
 ------------------------------------ ------------------------------------ --------------- --------------------
 e5fe65f7-0df5-481e-9f4c-44b1a00d2d60 143adbc9-1bf0-4be2-84a2-084a331d81cb CoffeeMaker     None
 ------------------------------------ ------------------------------------ --------------- --------------------

L'output per la query jmespath sarà:

azsphere>> ??"[].{Productname:name}"
[
  {
    "Productname": "MyFridgeProduct"
  },
  {
    "Productname": "CoffeeMaker"
  }
]