Immagine

Gestisce le immagini di Azure Sphere su disco.

Operazione	Descrizione
Aggiungere	Carica una nuova immagine.
Scaricare	Scarica un'immagine.
Visualizza	Visualizza informazioni sull'immagine specificata.

Aggiungere

Carica una nuova immagine nel tenant azure sphere.

Parametri obbligatori

Parametro	Digitare	Descrizione
--Immagine	Stringa	Specifica il percorso dell'immagine da caricare.

Parametri facoltativi

Parametro	Digitare	Descrizione
-t, --tenant	GUID o nome	Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.
--Provvisorio	Boolean	Contrassegna il pacchetto di immagini come temporaneo. Questo parametro è destinato all'uso durante il processo di produzione.
--Forza	Boolean	Forza il caricamento di immagini con un'API Beta.
-r, --regional-data-boundary	Stringa	Limite dei dati regionali per questa immagine. Valori consentiti: EU, None. Il valore predefinito è None. Se non viene specificato alcun valore, verrà usato il valore predefinito. Per ulteriori informazioni, vedi Configurare dump di arresto anomalo - Considerazioni pivacy

Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro	Descrizione
--debug	Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help	Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors	Mostra solo gli errori, eliminando gli avvisi.
-o, --output	Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query	Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato	Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere image add --image C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage --temporary
Uploading image from file 'C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage':
 --> Image ID:       d788fdd1-28eb-4477-9818-a4734289f2f1
 --> Component ID:   99d419ef-296d-43b0-ade1-809efe3a7aba
 --> Component name: 'QuickStart-AzureSphereBlink1'
Retaining temporary state for uploaded image.
Successfully uploaded image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1' and name 'QuickStart-AzureSphereBlink1' to component with ID '99d419ef-296d-43b0-ade1-809efe3a7aba'.

Scaricare

Scarica un'immagine esistente dal tenant Azure Sphere.

Parametri obbligatori

Parametro	Digitare	Descrizione
-i, --image	Stringa	Specifica l'ID dell'immagine da scaricare. Eseguire il comando azsfera image add per ottenere l'ID immagine.
--Destinazione	Stringa	Specifica il percorso e il nome file in cui salvare l'immagine. Il percorso del file può essere assoluto o relativo.

Parametri facoltativi

Parametro	Digitare	Descrizione
-t, --tenant	GUID o nome	Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.

Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro	Descrizione
--debug	Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help	Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors	Mostra solo gli errori, eliminando gli avvisi.
-o, --output	Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query	Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato	Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere image download --image d788fdd1-28eb-4477-9818-a4734289f2f1 --destination AzureSphereBlink1.image
Getting the image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
 ---------
 Result
 =========
 Succeeded
 ---------

Visualizza

Mostra i dettagli di un'immagine esistente dal tenant azure sphere.

Parametri obbligatori

Parametro	Digitare	Descrizione
-i, --image	GUID	Specifica l'ID dell'immagine per cui recuperare i dettagli. Eseguire il comando azsfera image add per ottenere l'ID immagine.

Parametri facoltativi

Parametro	Digitare	Descrizione
-t, --tenant	GUID o nome	Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant.

Parametri globali

Per Azure Sphere CLI sono disponibili i seguenti parametri globali:

Parametro	Descrizione
--debug	Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug.
-h, --help	Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili.
--only-show-errors	Mostra solo gli errori, eliminando gli avvisi.
-o, --output	Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere.
--Query	Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query.
--Dettagliato	Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi.

Nota

Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.

Esempio

azsphere image show --image d788fdd1-28eb-4477-9818-a4734289f2f1
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------
ImageId                              ComponentId                          Name                         SigningStatus ImageType     RegionalDataBoundary
========================================================================================================================================================
d788fdd1-28eb-4477-9818-a4734289f2f1 99d419ef-296d-43b0-ade1-809efe3a7aba QuickStart-AzureSphereBlink1 Succeeded     Applications  None
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------