image, imgimage, img

Gestisce le immagini Azure Sphere sul disco.Manages Azure Sphere images on disk.

OperazioneOperation DescrizioneDescription
addadd Carica una nuova immagine.Uploads a new image.
downloaddownload Scarica un'immagine.Downloads an image.
showshow Visualizza le informazioni sull'immagine specificata.Displays information about the specified image.

addadd

Carica un'immagine nel cloud.Uploads an image to the cloud.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-f,--FilePath-f, --filepath stringString Specifica il percorso dell'immagine da includere nella distribuzione.Specifies the path to the image to include in the deployment. È possibile aggiungere più immagini aggiungendo parametri aggiuntivi oppure è possibile combinare più percorsi di immagini in un singolo parametro in un elenco delimitato da virgole.Add multiple images by adding additional parameters, or multiple image paths can be combined in a single parameter in a comma-separated list. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-f,--file-path-f, --file-path stringString Specifica il percorso dell'immagine da includere nella distribuzione.Specifies the path to the image to include in the deployment. È possibile aggiungere più immagini aggiungendo parametri aggiuntivi oppure è possibile combinare più percorsi di immagini in un singolo parametro in un elenco delimitato da virgole.Add multiple images by adding additional parameters, or multiple image paths can be combined in a single parameter in a comma-separated list. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
--temporanea--temporary - Contrassegna il pacchetto immagine come temporaneo.Marks the image package as temporary. Questo parametro deve essere usato durante il processo di produzione.This parameter is intended for use during the manufacturing process. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
--force--force - Forza il caricamento di immagini usando un'API beta.Forces uploading of image(s) using a Beta API. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere.Specifies the ID or name of the Azure Sphere tenant. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere image add --file-path 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'.

downloaddownload

Scarica un'immagine dal cloud.Downloads an image from the cloud.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ImageId-i, --imageid GUIDGUID Specifica l'ID dell'immagine da scaricare dal tenant del Azure Sphere.Specifies the ID of the image to download from your Azure Sphere tenant. Eseguire il azsphere image add comando per ottenere l'ID immagine.Run the azsphere image add command to get the image ID. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-o, --output-o, --output stringString Specifica l'ID dell'immagine da scaricare dal tenant del Azure Sphere.Specifies the ID of the image to download from your Azure Sphere tenant. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--immagine-i, --image GUIDGUID Specifica l'immagine da scaricare dal tenant Azure Sphere.Specifies the image to download from your Azure Sphere tenant. Eseguire il azsphere image add comando per ottenere l'ID immagine.Run the azsphere image add command to get the image ID. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
-f,--Destination-file-f, --destination-file stringString Specifica il percorso e il nome del file in cui salvare l'immagine.Specifies the path and filename in which to save the image. Il percorso del file può essere un percorso assoluto o relativo.The file path can be an absolute or relative path. Versione beta dell'interfaccia della riga di Azure SphereAzure Sphere CLI Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere.Specifies the ID or name of the Azure Sphere tenant. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere image download --imageid d788fdd1-28eb-4477-9818-a4734289f2f1 --output AzureSphereBlink1.image
Getting the image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
Successfully downloaded image to location 'AzureSphereBlink1.image'.

showshow

Scarica i metadati per un'immagine già aggiunta a una distribuzione.Downloads the metadata for an image that has already been added to a deployment.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ImageId-i, --imageid GUIDGUID Specifica l'ID dell'immagine per cui ottenere i dettagli dal tenant del Azure Sphere.Specifies the ID of the image to get the details for from your Azure Sphere tenant. Eseguire il azsphere image add comando per ottenere l'ID immagine.Run the azsphere image add command to get the image ID. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--immagine-i, --image GUIDGUID Specifica l'ID dell'immagine per cui ottenere i dettagli dal tenant del Azure Sphere.Specifies the ID of the image to get the details for from your Azure Sphere tenant. Eseguire il azsphere image add comando per ottenere l'ID immagine.Run the azsphere image add command to get the image ID. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant stringString Specifica l'ID o il nome del tenant Azure Sphere.Specifies the ID or name of the Azure Sphere tenant. Azure Sphere dell'interfaccia della riga di comando v2 betaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere image show --imageid d788fdd1-28eb-4477-9818-a4734289f2f1
Getting the details for image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
Successfully retrieved image package details:
 -> Image ID:       d788fdd1-28eb-4477-9818-a4734289f2f1
 -> Component ID:   99d419ef-296d-43b0-ade1-809efe3a7aba
 -> Name:           QuickStart-AzureSphereBlink1
 -> Signing status: Succeeded
 -> Image type:     Application