device-group
重要
這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。
建立和管理裝置群組。
裝置群組會依標識碼（標識符）或產品名稱和裝置組名配對來尋址。
| 作業 | 描述 |
|---|---|
| create | 建立新的裝置群組。 |
| 清單 | 列出 Azure Sphere 租使用者中的所有裝置群組。 |
| delete | 刪除現有的裝置群組。 |
| 部署 | 管理裝置群組內的部署。 |
| 裝置 | 列出裝置群組中的裝置。 |
| show | 顯示裝置群組的相關信息。 |
| update | 修改現有的裝置群組。 |
create
建立具有指定產品之指定名稱的裝置群組。 裝置群組會組織具有相同產品的裝置，並從雲端接收相同的應用程式。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -p、 --product | GUID 或名稱 | 指定要新增此裝置群組的產品。 您可以指定 Azure Sphere 產品的識別碼或名稱。 |
| -n, --name | String | 指定裝置群組的名稱。 名稱只能包含英數位元。 如果名稱包含空格，請以引號括住它。 裝置組名不能超過 50 個字元，不區分大小寫，在產品內必須是唯一的。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -a， --application-update | 列舉 | 指定要套用至此裝置群組的應用程式更新原則。 接受的值： No3rdPartyAppUpdates、 UpdateAll與 NoUpdates。 預設值為 UpdateAll。 此 NoUpdates 原則目前僅保留供內部使用。 |
| -f、 --os-feed | 列舉 | 指定要用於 OS 更新的 OS 摘要類型。 接受的值： Retail、 RetailEval。 |
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
| -d， --description | String | 指定要描述裝置群組的選擇性文字。 最大長度為 100 個字元。 如果描述包含空格，請以引號括住它。 |
| -r， --regional-data-boundary | String | 此映像的區域數據界限。 允許的值： EU、 None。 預設值是 None。 如果未指定任何值，則會使用預設值。 如需詳細資訊，請參閱 設定損毀傾印 - Pivacy 考慮 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
azsphere device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
清單
列出 Azure Sphere 租使用者中的所有裝置群組。
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
delete
刪除 Azure Sphere 租使用者中的指定裝置群組。
只有在下列情況下，才能刪除裝置群組：
- 使用者具有租用戶的系統管理員許可權。
- 裝置群組是空的，且其中沒有裝置。 azsphere device-group device list 命令會列出裝置群組中的所有裝置。 執行 azsphere device update --device-group ，將裝置移至不同的裝置群組。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要刪除的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
部署
管理裝置群組的部署。
| 作業 | 描述 |
|---|---|
| create | 為指定的裝置群組建立新的部署。 |
| 清單 | 顯示裝置群組的部署。 |
部署建立
使用提供的映像，為裝置群組建立新的部署。
您可以透過識別碼（ID）或產品名稱和裝置組名組來識別裝置群組。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要在其中建立部署的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
| -i， --images | String | 指定要包含在部署中的一或多個映像的映像標識碼。 您可以藉由新增其他參數來新增多個影像，或多個影像標識元可以在以空格分隔清單的單一參數中合併。 執行 azsphere image add 命令以取得映像標識碼。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
參數 --device-group 會識別裝置群組。 裝置群組標識碼提供 GUID，可唯一識別所有產品的裝置群組。 或者，您可以使用 product-name>/device-group-name 格式的<產品名稱和裝置組名組名><組。 這組名稱可唯一識別特定產品的裝置群組。
依識別子指定裝置群組的範例：
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
依名稱指定裝置群組的範例：
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
藉由提供以空格分隔的值清單來指定多個影像識別碼的範例：
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
您應該會看到如下的輸出：
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
部署清單
顯示裝置群組的部署歷程記錄。 傳回已包含映像的部署標識碼、時間戳和清單。 清單會依最新的部署排序。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要顯示部署歷程記錄清單的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
依識別子指定裝置群組的範例：
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
依名稱指定裝置群組的範例：
azsphere device-group deployment list --device-group DW100/Development
您應該會看到如下的輸出：
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
管理裝置群組的裝置。
| 作業 | 描述 |
|---|---|
| list | 顯示裝置群組中的裝置。 |
| show-count | 顯示裝置群組中的裝置數目。 |
裝置清單
顯示裝置群組中的裝置。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要顯示裝置清單的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
依識別子指定裝置群組的範例：
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
依名稱指定裝置群組的範例：
azsphere device-group device list --device-group DW100/Marketing
您應該會看到如下的輸出：
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
裝置 show-count
顯示裝置群組中的裝置數目。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要顯示裝置計數的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
依識別子指定裝置群組的範例：
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
依名稱指定裝置群組的範例：
azsphere device-group device show-count --device-group DW100/Marketing
您應該會看到如下的輸出：
------
Result
======
1
------
show
傳回裝置群組的相關信息。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要顯示詳細資料的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
依識別子指定裝置群組的範例：
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
依名稱指定裝置群組的範例：
azsphere device-group show --device-group DW100/Marketing
您應該會看到如下的輸出：
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
update
更新現有的裝置群組，由標識碼或產品名稱和裝置組名組識別。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g、 --device-group | String | 指定要更新詳細資料的裝置群組。您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以 格式提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -c， --allow-crash-dumps-collection | String | 設定裝置群組Microsoft收集損毀傾印的同意。 預設值為 Off。 允許的值： Off 和 On。 --regional-data-boundary使用 參數來指定應該儲存損毀傾印檔案的位置。 如需詳細資訊，請參閱 設定損毀傾印。 |
| -a， --application-update | ApplicationUpdatePolicyType | 指定裝置群組的應用程式更新原則。 允許值：No3rdPartyAppUpdates、UpdateAll 及 NoUpdates。 預設值為 UpdateAll。 此 NoUpdates 原則目前僅保留供內部使用。 |
| -d， --new-description | String | 指定要描述裝置群組的選擇性文字。 最大長度為 100 個字元。 |
| -n， --new-name | String | 指定裝置群組的新名稱。 名稱只能包含英數位元。 如果名稱包含空格，請以引號括住它。 裝置組名不能超過 50 個字元，不區分大小寫，而且在產品內必須是唯一的。 |
| -f、 --os-feed | String | 指定裝置群組的作業系統摘要。 可能的值是 Retail 和 RetailEval。 |
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
| -r， --regional-data-boundary | String | 此映像的區域數據界限。 允許的值： EU、 None。 預設值是 None。 如果未指定任何值，則會使用預設值。 如需詳細資訊，請參閱 設定損毀傾印 - Pivacy 考慮 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
依識別子指定裝置群組的範例：
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
依名稱指定裝置群組的範例：
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
您應該會看到如下的輸出：
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------