az sphere device
注意
此參考是 Azure CLI 的 azure-sphere 延伸模組的一部分(2.45.0 版或更高版本)。 擴充功能會在您第一次執行 az sphere device 命令時自動安裝。 深入了解擴充功能。
管理 Azure Sphere 裝置。
命令
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>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
目標裝置組的名稱。
目標產品的名稱。
選擇性參數
要針對此命令設定目標的裝置。 當未連結任何裝置或多個裝置時,這是必要的,以釐清要鎖定的裝置。 如果鏈接裝置,您可以提供裝置識別碼、IP 位址或本機 連線 標識碼。 否則,您必須只提供裝置識別碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
要針對此命令設定目標的裝置。 當未連結任何裝置或多個裝置時,這是必要的,以釐清要鎖定的裝置。 如果鏈接裝置,您可以提供裝置識別碼、IP 位址或本機 連線 標識碼。 否則,您必須只提供裝置識別碼。
要宣告裝置的裝置組名。
要宣告裝置的產品名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
將指派裝置的裝置組名。 根據預設,這是產品的「現場測試」裝置群組。
目標產品名稱。 除非同時指定裝置群組,否則裝置會指派給所選產品的預設「現場測試」裝置群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
將指派裝置的裝置組名。 根據預設,這是產品的「開發」裝置群組。
安裝在即時核心上執行的應用程式偵錯所需的驅動程式。 需要系統管理員許可權。
目標產品名稱。 除非同時指定裝置群組,否則裝置會指派給所選產品的預設「開發」裝置群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
裝置組名。
產品名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sphere device list-attached
列出所有連結的裝置。
az sphere device list-attached
範例
列出所有連結的裝置。
az sphere device list-attached
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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
選擇性參數
復原期間要套用至裝置的裝置功能映像檔名。 (路徑)。
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
包含要寫入裝置之映像套件的資料夾。 如果未指定,則會下載並使用最新的OS映像。 (路徑)。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sphere device rescan-attached
顯示連接的裝置數目。
az sphere device rescan-attached
範例
顯示連接的裝置數目。
az sphere device rescan-attached
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sphere device restart
重新啟動連結的裝置。
az sphere device restart [--device]
範例
重新啟動連結的裝置。
az sphere device restart
重新啟動指定的裝置。
az sphere device restart --device <DeviceIdValue>
選擇性參數
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sphere device show
在您的資源群組和目錄中顯示現有裝置的詳細數據。
az sphere device show --catalog
--resource-group
[--device]
範例
使用資源群組、目錄名稱和裝置標識碼來顯示裝置的詳細數據。
az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
要針對此命令設定目標的裝置。 當未連結任何裝置或多個裝置時,這是必要的,以釐清要鎖定的裝置。 如果鏈接裝置,您可以提供裝置識別碼、IP 位址或本機 連線 標識碼。 否則,您必須只提供裝置識別碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sphere device show-attached
顯示連結裝置的詳細數據。
az sphere device show-attached [--device]
範例
顯示連結裝置的詳細數據。
az sphere device show-attached
顯示指定裝置的詳細數據。
az sphere device show-attached --device <DeviceIdValue>
選擇性參數
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
裝置組名。
產品名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --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>
選擇性參數
連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sphere device unassign
從資源群組和目錄中的裝置群組取消指派裝置。
az sphere device unassign --catalog
--resource-group
[--device]
範例
使用資源群組、目錄名稱和裝置標識碼取消指派裝置。
az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
必要參數
要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>
。 來自:az sphere catalog list 的值。
Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>
來設定預設群組。 來自:az group list 的值。
選擇性參數
要針對此命令設定目標的裝置。 當未連結任何裝置或多個裝置時,這是必要的,以釐清要鎖定的裝置。 如果已連結裝置,您可以提供裝置標識碼、IP 位址或本機 連線 標識碼。 否則,您必須只提供裝置識別碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。