管理裝置群組
重要
這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。
本主題說明如何使用 CLI 或 Azure Sphere Explorer 來管理裝置群組。 本主題中的步驟假設您已熟悉 Azure Sphere 租使用者、產品和裝置群組的概念。
列出裝置群組
使用 azsphere device-group list 命令或使用 [裝置群組 - 列表 API] 列出 Azure Sphere 租使用者中的所有裝置群組。
若要列出所有裝置群組：
azsphere device-group list
使用 azsphere product device-group list 命令或使用 Product - List Groups API，列出特定產品中的裝置群組。
azsphere product device-group list --product <product-name>
針對您感興趣的租用戶展開 [租使用者] 節點。
針對您感興趣的租用戶展開 [租使用者] 節點。
建立裝置群組
使用 azsphere device-group create 命令或使用裝置群組 - 建立 API 建立裝置群組。
若要建立裝置群組：
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
裝置群組的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果名稱或描述包含空格，請以引弧括住它。
您可以包含下列選擇性參數：
--os-feed指定要用於 OS 更新的 OS 摘要類型。--application-update設定此裝置群組的應用程式更新原則。
針對您感興趣的租用戶，展開 [產品] 節點。
針對您感興趣的產品，以滑鼠右鍵按下並選取 [ 新增裝置群組]。
指定裝置群組的名稱，然後按 Enter。 裝置群組的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果您指定了無效的名稱，則會在 [ 輸出 ] 視窗中回報錯誤。
您可以在 Visual Studio Code 中建立裝置群組，但無法將其刪除。 若要刪除裝置群組，請使用 azsphere device-group delete 命令或 Azure Sphere 公用 API。
針對您感興趣的租用戶，展開 [產品] 節點。
針對您感興趣的產品，以滑鼠右鍵按下並選取 [ 新增裝置群組]。
指定裝置群組的名稱，然後按 Enter 或按兩下 [ 套用]。 裝置群組的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果您指定了無效的名稱，則會在 [ 輸出 ] 視窗中回報錯誤。
您可以在 Visual Studio 中建立裝置群組，但無法將其刪除。 若要刪除產品，請使用 azsphere device-group delete 命令或 Azure Sphere 公用 API。
更新裝置群組
您可以使用 azsphere device-group update 命令或使用裝置群組 - 修補程式 API 來修改裝置群組的名稱或描述。
若要更新裝置群組的名稱和描述：
azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>
您也可以使用 azsphere device-group update 命令來更新 os-feed 和 application-update 參數。
針對您感興趣的租用戶，展開 [產品] 節點。
針對您感興趣的產品，展開產品節點以顯示其包含的裝置群組。 您可以重新命名裝置群組或更新其描述、OS 摘要類型或更新原則：
若要重新命名裝置群組，請以滑鼠右鍵按兩下裝置組名，然後選取 [重新命名]，輸入新的名稱，然後按 Enter。 裝置群組的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果您指定了無效的名稱，則會在 [ 輸出 ] 視窗中回報錯誤。
若要更新裝置群組的描述，請以滑鼠右鍵按兩下裝置組名，然後選取 [更新描述]，輸入新的描述，然後按 Enter。
若要更新 OS 摘要類型，請展開裝置群組，以滑鼠右鍵按兩下 [OS 摘要類型]，選取 [更新]，然後從功能表中選擇 [零售] 或 [RetailEval]。
若要變更更新原則，請展開裝置群組，以滑鼠右鍵按兩下 [更新原則]，選取 [更新]，然後從功能表中選擇 [No3RdPartyAppUpdates] 或 [UpdateAll]。 （第三個選項， NoUpdates 目前保留供內部使用。如果您選擇此選項，則會在 [ 輸出 ] 視窗中回報錯誤。
使用 azsphere device update 命令或使用裝置 - 移動 API，將裝置移至不同的裝置群組。
針對您感興趣的租用戶，展開 [產品] 節點。
針對您感興趣的產品，展開產品節點以顯示其包含的裝置群組。 您可以重新命名裝置群組或更新其描述、OS 摘要類型或更新原則：
若要重新命名裝置群組，請選取裝置組名，然後按 F2 或以滑鼠右鍵按兩下裝置群組名，然後選取 [重新命名]、輸入新名稱，然後按 Enter 或按兩下 [ 套用]。 裝置群組的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果您指定了無效的名稱，則會在 [ 輸出 ] 視窗中回報錯誤。
若要更新裝置群組的描述，請展開裝置群組，選取 [描述]，然後按 F2 或以滑鼠右鍵按兩下 [描述]，然後選取 [修改]，輸入新的描述，然後按 Enter 或按兩下 [套用]。
若要更新 OS 摘要類型，請展開裝置群組，選取 [OS 摘要類型]，然後按 F2 或以滑鼠右鍵按兩下 [OS 摘要類型]，然後從功能表中選取 [修改]，選擇 [零售] 或 [RetailEval]，然後按 Enter 或單擊 [套用]。
若要變更更新原則，請展開裝置群組，選取 [更新原則 ]，然後按 F2 或以滑鼠右鍵單擊 [更新 原則]，然後選取 [修改]，從功能表中選擇 [No3RdPartyAppUpdates ] 或 [UpdateAll ]，然後按 Enter 或單擊 [ 套用]。 （第三個選項， NoUpdates 目前保留供內部使用。如果您選擇此選項，則會在 [ 輸出 ] 視窗中回報錯誤。
使用 azsphere device update 命令或使用裝置 - 移動 API，將裝置移至不同的裝置群組。
將裝置移至不同的裝置群組
使用 azsphere device update 命令或使用裝置 - 移動 API，將裝置移至不同的裝置群組。
以 product-name>/<device-group-name 格式指定裝置群組標識符或產品名稱和裝置組名<>的組合：
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
刪除裝置群組
使用 azsphere device-group delete 命令或使用裝置群組 - 刪除 API，在 Azure Sphere 租使用者中刪除指定的裝置群組。
只有在下列情況下，才能刪除裝置群組：
- 使用者具有租用戶的系統管理員許可權。
- 裝置群組是空的，且其中沒有裝置。 azsphere device-group device list 命令會列出裝置群組中的所有裝置。 執行 azsphere device update --device-group ，將裝置移至不同的裝置群組。
以 product-name>/<device-group-name 格式指定裝置群組標識符或產品名稱和裝置組名<>的組合：
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>