image

Důležité

Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.

Spravuje image Azure Sphere na disku.

Operation	Popis
add	Nahraje nový obrázek.
download	Stáhne obrázek.
ukázat	Zobrazí informace o zadaném obrázku.

add

Nahraje novou image do tenanta Azure Sphere.

Povinné parametry

Parametr	Typ	Popis
--obraz	String	Určuje cestu k obrázku, který se má nahrát.

Volitelné parametry

Parametr	Typ	Popis
-t, --tenant	IDENTIFIKÁTOR GUID nebo název	Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta.
--dočasný	Logická hodnota	Označí balíček image jako dočasný. Tento parametr je určen k použití během výrobního procesu.
--síla	Logická hodnota	Vynutí nahrávání obrázků pomocí rozhraní API beta verze.
-r, --regional-data-boundary	String	Hranice místních dat pro tento obrázek. Povolené hodnoty: EU, None. Výchozí hodnota je None. Pokud není zadaná žádná hodnota, použije se výchozí hodnota. Další informace najdete v tématu Konfigurace výpisů stavu systému – Aspekty pivacy

Globální parametry

Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:

Parametr	Popis
--ladicí	Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug.
-h, --help	Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů.
--only-show-errors	Zobrazuje pouze chyby a potlačuje upozornění.
-o, --output	Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere.
--dotaz	Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI.
--užvaněný	Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug.

Poznámka:

Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .

Příklad

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

Stáhne existující image z tenanta Azure Sphere.

Povinné parametry

Parametr	Typ	Popis
-i, --image	String	Určuje ID image ke stažení. Spuštěním příkazu azsphere image add získejte ID image.
--cíl	String	Určuje cestu a název souboru, do kterého se má obrázek uložit. Cesta k souboru může být absolutní nebo relativní cesta.

Volitelné parametry

Parametr	Typ	Popis
-t, --tenant	IDENTIFIKÁTOR GUID nebo název	Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta.

Globální parametry

Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:

Parametr	Popis
--ladicí	Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug.
-h, --help	Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů.
--only-show-errors	Zobrazuje pouze chyby a potlačuje upozornění.
-o, --output	Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere.
--dotaz	Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI.
--užvaněný	Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug.

Poznámka:

Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .

Příklad

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

zobrazit

Zobrazuje podrobnosti o existující imagi z tenanta Azure Sphere.

Povinné parametry

Parametr	Typ	Popis
-i, --image	Identifikátor GUID	Určuje ID obrázku pro získání podrobností. Spuštěním příkazu azsphere image add získejte ID image.

Volitelné parametry

Parametr	Typ	Popis
-t, --tenant	IDENTIFIKÁTOR GUID nebo název	Určuje tenanta, ve které se má tato operace provést. Přepíše výchozího vybraného tenanta. Můžete zadat BUĎ ID tenanta, nebo název tenanta.

Globální parametry

Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:

Parametr	Popis
--ladicí	Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug.
-h, --help	Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů.
--only-show-errors	Zobrazuje pouze chyby a potlačuje upozornění.
-o, --output	Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere.
--dotaz	Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI.
--užvaněný	Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug.

Poznámka:

Pokud používáte Azure Sphere Classic CLI, další informace o dostupných možnostech najdete v tématu Globální parametry .

Příklad

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