Condividi tramite

Panoramica di Azure Sphere CLI

  • Articolo

Azure Sphere CLI è un set di comandi usati per gestire le risorse di Azure Sphere.

Sono disponibili i comandi seguenti:

Azure Sphere CLI e Azure Sphere classic CLI

Azure Sphere CLI è installato insieme all'interfaccia cli esistente in Windows e Linux, quindi hai accesso a entrambe le interfacce. La cli classica di Azure Sphere continua a funzionare come sempre.

Per usare azure sphere CLI:

  • In Windows usare PowerShell o un prompt dei comandi di Windows standard.
  • Su Linux, usa qualsiasi shell dei comandi. Specificare il comando azsfera se si imposta Azure Sphere CLI come predefinito durante l'installazione dell'SDK o il comando azsphere_v2 se si imposta il cli classico di Azure Sphere come predefinito.

Per informazioni dettagliate sulle funzionalità e i comandi supportati da Azure Sphere CLI, vedi Cli di Azure Sphere .

Importante

  • In Windows, il collegamento al prompt dei comandi per sviluppatori azure sphere classico ritirato può essere usato solo con la cli classica di Azure Sphere.

Formato della riga di comando

La riga di comando azsfera ha il seguente formato:

azsphere [command] [subcommand] operation [parameters]

In generale, comando e sottocomando sono sostantimi e l'operazione è un verbo, in modo che la combinazione identifichi sia un'azione che l'oggetto dell'azione. La maggior parte dei comandi e delle operazioni ha sia un nome completo che un'abbreviazione. Ad esempio, il comando del dispositivo è abbreviato d.

La maggior parte dei parametri ha un nome lungo e un'abbreviazione. Nella riga di comando introdurre il nome lungo con due trattini e l'abbreviazione con un singolo segno meno. 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. In Azure Sphere CLI è possibile fornire un singolo parametro seguito da un elenco di valori separati da spazi e nell'cli classico di Azure Sphere l'elenco dei valori è separato da virgole. Per 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 CLI di Azure Sphere, tenere presente che la shell usa le virgolette e i caratteri escape. Se si supportano script usati in shell diverse, è necessario comprendere le differenze.

Per esempio:

Comandi dipendenti dal cloud

I comandi di azsfera seguenti richiedono una connessione cloud e l'accesso al servizio Azure Sphere Security:

  • certificato ca
  • device-group
  • get-support-data
  • Immagine
  • Login
  • Logout
  • Prodotto
  • register-user
  • Ruolo
  • mostra-utente
  • Inquilino

Inoltre, i seguenti comandi del dispositivo azsfera richiedono anche una connessione cloud:

comando del dispositivo azsfera Commenti
Capacità Richiede il servizio azure sphere security per il download della funzionalità del dispositivo
richiesta
enable-cloud-test
abilita-sviluppo
Immagine
Elenco
Recuperare Richiede la connettività Internet, ma non esegue l'accesso al servizio di sicurezza Azure Sphere
Visualizza
show-count
mostra-distribuzione-stato
show-os-version Richiede la connettività Internet, ma non esegue l'accesso al servizio di sicurezza Azure Sphere
Aggiornamento

Comandi dipendenti dalla funzionalità del dispositivo

I seguenti comandi del dispositivo azsfera richiedono l'utilizzo di una funzionalità per i dispositivi in stato di produzione DeviceComplete:

Operazione Descrizione
App Gestisci le applicazioni nel dispositivo collegato.
Capacità Gestire le configurazioni delle funzionalità del dispositivo. Obbligatorio per l'aggiornamento delle funzionalità.
Certificato Gestire l'archivio certificati dispositivo.
Immagine Gestisci le immagini del dispositivo.
produzione-stato Gestire lo stato di produzione dei dispositivi collegati. Obbligatorio per l'aggiornamento dello stato di produzione.
Riavviare Riavvia il dispositivo collegato.
mostra-distribuzione-stato Visualizzare lo stato di distribuzione del sistema operativo e delle applicazioni nel dispositivo collegato.
show-os-version Mostra la versione del sistema operativo nel dispositivo collegato.
sideload Distribuire e gestire applicazioni nel dispositivo collegato. Obbligatorio per la distribuzione sideload e l'eliminazione del sideload.
Wifi Gestire le configurazioni Wi-Fi per il dispositivo collegato.

Se tenti di eseguire questi comandi senza funzionalità, ricevi 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.