Panoramica dell'estensione Azure Sphere per Azure CLI

  • Articolo

Lo strumento da riga di comando per la gestione dei dispositivi collegati ad Azure Sphere e delle distribuzioni cloud viene distribuito come estensione CLI di Azure.

Installare azure CLI e l'estensione Azure Sphere

Per acquisire l'estensione Azure Sphere per Azure CLI:

  1. Installare azure CLI se non è ancora stato fatto.

  2. Per aggiungere l'estensione Azure Sphere, esegui il comando seguente:

    az extension add --name azure-sphere

Per accedere alla sottoscrizione di Azure che si desidera utilizzare per gestire i dispositivi Azure Sphere, è necessario eseguire l'accesso con Azure CLI .

Una volta installata un'estensione, la sua posizione si trova sotto il valore della $AZURE_EXTENSION_DIR variabile shell. Se questa variabile non èsetata, per impostazione predefinita il valore è $HOME/.azure/cliextensions su Linux e macOS e %USERPROFILE%\.azure\cliextensions su Windows.

Mancia

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

Gestione dell'estensione Azure Sphere

Per visualizzare le versioni installate delle estensioni di Azure CLI, usare il comando:

az version

Per aggiornare l'estensione Azure Sphere all'ultima versione, usa:

az extension update --name azure-sphere

Per disinstallare l'estensione Azure Sphere, usa:

az extension remove --name azure-sphere

Comandi CLI comuni di Azure Sphere

È possibile usare i comandi di Azure Sphere digitando az sphere dal prompt dei comandi di Windows o da PowerShell. Su Linux, è possibile utilizzare qualsiasi interfaccia della riga di comando (CLI). La CLI ha il completamento completo della scheda per i comandi sotto la shell bash.

Questa tabella elenca alcuni comandi comuni di Azure Sphere e collegamenti alla 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 Gestisci 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 Raccogli dati di diagnostica sulle configurazioni di sistema, cloud e dispositivo.

Azure CLI consente di configurare le opzioni di configurazione che semplificano l'uso dei comandi cli di Azure Sphere fornendo le impostazioni predefinite per parametri come --resource-group, --subscriptiono --catalog.

Comandi dipendenti dal dispositivo

Il comando funziona con un dispositivo Azure Sphere collegato localmente. Se tenti di eseguire il comando senza un dispositivo collegato, riceverai un errore. Per ulteriori informazioni sui comandi del dispositivo, vedere

  • 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 seguenti parametri globali:

Parametro Descrizione
--debug Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
--help -h Mostra il messaggio della Guida.
--only-show-errors Mostra solo gli errori, eliminando gli avvisi.
--output -o Formato output. Valori consentiti: json, jsonc, none, table, tsv, yaml, . yamlc Impostazione predefinita: json.
--query Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/ .
--subscription : nome o ID dell'abbonamento. È possibile configurare l'abbonamento predefinito utilizzando az account set -s NAME_OR_ID.
--verbose Aumentare il livello di dettaglio della registrazione. Da usare --debug per i log di debug completi.