Condividi tramite

Eseguire la migrazione dall'interfaccia della riga di comando classica all'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).

Se si usa ancora l'interfaccia della riga di comando classica di Azure Sphere, è consigliabile eseguire la migrazione alla nuova interfaccia della riga di comando di Azure Sphere. Attualmente entrambe le versioni dell'interfaccia della riga di comando possono essere installate e usate side-by-side, ma l'interfaccia della riga di comando classica non viene più aggiornata o mantenuta e verrà rimossa dall'SDK in una data futura (non prima della fine del 2022). È consigliabile acquisire familiarità con queste differenze ed eseguire la migrazione dei processi e degli script prima della fine del 2022 per evitare interruzioni.

Per aggiornare l'SDK all'ultima versione, vedere Installare Azure Sphere SDK in Linux o Installare Azure Sphere SDK per Windows.

Per usare l'interfaccia della riga di comando di Azure Sphere in Windows, usare PowerShell o un prompt dei comandi di Windows standard. Per Linux, usare qualsiasi shell di comando. Per maggiori informazioni, vedere l'interfaccia della riga di comando pubblica Azure Sphere.

In Windows, il prompt dei comandi per gli sviluppatori classici Azure Sphere (disponibile come collegamento nel menu Start in Azure Sphere) può essere usato solo con l'interfaccia della riga di comando classica Azure Sphere. Per maggiori informazioni, vedere Esecuzione dell'interfaccia della riga di comando pubblica Azure Sphere.

Differenze principali

  • Nell'interfaccia della riga di comando classica di Azure Sphere è possibile usare più parametri per identificare ogni tipo di oggetto. Nell'interfaccia della riga di comando di Azure Sphere viene usato un singolo parametro per identificare ogni tipo di oggetto. Ciò significa che è possibile usare il nome o l'ID per specificare il valore del parametro. Questa operazione è stata implementata per i --deviceparametri , --tenant--product, e --device-group .

    Tipo object Interfaccia della riga di comando di Azure Sphere Interfaccia della riga di comando classica Azure Sphere (ritiro)
    Dispositivo --device --deviceid, --deviceip o --devicelocation
    Gruppo di dispositivi --device-group --devicegroupid oppure --devicegroupname
    Prodotto --product --productid oppure --productname
    Tenant --tenant --tenantid

  • Il formato breve per i comandi è supportato nella versione classica. Nell'interfaccia della riga di comando di Azure Sphere è consigliabile usare la funzionalità di completamento della scheda o interattiva per visualizzare l'elenco dei comandi disponibili. Ad esempio, nell'interfaccia della riga di comando classica è possibile usare o azsphere device enable-development azsphere dev edv comando, mentre nella nuova interfaccia della riga di comando di Azure Sphere è possibile usare il completamento automatico per digitare rapidamente il azsphere device enable-development comando.

  • 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

  • Nella nuova interfaccia della riga di comando il tenant predefinito non viene selezionato automaticamente quando viene creato un tenant. È necessario eseguire il comando azsphere tenant select per selezionare il tenant predefinito da usare per l'utente corrente nel PC. Ciò consente di assicurarsi che il tenant predefinito sia quello corretto da usare quando si esegue un'operazione una tantum che non è possibile annullare come attestazione del dispositivo.

    Quando si usano gli script, è possibile selezionare il tenant predefinito usando il --tenant <tenant ID or tenant name> parametro .

    Impostare il tenant predefinito all'inizio dello script usando:

    azsphere tenant select --tenant <tenant ID or tenant name>

    È anche possibile sovrascrivere il tenant predefinito o specificare il tenant necessario durante l'esecuzione del comando. Ad esempio:

    azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>

  • Il --device-group parametro identifica il gruppo di dispositivi. L'ID del gruppo di dispositivi fornisce un GUID che identifica in modo univoco il gruppo di dispositivi in tutti i prodotti. In alternativa, è possibile usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato product-name>/<device-group-name> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un prodotto specifico.

  • I comandi seguenti erano comandi composti nell'interfaccia della riga di comando classica. Ciò significa che un comando ha eseguito più attività. Nella nuova interfaccia della riga di comando è necessario eseguire i due comandi.

    • Nell'interfaccia della riga di comando classica il comando azsphere device-group deployment create ha caricato il pacchetto immagine e creato una nuova distribuzione.

      Nella nuova interfaccia della riga di comando è necessario:

      1. Caricare il pacchetto immagine nel tenant di Azure Sphere usando azsphere image add.
      2. Creare una nuova distribuzione per un gruppo di dispositivi per le immagini caricate usando azsphere device-group deployment create.

    • Nell'interfaccia della riga di comando classica il comando azsphere device capability download --select scaricato e selezionato temporaneamente per la configurazione delle funzionalità del dispositivo collegato.

      Nella nuova interfaccia della riga di comando è necessario:

      1. Scaricare il file di funzionalità usando azsphere device capability download.
      2. Selezionare la funzionalità usando azsphere device capability select.

    • Nell'interfaccia della riga di comando classica il comando azsphere device capability download --apply scaricato e applicato la configurazione delle funzionalità del dispositivo per il dispositivo collegato.

      Nella nuova interfaccia della riga di comando è necessario:

      1. Scaricare il file di funzionalità usando azsphere device capability download.
      2. Applicare la funzionalità usando azsphere device capability update.

  • Nell'interfaccia della riga di comando classica viene usato il -o parametro o --output per specificare un percorso e un nome di file in cui salvare un file. Nella nuova interfaccia della riga di comando di Azure Sphere vengono usati parametri specifici del contesto, --destination ad esempio per specificare percorsi di input e output.

  • Nell'interfaccia della riga di comando classica il parametro o --debug viene usato nel comando azsphere device app start per avviare l'applicazione in modalità di debug.-d Nella nuova interfaccia della riga di comando di Azure Sphere il --debug-mode parametro viene usato per avviare l'applicazione in modalità di debug e il --debug parametro viene usato come parametro globale per aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

  • Nell'interfaccia della riga di comando classica non esiste alcun controllo sul formato di output. Nell'interfaccia della riga di comando di Azure Sphere il -o parametro o --output viene usato per specificare il formato di output in cui formattare l'output dell'interfaccia della riga di comando.

  • Dalla versione 21.02 in poi i numeri di versione espliciti sono stati rimossi dai nomi dei prodotti dell'interfaccia della riga di comando di Azure Sphere. Questa modifica elimina confusione nel fare riferimento alle diverse versioni del prodotto.

    • L'interfaccia della riga di comando di Azure Sphere v2 e versioni successive ora sono denominate solo "interfaccia della riga di comando di Azure Sphere".
    • Le versioni precedenti dell'interfaccia della riga di comando di Azure Sphere (cli v1 e versioni precedenti) sono ora denominate "interfaccia della riga di comando classica di Azure Sphere".

  • Se si usano script, potrebbero non essere compatibili con la nuova interfaccia della riga di comando di Azure Sphere a causa delle differenze illustrate in precedenza. Apportare gli aggiornamenti necessari per l'esecuzione corretta degli script nella nuova interfaccia della riga di comando.

Vedi anche