Изображение

Внимание

Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).

Управляет образами Azure Sphere на диске.

Операция	Description
добавление	Отправляет новый образ.
загрузить	Скачивает образ.
show	Отображает информацию о существующем наборе образов.

add

Отправляет новый образ в клиент Azure Sphere.

Обязательные параметры

Параметр	Тип	Description
--образ	Строка	Указывает путь к отправлению изображения.

Необязательные параметры

Параметр	Тип	Description
-t, --tenant	GUID или имя	Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента.
--временный	Логический	Помечает пакет образа как временный. Этот параметр предназначен для использования во время производства.
--force	Логический	Принудительно отправляет образы с помощью БЕТА-API.
-r, --regional-data-гранич	Строка	Граница региональных данных для этого изображения. Допустимые значения: EU, None. Значение по умолчанию — None. Если значение не указано, будет использоваться значение по умолчанию. Дополнительные сведения см. в разделе "Настройка аварийных дампов" — рекомендации по pivacy

Глобальные параметры

Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:

Параметр	Description
--debug	Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке.
-h, --help	Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд.
--only-show-errors	Отображает только ошибки, подавляя предупреждения.
-o, --output	Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI.
--query	Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI.
--verbose	Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки.

Пример

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

загрузить

Скачивает существующий образ из клиента Azure Sphere.

Обязательные параметры

Параметр	Тип	Description
-i, --image	Строка	Указывает идентификатор образа, который требуется скачать. Выполните команду azsphere image add, чтобы получить идентификатор образа.
--назначение	Строка	Указывает путь и имя файла, в котором изображение будет сохранено. Путь к файлу может быть абсолютным или относительным.

Необязательные параметры

Параметр	Тип	Description
-t, --tenant	GUID или имя	Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента.

Глобальные параметры

Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:

Параметр	Description
--debug	Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке.
-h, --help	Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд.
--only-show-errors	Отображает только ошибки, подавляя предупреждения.
-o, --output	Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI.
--query	Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI.
--verbose	Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки.

Пример

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

Отображает сведения о существующем образе из клиента Azure Sphere.

Обязательные параметры

Параметр	Тип	Description
-i, --image	GUID	Указывает идентификатор изображения для получения сведений. Выполните команду azsphere image add, чтобы получить идентификатор образа.

Необязательные параметры

Параметр	Тип	Description
-t, --tenant	GUID или имя	Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента.

Глобальные параметры

Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:

Параметр	Description
--debug	Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке.
-h, --help	Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд.
--only-show-errors	Отображает только ошибки, подавляя предупреждения.
-o, --output	Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI.
--query	Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI.
--verbose	Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки.

Пример

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