共用方式為

az sphere image

  • 參考

注意

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

管理資源群組和目錄中的映像。

命令

名稱 Description 類型 狀態
az sphere image add

從本機計算機將映像新增至您的目錄。

 副檔名 GA
az sphere image list

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

 副檔名 GA
az sphere image show

顯示目錄中現有影像的詳細數據。

 副檔名 GA

az sphere image add

從本機計算機將映像新增至您的目錄。

az sphere image add --catalog
                    --image-path
                    --resource-group
                    [--regional-data-boundary {EU, None}]

範例

在資源群組 「MyResourceGroup」 和目錄 「MyCatalog」 中新增映像。

az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path MyImage.imagepackage

在資源群組 「MyResourceGroup」、目錄 「MyCatalog」 和區域數據界限 「EU」 中新增映像。

az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path MyImage.imagepackage --regional-data-boundary EU

必要參數

--catalog -c

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

--image-path -img

本機映像檔的路徑。

--resource-group -g

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

選擇性參數

--regional-data-boundary -r

此映像的區域數據界限。

接受的值: EU, None
預設值: None
全域參數
--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 image list

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

az sphere image list --catalog
                     --resource-group

範例

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

az sphere image list --resource-group MyResourceGroup --catalog MyCatalog

必要參數

--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 的值。

全域參數
--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 image show

顯示目錄中現有影像的詳細數據。

az sphere image show --catalog
                     --image
                     --resource-group

範例

使用資源群組、目錄名稱和映像標識碼來顯示影像的詳細數據。

az sphere image show --resource-group MyResourceGroup --catalog MyCatalog --image adb44b96-2642-4643-8c30-5f681f466425

必要參數

--catalog -c

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

--image

映像標識碼。

值來源: az sphere image list
--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group 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 來取得完整偵錯記錄。