共用方式為


az sphere device

注意

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

管理 Azure Sphere 裝置。

命令

名稱 Description 類型 狀態
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 device assign

將裝置指派給資源群組和目錄中的裝置群組。

az sphere device assign --catalog
                        --resource-group
                        --target-device-group
                        --target-product
                        [--device]

範例

使用資源群組、目錄名稱、目標產品名稱、目標裝置組名和裝置標識碼來指派裝置。

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

必要參數

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

--target-device-group

目標裝置組的名稱。

值來源: az sphere device-group list
--target-product

目標產品的名稱。

值來源: az sphere product list

選擇性參數

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

az sphere device claim

在您的資源群組和目錄中宣告裝置。

az sphere device claim --catalog
                       --resource-group
                       [--device]
                       [--device-group]
                       [--product]

範例

使用資源群組、目錄名稱和裝置標識碼來宣告裝置。

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

使用資源群組、目錄名稱、產品名稱、裝置組名和裝置標識碼來宣告裝置。

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

必要參數

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

選擇性參數

--device -d

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

值來源: az sphere device list
--device-group -dg

要宣告裝置的裝置組名。

預設值: .default
值來源: az sphere device-group list
--product -p

要宣告裝置的產品名稱。

預設值: .default
值來源: az sphere product 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 device enable-cloud-test

藉由停用連結裝置上的開發和偵錯,並將它指派給可啟用雲端應用程式更新的裝置群組,以啟用裝置載入雲端。 根據預設,這會是裝置產品的現場測試裝置群組,但可以指定其他裝置群組。 不適用於製造案例:如需詳細資訊,請參閱 https://aka.ms/AzureSphereManufacturing

az sphere device enable-cloud-test --catalog
                                   --resource-group
                                   [--device]
                                   [--device-group]
                                   [--product]

範例

啟用裝置以使用資源群組、目錄名稱、裝置標識碼和預設的「現場測試」裝置群組來測試雲端。

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

啟用裝置以使用資源群組、目錄名稱、產品名稱、裝置組名和裝置標識碼來測試雲端。

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

必要參數

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

選擇性參數

--device -d

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

值來源: az sphere device list-attached
--device-group -dg

將指派裝置的裝置組名。 根據預設,這是產品的「現場測試」裝置群組。

值來源: az sphere device-group list
--product -p

目標產品名稱。 除非同時指定裝置群組,否則裝置會指派給所選產品的預設「現場測試」裝置群組。

值來源: az sphere product 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 device enable-development

啟用裝置以進行開發,方法是在連結的裝置上啟用側載和偵錯,並將它指派給停用雲端應用程式更新的裝置群組。 根據預設,這會是裝置產品的開發裝置群組,但可以指定其他裝置群組。 不適用於製造案例:如需詳細資訊,請參閱 https://aka.ms/AzureSphereManufacturing

az sphere device enable-development --catalog
                                    --resource-group
                                    [--device]
                                    [--device-group]
                                    [--enable-rt-core-debugging]
                                    [--product]

範例

使用資源群組、目錄名稱、裝置標識碼和預設的「開發」裝置群組,啟用裝置以進行開發。

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

使用資源群組、目錄名稱、產品名稱、裝置組名和裝置標識符,啟用裝置以進行開發。

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

必要參數

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

選擇性參數

--device -d

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

值來源: az sphere device list-attached
--device-group -dg

將指派裝置的裝置組名。 根據預設,這是產品的「開發」裝置群組。

值來源: az sphere device-group list
--enable-rt-core-debugging -r

安裝在即時核心上執行的應用程式偵錯所需的驅動程式。 需要系統管理員許可權。

預設值: False
--product -p

目標產品名稱。 除非同時指定裝置群組,否則裝置會指派給所選產品的預設「開發」裝置群組。

值來源: az sphere product 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 device list

列出目錄、產品或裝置群組中的所有裝置。

az sphere device list --catalog
                      --resource-group
                      [--device-group]
                      [--product]

範例

列出資源群組和目錄中的所有裝置。

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

列出資源群組、目錄和產品中的所有裝置。

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

列出資源群組、目錄、產品和裝置群組中的所有裝置。

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

必要參數

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

選擇性參數

--device-group -dg

裝置組名。

值來源: az sphere device-group list
--product -p

產品名稱。

值來源: az sphere product 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 device list-attached

列出所有連結的裝置。

az sphere device list-attached

範例

列出所有連結的裝置。

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 recover

使用復原模式將新的韌體載入連結的裝置上。

az sphere device recover [--capability]
                         [--device]
                         [--images]

範例

復原連結的裝置。

az sphere device recover

復原具有特定功能和映像的附加裝置。

az sphere device recover --capability myCapability.cap --images myImagesFolder

選擇性參數

--capability

復原期間要套用至裝置的裝置功能映像檔名。 (路徑)。

--device -d

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

值來源: az sphere device list-attached
--images

包含要寫入裝置之映像套件的資料夾。 如果未指定,則會下載並使用最新的OS映像。 (路徑)。

全域參數
--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 rescan-attached

顯示連接的裝置數目。

az sphere device rescan-attached

範例

顯示連接的裝置數目。

az sphere device rescan-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 restart

重新啟動連結的裝置。

az sphere device restart [--device]

範例

重新啟動連結的裝置。

az sphere device restart

重新啟動指定的裝置。

az sphere device restart --device <DeviceIdValue>

選擇性參數

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

在您的資源群組和目錄中顯示現有裝置的詳細數據。

az sphere device show --catalog
                      --resource-group
                      [--device]

範例

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

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

必要參數

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

選擇性參數

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

az sphere device show-attached

顯示連結裝置的詳細數據。

az sphere device show-attached [--device]

範例

顯示連結裝置的詳細數據。

az sphere device show-attached

顯示指定裝置的詳細數據。

az sphere device show-attached --device <DeviceIdValue>

選擇性參數

--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 show-count

在您的類別目錄、產品或裝置群組中顯示裝置數目。

az sphere device show-count --catalog
                            --resource-group
                            [--device-group]
                            [--product]

範例

顯示資源群組和目錄中的裝置數目。

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog

顯示資源群組、目錄和產品中的裝置數目。

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

顯示資源群組、目錄、產品和裝置群組中的裝置數目。

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

必要參數

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

選擇性參數

--device-group -dg

裝置組名。

值來源: az sphere device-group list
--product -p

產品名稱。

值來源: az sphere product 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 device show-deployment-status

顯示裝置上作業系統的部署狀態。

az sphere device show-deployment-status --catalog
                                        --resource-group
                                        [--device]

範例

使用資源群組、目錄名稱和裝置標識碼顯示操作系統的部署狀態。

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

必要參數

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

選擇性參數

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

在連接的裝置上顯示作業系統版本。

az sphere device show-os-version [--device]

範例

在連接的裝置上顯示作業系統版本。

az sphere device show-os-version

在指定的裝置上顯示作業系統版本。

az sphere device show-os-version --device <DeviceIdValue>

選擇性參數

--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 unassign

從資源群組和目錄中的裝置群組取消指派裝置。

az sphere device unassign --catalog
                          --resource-group
                          [--device]

範例

使用資源群組、目錄名稱和裝置標識碼取消指派裝置。

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

必要參數

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

選擇性參數

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