Condividi tramite

Panoramica dell'interfaccia della riga di comando di Azure Sphere

  • Articolo

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 è un set di comandi usati per gestire le risorse di Azure Sphere.

Sono disponibili i comandi seguenti:

Nota

Il comando register-user è ora deprecato.

Interfaccia della riga di comando di Azure Sphere e interfaccia della riga di comando classica di Azure Sphere

L'interfaccia della riga di comando di Azure Sphere viene installata insieme all'interfaccia della riga di comando esistente sia in Windows che in Linux, quindi è possibile accedere a entrambe le interfacce. L'interfaccia della riga di comando classica di Azure Sphere continua a funzionare come sempre.

Per usare l'interfaccia della riga di comando di Azure Sphere:

  • In Windows usare PowerShell o un prompt dei comandi di Windows standard.
  • In Linux usare qualsiasi shell dei comandi. Specificare il comando azsphere se si imposta l'interfaccia della riga di comando di Azure Sphere come predefinita durante l'installazione dell'SDK o il comando azsphere_v2 se si imposta l'interfaccia della riga di comando classica di Azure Sphere come predefinita.

Per informazioni dettagliate sulle funzionalità e i comandi supportati dall'interfaccia della riga di comando di Azure Sphere, vedere l'interfaccia della riga di comando di Azure Sphere.

Importante

  • In Windows, il collegamento al prompt dei comandi per gli sviluppatori classici di Azure Sphere può essere usato solo con l'interfaccia della riga di comando classica di Azure Sphere.

Formato della riga di comando

La riga di comando azsphere ha il formato seguente:

azsphere [command] [subcommand] operation [parameters]

In genere, comando e sottocomando sono dei sostantivi, mentre l’operazione è un verbo, in modo che la combinazione identifichi sia l’azione sia l'oggetto dell'azione. La maggior parte dei comandi e delle operazioni includono sia un nome completo che un'abbreviazione. Ad esempio, il comando device è abbreviato d.

La maggior parte dei parametri hanno sia un nome completo che un'abbreviazione. Nella riga di comando, introdurre il nome competo con due trattini e l'abbreviazione con un trattino. Ad esempio, i due comandi seguenti sono equivalenti:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

Alcuni comandi consentono più valori per un singolo parametro. Nell'interfaccia della riga di comando di Azure Sphere è possibile specificare un singolo parametro seguito da un elenco di valori separati da spazi e nell'interfaccia della riga di comando classica di Azure Sphere l'elenco di valori è separato da virgole. Ad esempio:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

Virgolette e caratteri di escape

Quando si usano i comandi dell'interfaccia della riga di comando di Azure Sphere, tenere presente come la shell usa le virgolette e i caratteri di escape. Se si supportano gli script usati in shell diverse, è necessario comprendere in che modo differiscono.

Ad esempio:

Comandi dipendenti dal cloud

I comandi azsphere seguenti richiedono una connessione cloud e accedono al servizio di sicurezza di Azure Sphere:

  • ca-certificate
  • device-group
  • get-support-data
  • image
  • login
  • logout
  • product
  • ruolo
  • show-user
  • tenant

Inoltre, i comandi dei dispositivi azsphere seguenti richiedono una connessione cloud:

comando del dispositivo azsphere Commenti
capability Richiede il servizio di sicurezza di Azure Sphere per il download della funzionalità del dispositivo
claim
enable-cloud-test
enable-development
Immagine
list
recover Richiede la connettività Internet, ma non l'accesso al servizio di sicurezza di Azure Sphere
show
show-count
show-deployment-status
show-os-version Richiede la connettività Internet, ma non l'accesso al servizio di sicurezza di Azure Sphere
update

Comandi dipendenti dalle funzionalità del dispositivo

I comandi azsphere device seguenti richiedono l'uso di una funzionalità di dispositivo per i dispositivi nello stato di produzione DeviceComplete:

Operazione Descrizione
app Gestisce le applicazioni nel dispositivo collegato.
capability Gestisce le configurazioni delle funzionalità di dispositivo. Obbligatorio per l'aggiornamento delle funzionalità.
certificato Gestisce l'archivio certificati del dispositivo.
image Gestisce le immagini dei dispositivi.
stato di produzione Gestisce lo stato di produzione dei dispositivi collegati. Obbligatorio per l'aggiornamento dello stato di produzione.
restart Riavvia il dispositivo collegato.
show-deployment-status Mostra lo stato di distribuzione del sistema operativo e delle applicazioni nel dispositivo collegato.
show-os-version Visualizzare la versione del sistema operativo nel dispositivo collegato.
sideload Distribuisce e gestisce le applicazioni nel dispositivo collegato. Obbligatorio per la distribuzione sideload e l'eliminazione sideload.
wifi Gestisce le configurazioni Wi-Fi per il dispositivo collegato.

Se si tenta di eseguire questi comandi senza una funzionalità, viene visualizzato un messaggio di errore che indica di eseguire azsphere device enable-development o usare azsphere device capability per scaricare e selezionare un file di funzionalità per il dispositivo.