az sphere

注意

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

管理 Azure Sphere 資源。

命令

名稱	Description	類型	狀態
az sphere ca-certificate	管理資源群組和目錄中的憑證。	副檔名	GA
az sphere ca-certificate download	下載目錄的憑證。	副檔名	GA
az sphere ca-certificate download-chain	將目錄的憑證鏈結下載為 PKCS#7 “.p7b” 檔案。	副檔名	GA
az sphere ca-certificate download-proof	下載目錄的擁有權證明憑證，以搭配提供的程式代碼使用。	副檔名	GA
az sphere ca-certificate list	列出資源群組和目錄中的所有憑證。	副檔名	GA
az sphere catalog	管理目錄。	副檔名	GA
az sphere catalog create	建立目錄。	副檔名	GA
az sphere catalog delete	刪除目錄。	副檔名	GA
az sphere catalog download-error-report	列出或下載所選取目錄的可用錯誤報告。	副檔名	GA
az sphere catalog list	列出資源群組或訂用帳戶中的可用目錄。	副檔名	GA
az sphere catalog show	顯示目錄的詳細數據。	副檔名	GA
az sphere deployment	管理資源群組和目錄中的部署。	副檔名	GA
az sphere deployment create	建立部署。	副檔名	GA
az sphere deployment list	列出所有部署。	副檔名	GA
az sphere deployment show	顯示部署的詳細數據。	副檔名	GA
az sphere device	管理 Azure Sphere 裝置。	副檔名	GA
az sphere device-group	管理資源群組和目錄中的裝置群組。	副檔名	GA
az sphere device-group create	建立裝置群組。	副檔名	GA
az sphere device-group create-defaults	建立以產品為目標的預設裝置群組。	副檔名	GA
az sphere device-group delete	刪除指定的裝置群組。	副檔名	GA
az sphere device-group list	列出目錄中的所有裝置群組。	副檔名	GA
az sphere device-group show	顯示裝置群組的詳細數據。	副檔名	GA
az sphere device-group update	更新裝置群組的詳細數據。	副檔名	GA
az sphere device app	管理連結裝置上的應用程式。	副檔名	GA
az sphere device app show-memory-stats	顯示連結裝置上應用程式的記憶體統計數據。	副檔名	GA
az sphere device app show-quota	顯示連結裝置上應用程式的記憶體配額和使用量。	副檔名	GA
az sphere device app show-status	顯示連結裝置上應用程式的狀態。	副檔名	GA
az sphere device app start	在連結的裝置上啟動應用程式。	副檔名	GA
az sphere device app stop	停止連結裝置上的應用程式。	副檔名	GA
az sphere device assign	將裝置指派給資源群組和目錄中的裝置群組。	副檔名	GA
az sphere device capability	管理裝置功能設定。	副檔名	GA
az sphere device capability apply	暫時在連結的裝置上套用功能會話。	副檔名	GA
az sphere device capability download	從 Azure Sphere 安全性服務下載裝置功能檔案。	副檔名	GA
az sphere device capability show-attached	顯示連結裝置的目前裝置功能設定。	副檔名	GA
az sphere device capability update	更新連結裝置的裝置功能設定。	副檔名	GA
az sphere device certificate	管理連結裝置上的憑證。	副檔名	GA
az sphere device certificate add	在連結裝置的證書存儲中新增憑證。	副檔名	GA
az sphere device certificate delete	刪除連結裝置證書存儲中的憑證。	副檔名	GA
az sphere device certificate list	列出連結裝置證書存儲中的憑證。	副檔名	GA
az sphere device certificate show	在連結裝置的證書存儲中顯示憑證的詳細數據。	副檔名	GA
az sphere device certificate show-quota	在連結裝置的證書存儲中顯示可用的可用空間。	副檔名	GA
az sphere device claim	在您的資源群組和目錄中宣告裝置。	副檔名	GA
az sphere device enable-cloud-test	藉由停用連結裝置上的開發和偵錯，並將它指派給可啟用雲端應用程式更新的裝置群組，以啟用裝置載入雲端。 根據預設，這會是裝置產品的現場測試裝置群組，但可以指定其他裝置群組。 不適用於製造案例：如需詳細資訊，請參閱 https://aka.ms/AzureSphereManufacturing 。	副檔名	GA
az sphere device enable-development	啟用裝置以進行開發，方法是在連結的裝置上啟用側載和偵錯，並將它指派給停用雲端應用程式更新的裝置群組。 根據預設，這會是裝置產品的開發裝置群組，但可以指定其他裝置群組。 不適用於製造案例：如需詳細資訊，請參閱 https://aka.ms/AzureSphereManufacturing 。	副檔名	GA
az sphere device image	管理目錄中的映像和連結的裝置。	副檔名	GA
az sphere device image list-installed	列出附加裝置上安裝的映像。 根據預設，只會列出應用程式。	副檔名	GA
az sphere device image list-targeted	列出目錄中的影像。 根據預設，只會列出將在裝置更新時安裝的映像。	副檔名	GA
az sphere device list	列出目錄、產品或裝置群組中的所有裝置。	副檔名	GA
az sphere device list-attached	列出所有連結的裝置。	副檔名	GA
az sphere device manufacturing-state	管理附加裝置的製造狀態。	副檔名	GA
az sphere device manufacturing-state show	顯示連結裝置的製造狀態。	副檔名	GA
az sphere device manufacturing-state update	更新連結裝置的製造狀態。 注意：製造狀態變更是永久性且無法復原的。	副檔名	GA
az sphere device network	提供連結裝置上網路介面狀態的相關信息。	副檔名	GA
az sphere device network disable	停用連結裝置上的網路介面。	副檔名	GA
az sphere device network enable	在連接的裝置上啟用網路介面。	副檔名	GA
az sphere device network list-firewall-rules	列出連結裝置的防火牆規則。	副檔名	GA
az sphere device network list-interfaces	列出連結裝置的網路介面。	副檔名	GA
az sphere device network proxy	管理用於網路連線的 Proxy 位址。	副檔名	GA
az sphere device network proxy apply	在連結的裝置上設定網路 Proxy。	副檔名	GA
az sphere device network proxy delete	刪除連結裝置上的 Proxy 連線。	副檔名	GA
az sphere device network proxy disable	停用連結裝置上的網路 Proxy。	副檔名	GA
az sphere device network proxy enable	在連結的裝置上啟用網路 Proxy。	副檔名	GA
az sphere device network proxy show	在連結的裝置上顯示 Proxy 連線。	副檔名	GA
az sphere device network show-diagnostics	顯示連結裝置上一或所有Wi-Fi網路的診斷。	副檔名	GA
az sphere device network show-status	顯示連結裝置的網路狀態。	副檔名	GA
az sphere device network update-interface	更新連結裝置的網路介面組態。	副檔名	GA
az sphere device recover	使用復原模式將新的韌體載入連結的裝置上。	副檔名	GA
az sphere device rescan-attached	顯示連接的裝置數目。	副檔名	GA
az sphere device restart	重新啟動連結的裝置。	副檔名	GA
az sphere device show	在您的資源群組和目錄中顯示現有裝置的詳細數據。	副檔名	GA
az sphere device show-attached	顯示連結裝置的詳細數據。	副檔名	GA
az sphere device show-count	在您的類別目錄、產品或裝置群組中顯示裝置數目。	副檔名	GA
az sphere device show-deployment-status	顯示裝置上作業系統的部署狀態。	副檔名	GA
az sphere device show-os-version	在連接的裝置上顯示作業系統版本。	副檔名	GA
az sphere device sideload	在連結的裝置上部署和管理應用程式。	副檔名	GA
az sphere device sideload delete	從連結的裝置刪除應用程式。	副檔名	GA
az sphere device sideload deploy	將應用程式部署至連結的裝置。	副檔名	GA
az sphere device sideload set-deployment-timeout	以秒為單位設定部署逾時。	副檔名	GA
az sphere device sideload show-deployment-timeout	以秒為單位顯示部署逾時。	副檔名	GA
az sphere device unassign	從資源群組和目錄中的裝置群組取消指派裝置。	副檔名	GA
az sphere device wifi	管理連結裝置的Wi-Fi組態。	副檔名	GA
az sphere device wifi add	在連結的裝置上新增Wi-Fi網路。	副檔名	GA
az sphere device wifi disable	停用連結裝置上的Wi-Fi連線。	副檔名	GA
az sphere device wifi enable	在連接的裝置上啟用Wi-Fi網路。	副檔名	GA
az sphere device wifi forget	忘記連結裝置上的Wi-Fi網路。	副檔名	GA
az sphere device wifi list	列出連結裝置目前的Wi-Fi組態。	副檔名	GA
az sphere device wifi reload-config	在連接的裝置上重載Wi-Fi網路設定。 新增或移除憑證之後，請使用此命令（azsphere device certificate），以確保 EAP-TLS 網路使用證書存儲的最新內容。	副檔名	GA
az sphere device wifi scan	掃描連結裝置可看見的可用Wi-Fi網路。	副檔名	GA
az sphere device wifi show	在連結的裝置上顯示Wi-Fi網路的詳細數據。	副檔名	GA
az sphere device wifi show-status	顯示連接裝置上無線介面的狀態。	副檔名	GA
az sphere get-support-data	收集本機系統、雲端和裝置設定的相關診斷數據。	副檔名	GA
az sphere hardware-definition	管理硬體定義。	副檔名	GA
az sphere hardware-definition generate-header	產生對應至硬體定義的 C 頭檔，並將它放在相對於輸入 JSON 的資料夾 'inc/hw' 中。	副檔名	GA
az sphere hardware-definition test-header	測試 『inc/hw' 資料夾中的 C 頭檔與輸入 JSON 有關的最新狀態。	副檔名	GA
az sphere image	管理資源群組和目錄中的映像。	副檔名	GA
az sphere image-package	管理映像套件。	副檔名	GA
az sphere image-package show	顯示指定映像套件的詳細數據。	副檔名	GA
az sphere image add	從本機計算機將映像新增至您的目錄。	副檔名	GA
az sphere image list	列出資源群組和目錄中的所有映像。	副檔名	GA
az sphere image show	顯示目錄中現有影像的詳細數據。	副檔名	GA
az sphere product	管理資源群組和目錄中的產品。	副檔名	GA
az sphere product create	在您的資源群組和目錄中建立新產品。	副檔名	GA
az sphere product delete	刪除指定的產品。	副檔名	GA
az sphere product list	列出資源群組和目錄中的所有產品。	副檔名	GA
az sphere product show	在您的資源群組和目錄中顯示產品的詳細數據。	副檔名	GA
az sphere product update	更新資源群組和目錄中的產品詳細數據。	副檔名	GA
az sphere show-sdk-version	顯示已安裝的 Azure Sphere SDK 版本。	副檔名	GA

az sphere get-support-data

收集本機系統、雲端和裝置設定的相關診斷數據。

az sphere get-support-data --catalog
                           --resource-group
                           [--output-file]

範例

針對資源群組和目錄中的裝置收集本機系統、雲端和裝置設定的相關診斷數據。

az sphere get-support-data --resource-group MyResourceGroup --catalog MyCatalog --output-file archive.zip

必要參數

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

選擇性參數

--output-file -of

要儲存支持資料之.zip檔案的路徑和檔名。 它必須具有.zip延伸模組。 您可以提供相對或絕對路徑。 如果您未指定檔名，支持資料將會儲存在目前工作目錄中名為 support_data.zip 的檔案中。 （路徑）。

全域參數

--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 show-sdk-version

顯示已安裝的 Azure Sphere SDK 版本。

az sphere show-sdk-version

範例

顯示已安裝的 Azure Sphere SDK 版本。

az sphere show-sdk-version

全域參數

--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 來取得完整偵錯記錄。