Udostępnij za pośrednictwem

obraz

  • Artykuł

Ważne

Jest to dokumentacja usługi Azure Sphere (starsza wersja). Usługa Azure Sphere (starsza wersja) zostanie wycofana 27 września 2027 r., a użytkownicy muszą przeprowadzić migrację do usługi Azure Sphere (zintegrowanej) do tej pory. Użyj selektora wersji znajdującego się powyżej spisu treści, aby wyświetlić dokumentację usługi Azure Sphere (zintegrowaną).

Zarządza obrazami usługi Azure Sphere na dysku.

Działanie opis
add Przekazuje nowy obraz.
download Pobiera obraz.
pokazać Wyświetla informacje o określonym obrazie.

add

Przekazuje nowy obraz do dzierżawy usługi Azure Sphere.

Parametry wymagane

Parametr Type opis
--obraz String Określa ścieżkę do obrazu, który ma zostać przekazany.

Parametry opcjonalne

Parametr Type opis
-t, --tenant Identyfikator GUID lub nazwa Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy.
--tymczasowy Wartość logiczna Oznacza pakiet obrazu jako tymczasowy. Ten parametr jest przeznaczony do użycia podczas procesu produkcyjnego.
--siła Wartość logiczna Wymusza przekazywanie obrazów przy użyciu interfejsu API beta.
-r, --regional-data-boundary String Regionalna granica danych dla tego obrazu. Dozwolone wartości: EU, None. Domyślna wartość to None. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna. Aby uzyskać więcej informacji, zobacz Konfigurowanie zrzutów awaryjnych — zagadnienia dotyczące pivacy
Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr opis
--debugować Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Przykład

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

Pobiera istniejący obraz z dzierżawy usługi Azure Sphere.

Parametry wymagane

Parametr Type opis
-i, --image String Określa identyfikator obrazu do pobrania. Uruchom polecenie azsphere image add, aby uzyskać identyfikator obrazu.
--cel String Określa ścieżkę i nazwę pliku, w którym ma być zapisywany obraz. Ścieżka pliku może być ścieżką bezwzględną lub względną.

Parametry opcjonalne

Parametr Type opis
-t, --tenant Identyfikator GUID lub nazwa Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy.
Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr opis
--debugować Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Przykład

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

pokaż

Przedstawia szczegóły istniejącego obrazu z dzierżawy usługi Azure Sphere.

Parametry wymagane

Parametr Type opis
-i, --image Identyfikator GUID Określa identyfikator obrazu, aby uzyskać szczegółowe informacje. Uruchom polecenie azsphere image add, aby uzyskać identyfikator obrazu.

Parametry opcjonalne

Parametr Type opis
-t, --tenant Identyfikator GUID lub nazwa Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy.
Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr opis
--debugować Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Przykład

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