共用方式為

az sphere device image

  • 參考

注意

此參考是 Azure CLI 的 azure-sphere 延伸模組的一部分（2.45.0 版或更高版本）。 擴充功能會在您第一次執行 az sphere device image 命令時自動安裝。 深入了解擴充功能。

管理目錄中的映像和連結的裝置。

命令

名稱 Description 類型 狀態
az sphere device image list-installed

列出附加裝置上安裝的映像。 根據預設，只會列出應用程式。

 副檔名 GA
az sphere device image list-targeted

列出目錄中的影像。 根據預設，只會列出將在裝置更新時安裝的映像。

 副檔名 GA

az sphere device image list-installed

列出附加裝置上安裝的映像。 根據預設，只會列出應用程式。

az sphere device image list-installed [--all]
                                      [--device]

範例

僅列出安裝在連結裝置上的應用程式。

az sphere device image list-installed

列出附加裝置上安裝的所有映像。

az sphere device image list-installed --all

選擇性參數

--all

列出裝置上的所有映像;而非只使用應用程式。

預設值: False
--device -d

連接多個裝置時，要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。

值來源: az sphere device list-attached
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az sphere device image list-targeted

列出目錄中的影像。 根據預設，只會列出將在裝置更新時安裝的映像。

az sphere device image list-targeted --catalog
                                     --resource-group
                                     [--all]
                                     [--device]

範例

僅列出上傳至資源群組、目錄和裝置的應用程式。

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

列出資源群組、目錄和裝置中上傳的所有影像。

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

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

選擇性參數

--all

列出資源群組和目錄中的所有映像。

預設值: False
--device -d

要針對此命令設定目標的裝置。 當未連結任何裝置或多個裝置時，這是必要的，以釐清要鎖定的裝置。 如果鏈接裝置，您可以提供裝置識別碼、IP 位址或本機 連線 標識碼。 否則，您必須只提供裝置識別碼。

值來源: az sphere device list
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。