az sphere device image
Manage images in your catalog and the attached device.
| Operation | Description |
|---|---|
| az sphere device image list-installed | List the images installed on the attached device. By default, lists only applications. |
| az sphere device image list-targeted | List images in your catalog. By default, lists only images that will be installed when the device is updated. |
Commands
az sphere device image list-installed
List the images installed on the attached device. By default, lists only applications.
Required Parameters
| Parameter | Description |
|---|---|
| --all | Lists all images on the device; rather than only applications. |
Optional Parameters
| Parameter | Description |
|---|---|
| --device -d | The device to run the command on when multiple devices are attached. Specify the ID, IP address, or Local Connection ID of an attached device. Values from: az sphere device list-attached. |
Examples
List only applications installed on the attached device.
az sphere device image list-installed
List all images installed on the attached device.
az sphere device image list-installed --all
az sphere device image list-targeted
List images in your catalog. By default, lists only images that will be installed when the device is updated.
Required Parameters
| Parameter | Description |
|---|---|
| --device -d | The device to target for this command. This is required when no device or multiple devices are attached, to disambiguate which device to target. If the device is attached, you may provide either device ID, IP address, or Local Connection ID. Otherwise you must provide the device ID only. Values from: az sphere device list. |
| --all | List all images in your resource group and catalog. |
| --catalog -c | The Azure Sphere Catalog in which to perform this operation. Specify Azure Sphere Catalog name. You can configure the default Azure Sphere Catalog using az config set defaults.sphere.catalog=<name>. Values from: az sphere catalog list. |
| --resource-group -g | Name of the Azure resource group. You can configure the default group using az config set defaults.group=<name>. Values from: az group list. |
Examples
List only applications uploaded to a resource group, catalog, and device.
az sphere device image list-targeted --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
List all images uploaded in a resource group, catalog, and device.
az sphere device image list-targeted --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue> --all