Imagem

Gerencia imagens do Azure Sphere em disco.

Operação	Descrição
Adicionar	Carrega uma nova imagem.
Download	Baixa uma imagem.
programa	Exibe informações sobre a imagem especificada.

Adicionar

Carrega uma nova imagem para o locatário do Azure Sphere.

Parâmetros necessários

Parâmetro	Tipo	Descrição
--Imagem	String	Especifica o caminho para a imagem a ser carregada.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-t, --locatário	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar a ID do locatário ou o nome do locatário.
--Temporário	Boolean	Marca o pacote de imagem como temporário. Esse parâmetro destina-se a ser usado durante o processo de fabricação.
--Força	Boolean	Força o carregamento de imagens usando uma API Beta.
-r, --regional-data-boundary	String	Limite de dados regional para essa imagem. Valores permitidos: EU, None. O valor padrão é None. Se nenhum valor for especificado, o valor padrão será usado. Para obter mais informações, consulte Configurar despejos de falha – considerações de Pivacy

Parâmetros globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira Formato de saída para comandos da CLI do Azure Sphere.
--Consulta	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Nota

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

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'.

Download

Baixa uma imagem existente do locatário do Azure Sphere.

Parâmetros necessários

Parâmetro	Tipo	Descrição
-i, --image	String	Especifica a ID da imagem a ser baixada. Execute o comando azsphere image add para obter a ID da imagem.
--Destino	String	Especifica o caminho e o nome do arquivo no qual salvar a imagem. O caminho do arquivo pode ser um caminho absoluto ou relativo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-t, --locatário	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira Formato de saída para comandos da CLI do Azure Sphere.
--Consulta	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Nota

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

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

programa

Mostra detalhes de uma imagem existente do locatário do Azure Sphere.

Parâmetros necessários

Parâmetro	Tipo	Descrição
-i, --image	GUID	Especifica a ID da imagem para obter os detalhes. Execute o comando azsphere image add para obter a ID da imagem.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-t, --locatário	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira Formato de saída para comandos da CLI do Azure Sphere.
--Consulta	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Nota

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

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
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------