az 球形裝置
管理 Azure 球體裝置。
| 操作 | 描述 |
|---|---|
| az 球形裝置重新連接 | 顯示連接的裝置數目。 |
| az 球形裝置清單附加 | 列出所有附加的裝置。 |
| az 球形裝置顯示附加 | 顯示附加裝置的詳細數據。 |
| az 球形裝置清單 | 列出目錄、產品或裝置群組中的所有裝置。 |
| az 球形裝置顯示計數 | 顯示您的目錄、產品或裝置群組中的裝置數量。 |
| az 球形裝置放映 | 在資源群組和目錄中顯示現有裝置的詳細數據。 |
| az 球形裝置指派 | 將裝置指派給資源群組和目錄中的裝置群組。 |
| az 球形裝置取消指派 | 從資源群組和目錄中的裝置群組取消指派裝置。 |
| az 球形裝置重新啟動 | 重新啟動連接的裝置。 |
| az 球體裝置索賠 | 在資源群組和目錄中宣告裝置。 |
| az 球形裝置復原 | 使用修復模式將新的韌體載入至連接的裝置上。 |
| az 球形裝置 show-os-version | 在附加的裝置上顯示操作系統版本。 |
| az 球形裝置顯示部署狀態 | 顯示裝置上作業系統的部署狀態。 |
| az 球形裝置啟用開發 | 「啟用裝置進行開發，方法是啟用附加裝置上的側載和偵錯功能，並將它指派給停用雲端應用程式更新的裝置群組。 根據預設，這會是裝置產品的開發裝置群組，但可以指定其他裝置群組。 不適用於製造案例 |
| az 球體裝置啟用雲端測試 | 「停用附加裝置上的開發與偵錯，並將它指派給可從雲端啟用應用程式更新的裝置群組，以啟用用來測試雲端載入的裝置。 根據預設，這會是裝置產品的 [字段測試裝置] 群組，但可以指定其他裝置群組。 不適用於製造案例 |
命令
az 球形裝置重新連接
顯示連接的裝置數目。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
例子
顯示連接的裝置數目。
az sphere device rescan-attached
az 球形裝置清單附加
列出所有附加的裝置。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
例子
列出所有附加的裝置。
az sphere device list-attached
az 球形裝置顯示附加
顯示附加裝置的詳細數據。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
例子
顯示附加裝置的詳細數據。
az sphere device show-attached
顯示指定裝置的詳細數據。
az sphere device show-attached --device <DeviceIdValue>
az 球形裝置清單
列出目錄、產品或裝置群組中的所有裝置。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --product -p | 產品名稱。 來自：az 球形產品清單的值 |
| --device-group -dg | 要顯示的裝置群組。 來自：az 球形裝置的值 |
例子
列出資源群組和目錄中的所有裝置。
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
az 球形裝置顯示計數
顯示您的目錄、產品或裝置群組中的裝置數量。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --product -p | 產品名稱。 來自：az 球形產品清單的值 |
| --device-group -dg | 要顯示的裝置群組。 來自：az 球形裝置的值 |
例子
顯示資源群組和目錄中的裝置數量。
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
az 球形裝置放映
在資源群組和目錄中顯示現有裝置的詳細數據。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
例子
使用資源群組、目錄名稱和裝置標識碼顯示裝置的詳細數據。
az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
az 球形裝置指派
將裝置指派給資源群組和目錄中的裝置群組。
必要參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
| --target-product | 目標產品的名稱。 來自：az 球形產品清單的值 |
| --target-device-group | 目標裝置群組的名稱。 來自：az 球形裝置的值 |
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
例子
使用資源群組、目錄名稱、目標產品名稱、目標裝置組名和裝置標識碼指派裝置。
az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>
az 球形裝置取消指派
從資源群組和目錄中的裝置群組取消指派裝置。
必要參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
例子
使用資源群組、目錄名稱和裝置標識碼取消指派裝置。
az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
az 球形裝置重新啟動
重新啟動連接的裝置。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
例子
重新啟動連接的裝置。
az sphere device restart
重新啟動指定的裝置。
az sphere device restart --device <DeviceIdValue>
az 球體裝置索賠
在資源群組和目錄中宣告裝置。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
| --product -p | 產品名稱。 來自：az 球形產品清單的值 |
| --device-group -dg | 要顯示的裝置群組。 來自：az 球形裝置的值 |
例子
使用資源群組、目錄名稱和裝置標識碼宣告裝置。
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>
az 球形裝置復原
使用修復模式將新的韌體載入至連接的裝置上。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
| --能力 | 裝置功能映像的檔名，可在復原期間套用至裝置。 (路徑) 。 |
| --圖像 | 包含要寫入裝置之圖像套件的資料夾。 如果未指定，則會下載並使用最新的操作系統影像。 (路徑) 。 |
例子
復原連接的裝置。
az sphere device recover
復原具有特定功能和影像的連接裝置。
az sphere device recover --capability myCapability.cap --images myImagesFolder
az 球形裝置 show-os-version
在附加的裝置上顯示操作系統版本。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
例子
在附加的裝置上顯示操作系統版本。
az sphere device show-os-version
在指定的裝置上顯示作業系統版本。
az sphere device show-os-version --device <DeviceIdValue>
az 球形裝置顯示部署狀態
顯示裝置上作業系統的部署狀態。
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
例子
使用資源群組、目錄名稱和裝置標識碼顯示操作系統的部署狀態。
az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
az 球形裝置啟用開發
「啟用裝置進行開發，方法是啟用附加裝置上的側載和偵錯功能，並將它指派給停用雲端應用程式更新的裝置群組。 根據預設，這會是裝置產品的開發裝置群組，但可以指定其他裝置群組。 不適用於製造案例
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
| --enable-rt-core-debugging -r | 安裝在即時核心上執行的應用程式偵錯所需的驅動程式。 需要系統管理員許可權。 |
| --product -p | 產品名稱。 來自：az 球形產品清單的值 |
| --device-group -dg | 要顯示的裝置群組。 來自：az 球形裝置的值 |
例子
使用資源群組、目錄名稱、裝置標識碼和預設的開發裝置群組啟用側載和偵錯，以啟用裝置進行開發。
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>
az 球體裝置啟用雲端測試
「停用附加裝置上的開發與偵錯，並將它指派給可從雲端啟用應用程式更新的裝置群組，以啟用用來測試雲端載入的裝置。 根據預設，這會是裝置產品的 [字段測試裝置] 群組，但可以指定其他裝置群組。 不適用於製造案例
必要參數
| 參數 | 描述 |
|---|---|
| --catalog -c | 執行此作業的 Azure 球體目錄。 指定 Azure 球體目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>設定預設的 Azure 球體目錄。 來自： az 球型目錄清單的值。 |
| --resource-group -r | Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name>設定預設群組。 來自： az 群組清單的值。 |
選用參數
| 參數 | 描述 |
|---|---|
| --device -d | 連接多個裝置時執行命令的裝置。 指定附加裝置的識別碼、IP 位址或本機連線標識碼。 來自：az 球形裝置清單的值 |
| --product -p | 產品名稱。 來自：az 球形產品清單的值 |
| --device-group -dg | 要顯示的裝置群組。 來自：az 球形裝置的值 |
例子
使用資源群組、目錄名稱、裝置標識碼和預設的 [欄位測試裝置] 群組來啟用用於測試雲端的裝置。
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>