Изображение
Внимание
Это документация по 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
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------ ---------------------