Panoramica dell'estensione Azure Sphere per l'interfaccia della riga di comando di Azure

Articolo
07/08/2024

Lo strumento da riga di comando per la gestione di dispositivi collegati e distribuzioni cloud di Azure Sphere viene distribuito come estensione dell'interfaccia della riga di comando di Azure.

Installare l'interfaccia della riga di comando di Azure e l'estensione Azure Sphere

Per acquisire l'estensione Azure Sphere per l'interfaccia della riga di comando di Azure:

Se non è ancora stato fatto, installare l'interfaccia della riga di comando di Azure.
Per aggiungere l'estensione Azure Sphere, eseguire il comando seguente:
```
az extension add --name azure-sphere
```

È necessario accedere con l'interfaccia della riga di comando di Azure per accedere alla sottoscrizione di Azure che si vuole usare per gestire i dispositivi Azure Sphere.

Dopo l'installazione di un'estensione, il relativo percorso viene trovato sotto il valore della variabile della $AZURE_EXTENSION_DIR shell. Se questa variabile non è impostata, per impostazione predefinita il valore è $HOME/.azure/cliextensions su Linux e macOS e %USERPROFILE%\.azure\cliextensions in Windows.

Suggerimento

Dopo l'accesso, verrà visualizzato un elenco di sottoscrizioni associate all'account Azure. Assicurarsi di selezionare la sottoscrizione con le autorizzazioni necessarie usando il az account set comando per il corretto funzionamento dell'estensione Azure Sphere. Per altre informazioni sulla selezione delle sottoscrizioni, vedere Usare più sottoscrizioni di Azure.

Gestione dell'estensione Azure Sphere

Per visualizzare le versioni installate delle estensioni dell'interfaccia della riga di comando di Azure, usare il comando :

az version

Per aggiornare l'estensione Azure Sphere alla versione più recente, usare:

az extension update --name azure-sphere

Per disinstallare l'estensione Azure Sphere, usare:

az extension remove --name azure-sphere

Comandi comuni dell'interfaccia della riga di comando di Azure Sphere

È possibile usare i comandi di Azure Sphere digitando az sphere dal prompt dei comandi di Windows o da PowerShell. In Linux è possibile usare qualsiasi interfaccia della riga di comando . L'interfaccia della riga di comando offre il completamento tramite tasto TAB per tutti i comandi nella shell bash.

Questa tabella elenca alcuni comandi comuni di Azure Sphere e collegamenti alla relativa documentazione di riferimento.

Comando	Descrizione
`az sphere catalog`	Gestire il catalogo.
`az sphere ca-certificate`	Gestire i certificati nel catalogo.
`az sphere deployment`	Gestire le distribuzioni nel catalogo.
`az sphere device`	Gestire i dispositivi Azure Sphere.
`az sphere device-group`	Gestire i gruppi di dispositivi nel catalogo.
`az sphere image`	Gestire le immagini nel catalogo.
`az sphere product`	Gestire i prodotti nel catalogo.
`az sphere get-support-data`	Raccogliere dati di diagnostica sulle configurazioni di sistema, cloud e dispositivo.

L'interfaccia della riga di comando di Azure consente di configurare le opzioni di configurazione che semplificano l'uso dei comandi dell'interfaccia --resource-groupdella riga di comando di Azure Sphere fornendo valori predefiniti per parametri come , --subscriptiono --catalog.

Comandi dipendenti dal dispositivo

Il comando funziona con un dispositivo Azure Sphere collegato in locale. Se si tenta di eseguire il comando senza un dispositivo collegato, verrà visualizzato un errore. Per altre informazioni sui comandi del dispositivo, vedere az sphere device

az sphere device claim
az sphere device recover
az sphere device restart
az sphere device show-attached
az sphere device show-os-version
az sphere device app show-memory-status
az sphere device app show-quota
az sphere device app show-status
az sphere device app start
az sphere device app stop
az sphere device capability show-attached
az sphere device capability update
az sphere device certificate add
az sphere device certificate delete
az sphere device certificate list
az sphere device certificate show
az sphere device certificate show-quota
az sphere device image list-installed
az sphere image-package show
az sphere device manufacturing-state show
az sphere device manufacturing-state update
az sphere device network proxy apply
az sphere device network proxy delete
az sphere device network proxy show
az sphere device network disable
az sphere device network enable
az sphere device network list-firewall-rules
az sphere device network list-interfaces
az sphere device network show-diagnostics
az sphere device network show-status
az sphere device network update-interface
az sphere device sideload delete
az sphere device sideload deploy
az sphere device wifi add
az sphere device wifi disable
az sphere device wifi enable
az sphere device wifi forget
az sphere device wifi list
az sphere device wifi reload-config
az sphere device wifi scan
az sphere device wifi show
az sphere device wifi show-status

Argomenti disponibili a livello globale

Per l'estensione Azure Sphere sono disponibili i parametri globali seguenti:

Parametro	Descrizione
`--debug`	Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
`--help -h`	Visualizza il messaggio della Guida.
`--only-show-errors`	Vengono visualizzati solo gli errori, eliminando gli avvisi.
`--output` `-o`	Formato di output. Valori consentiti: `json`, `jsonc`, `tablenone`, `tsv`, `yaml`. `yamlc` Impostazione predefinita: `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 i log di debug completi.

Condividi tramite