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.
--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 -r Name of the Azure resource group. You can configure the default group using az config set defaults.group=<name>. Values from: az group list.

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

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 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
--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 -r 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 image list-targeted --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

List all images uploaded in a resource group, catalog, and device.

az sphere image list-targeted --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue> --all