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