Compartilhar via

imagem

  • Artigo

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Gerencia imagens do Azure Sphere em disco.

Operação Descrição
add Carrega uma nova imagem.
fazer download Baixa uma imagem.
show Exibe informações sobre a imagem especificada.

adicionar

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

Parâmetros obrigató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, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
--temporário Booliano Marca o pacote de imagem como temporário. Este parâmetro destina-se ao uso durante o processo de fabricação.
--force Booliano Força o upload de imagens usando uma API Beta.
-r, --limite de dados regionais String Limite de dados regional para esta imagem. Valores Permitidos: EU e 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 memória - Considerações sobre Pivacy
Parâmetros Globais

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

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug 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 tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query 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 do comando Consultar a 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.

Observação

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

fazer download

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

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-i, --imagem 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 em que armazenar a imagem. O caminho do arquivo pode ser um caminho absoluto ou relativo.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. 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
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug 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 tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query 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 do comando Consultar a 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.

Observação

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

show

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

Parâmetros obrigatórios

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

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. 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
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug 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 tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query 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 do comando Consultar a 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.

Observação

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