Share via

Eseguire la migrazione dalla cli classica ad Azure Sphere CLI

  • Articolo

Se usi ancora la cli classica di Azure Sphere, ti consigliamo di eseguire la migrazione alla nuova CLI di Azure Sphere. Attualmente entrambe le versioni di CLI possono essere installate e usate affiancate, ma la cli 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 eseguire l'aggiornamento all'SDK più recente, vedi Installare Azure Sphere SDK su Linux o Installare azure sphere SDK per Windows.

Per usare Azure Sphere CLI in Windows, usa PowerShell o un prompt dei comandi di Windows standard. Per Linux, usa qualsiasi shell dei comandi. Per altre informazioni, vedere Eseguire Azure Sphere CLI.

In Windows, il prompt dei comandi personalizzato per sviluppatori Azure Sphere Classic (disponibile come collegamento nel menu Start in Azure Sphere) può essere usato solo con la cli classica di Azure Sphere. Per altre informazioni, vedere Eseguire la cli classica di Azure Sphere.

Principali differenze

  • In Azure Sphere cli classico, è possibile usare più parametri per identificare ogni tipo di oggetto. In Azure Sphere CLI viene usato un singolo parametro per identificare ogni tipo di oggetto. Questo 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 di oggetto Azure Sphere CLI CLI classico di Azure Sphere (ritiro)
    Dispositivo --device --deviceid, o --deviceip--devicelocation
    Gruppo di dispositivi --device-group --devicegroupid O --devicegroupname
    Prodotto --product --productid O --productname
    Inquilino --tenant --tenantid

  • La forma breve per i comandi è supportata nella versione classica. In Azure Sphere CLI è consigliabile usare la funzionalità di completamento della scheda o interattiva per visualizzare l'elenco dei comandi disponibili. Ad esempio, nella CLI classica è possibile usare uno azsphere device enable-development o azsphere dev edv un comando, mentre nella nuova cli 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. 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

  • Nella nuova cli, il tenant predefinito non viene selezionato automaticamente al momento della creazione di un tenant. È necessario eseguire il comando di selezione tenant azsfera per selezionare il tenant predefinito da usare per l'utente corrente nel PC. Questo per garantire che il tenant predefinito sia quello corretto da usare quando si esegue un'operazione una tantum che non è possibile annullare come rivendicare il dispositivo.

    Quando si usano 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. Per 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, puoi usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato nome-prodotto>/<nome-gruppo-dispositivo> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un determinato prodotto.

  • I comandi seguenti erano comandi composti nella cli classica. Questo significa che un comando ha eseguito più attività. Nella nuova CLI è necessario eseguire i due comandi.

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

  • Nell'interfaccia cli classica il -d parametro or --debug viene utilizzato nel comando di avvio dell'app dispositivo azsfera per avviare l'applicazione in modalità di debug. Nel nuovo Azure Sphere CLI, il parametro viene utilizzato per avviare l'applicazione in modalità debug e il --debug parametro viene utilizzato come parametro globale per aumentare il --debug-mode livello di dettaglio della registrazione per mostrare tutti i log di debug.

  • Nella cli classica non c'è alcun controllo sul formato di output. In Azure Sphere CLI, il -o parametro or --output viene usato per specificare il formato di output in cui formattare l'output CLI.

  • Dalla versione 21.02 in poi i numeri di versione espliciti sono stati rimossi dai nomi di prodotto cli azure sphere. Questa modifica elimina la confusione nel fare riferimento alle diverse versioni del prodotto.

    • Azure Sphere CLI v2 e versioni successive sono ora chiamati solo "Azure Sphere CLI".
    • Le versioni precedenti di Azure Sphere CLI (CLI v1 e inferiore) sono ora denominate "Azure Sphere classic CLI".

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

Vedere anche