device-group
建立及管理裝置群組。
裝置群組是以識別碼 (識別碼) 或產品名稱和裝置組名組名組合來解決。
| 操作 | 描述 |
|---|---|
| 創建 | 建立新的裝置群組。 |
| 清單 | 列出 Azure 球體租使用者中的所有裝置群組。 |
| 刪除 | 刪除現有的裝置群組。 |
| 部署 | 管理裝置群組內的部署。 |
| 裝置 | 列出裝置群組中的裝置。 |
| 顯示 | 顯示裝置群組的相關資訊。 |
| 更新 | 修改現有的裝置群組。 |
創建
建立具有指定產品指定名稱的裝置群組。 裝置群組會整理擁有相同產品的裝置，並從雲端接收相同的應用程式。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -p， --產品 | GUID 或名稱 | 指定要新增此裝置群組的產品。 您可以指定 Azure 球域產品的識別碼或名稱。 |
| -n， --name | 字串 | 指定裝置群組的名稱。 名稱只能包含英數位元。 如果名稱包含空格，請以引號括住。 裝置組名不能超過 50 個字元、不區分大小寫、在產品內必須是唯一的。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -a， --application-update | 枚舉 | 指定適用于此裝置群組的應用程式更新原則。 公認的值： No3rdPartyAppUpdates 、 UpdateAll 、和 NoUpdates 。 預設值為 UpdateAll 。 原則 NoUpdates 目前僅供內部使用。 |
| -f，--os-feed | 枚舉 | 指定作業系統更新要使用的 OS 摘要類型。 公認的值： Retail 、 . RetailEval |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
| -d， --description | 字串 | 指定描述裝置群組的選用文字。 長度上限為 100 個字元。 如果描述包含空格，請以引號括住它。 |
| -r， --regional-data-boundary | 字串 | 此影像的地區資料邊界。 允許的值： EU 、 . None 預設值為 None 。 如果沒有指定值，將會使用預設值。 如需詳細資訊，請參閱 設定損毀傾印 - Pivacy 考慮 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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 球體租使用者中的所有裝置群組。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
刪除
刪除 Azure 球體租使用者中指定的裝置群組。
裝置群組只能在下列時機刪除：
- 使用者擁有租使用者的系統管理員許可權。
- 裝置群組是空的，其中沒有裝置。 azsphere 裝置群組裝置清單命令會列出裝置群組中的所有裝置。 執行 azsphere 裝置更新 -- 裝置群組 ，將裝置移至不同的裝置群組。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | 字串 | 指定要刪除的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
部署
管理裝置群組的部署。
| 操作 | 描述 |
|---|---|
| 創建 | 為指定的裝置群組建立新的部署。 |
| 清單 | 顯示裝置群組的部署。 |
部署建立
為含有所提供影像的裝置群組建立新的部署。
您可以透過識別碼 (識別碼) 或產品名稱和裝置組名組合來識別裝置群組。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | 字串 | 指定要在其中建立部署的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
| -i， --影像 | 字串 | 指定要在部署中包含一或多個影像的圖像識別碼。 您可以新增其他參數來新增多個影像，或在空格分隔清單中的單一參數中合併多個圖像識別碼。 執行 azsphere 影像新增 命令以取得影像識別碼。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
參數會 --device-group 識別裝置群組。 裝置群組識別碼會提供 GUID，可在所有產品間唯一識別裝置群組。 或者，您可以使用產品名稱和裝置組名組合的產品 < 名稱 > / < 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 | 字串 | 指定要顯示部署歷程記錄清單的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
裝置
管理裝置群組的裝置。
| 操作 | 描述 |
|---|---|
| 清單 | 顯示裝置群組中的裝置。 |
| show-count | 顯示裝置群組中的裝置數量。 |
裝置清單
顯示裝置群組中的裝置。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | 字串 | 指定要顯示裝置清單的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
裝置顯示計數
顯示裝置群組中的裝置數量。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | 字串 | 指定要顯示裝置計數的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
------
顯示
傳回裝置群組的相關資訊。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | 字串 | 指定要顯示詳細資料的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
更新
更新以識別碼或產品名稱和裝置組名組名組識別的現有裝置群組。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | 字串 | 指定要更新詳細資料的裝置群組。您可以指定裝置群組識別碼或裝置組名。 若要使用裝置組名，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -c， --allow-crash-dumps-collection | 字串 | 設定同意 Microsoft 針對裝置群組收集損毀傾印。 預設值為 Off 。 允許的值： Off 和 On 。 使用參數 --regional-data-boundary 指定損毀傾印檔案的儲存位置。 如需詳細資訊，請參閱 設定損毀傾印。 |
| -a， --application-update | ApplicationUpdatePolicyType | 指定裝置群組的應用程式更新原則。 允許的值： No3rdPartyAppUpdates 、 UpdateAll 、和 NoUpdates 。 預設值為 UpdateAll 。 原則 NoUpdates 目前僅供內部使用。 |
| -d， --new-description | 字串 | 指定描述裝置群組的選擇性文字。 長度上限為 100 個字元。 |
| -n，--new-name | 字串 | 指定裝置群組的新名稱。 名稱只能包含英數位元。 如果名稱包含空格，請以引號括住。 裝置組名不能超過 50 個字元、不區分大小寫，而且在產品內必須是唯一的。 |
| -f，--os-feed | 字串 | 指定裝置群組的作業系統摘要。 可能的值是和 RetailRetailEval 。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
| -r， --regional-data-boundary | 字串 | 此影像的地區資料邊界。 允許的值： EU 、 . None 預設值為 None 。 如果沒有指定值，將會使用預設值。 如需詳細資訊，請參閱 設定損毀傾印 - Pivacy 考慮 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------