共用方式為

管理裝置群組

  • 發行項

本主題說明如何使用 CLI 或 Azure 球體總管管理您的裝置群組。 本主題中的步驟假設您熟悉 Azure 球體 租使用者、 產品和 裝置群組的概念。

列出裝置群組

使用 azsphere 裝置群組清單 命令或使用裝置群組 - 清單 API，列出 Azure 球體租使用者中的所有 裝置群組 。

若要列出所有裝置群組：

azsphere device-group list

使用 azsphere 產品裝置群組清單 命令或使用產品 - 清單群組 API，列出特定產品中的裝置群組。

azsphere product device-group list --product <product-name>

  1. 開啟 Azure 球體總管。

  2. 展開您感興趣之租使用者的租使用者節點。

  1. 開啟 Azure 球體總管。

  2. 展開您感興趣之租使用者的租使用者節點。

若要檢視租使用者的產品和裝置群組：

  1. 開啟 Azure 球體總管。

  2. 展開您感興趣之租使用者的租使用者節點。

如果未列出任何產品，請 建立產品。

如果裝置已與產品相關聯且已指派給群組，您可以隨時 更新其裝置群組 。

若要檢視租使用者的產品和裝置群組：

  1. 開啟 Azure 球體總管。

  2. 展開您感興趣之租使用者的租使用者節點。

如果未列出任何產品，請 建立產品。

如果裝置已與產品相關聯且已指派給群組，您可以隨時 更新其裝置群組 。

建立裝置群組

使用 azsphere 裝置群組建立 命令或使用裝置 群組 - 建立 API 來建立裝置群組。

若要建立裝置群組：

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

裝置群組的名稱只能包含英數位元字元和空格。 它們不能超過 50 個字元。 如果名稱或描述包含空格，請以引號括住。

您可以包含下列選用參數：

  • --os-feed 指定要用於作業系統更新的 OS 摘要類型。
  • --application-update 設定此裝置群組的應用程式更新原則。

  1. 開啟 Azure 球體總管。

  2. 針對您感興趣的租使用者，展開產品節點。

  3. 針對您感興趣的產品，以滑鼠右鍵按一下並選取 [新增裝置群組]。

  4. 指定裝置群組的名稱，然後按 Enter。 裝置群組的名稱只能包含英數位元字元和空格。 它們不能超過 50 個字元。 如果您指定不正確名稱，則會在 [ 輸出 ] 視窗中回報錯誤。

您可以在 Visual Studio Code 中建立裝置群組，但不能刪除它。 若要刪除裝置群組，請使用 azsphere 裝置群組刪除 命令或 Azure 球體公用 API。

  1. 開啟 Azure 球體總管。

  2. 針對您感興趣的租使用者，展開產品節點。

  3. 針對您感興趣的產品，以滑鼠右鍵按一下並選取 [新增裝置群組]。

  4. 指定裝置群組的名稱，然後按 Enter 或按一下 [ 套用]。 裝置群組的名稱只能包含英數位元字元和空格。 它們不能超過 50 個字元。 如果您指定不正確名稱，則會在 [ 輸出 ] 視窗中回報錯誤。

您可以在 Visual Studio 中建立裝置群組，但無法將其刪除。 若要刪除產品，請使用 azsphere 裝置群組刪除 命令或 Azure 球體公用 API。

更新裝置群組

您可以使用 azsphere 裝置群組更新 命令或使用裝置 群組 - 修補 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 裝置群組更新命令來更新 os-feed 和 application-update 參數。

  1. 開啟 Azure 球體總管。

  2. 針對您感興趣的租使用者，展開產品節點。

  3. 針對您感興趣的產品，展開產品節點以顯示其隨附的裝置群組。 您可以重新命名裝置群組或更新其描述、作業系統摘要類型或更新原則：

  • 若要重新命名裝置群組，請以滑鼠右鍵按一下裝置組名，然後選取 [重新命名]，輸入新名稱，然後按 Enter。 裝置群組的名稱只能包含英數位元字元和空格。 它們不能超過 50 個字元。 如果您指定不正確名稱，則會在 [ 輸出 ] 視窗中回報錯誤。

  • 若要更新裝置群組的描述，請以滑鼠右鍵按一下裝置組名，然後選取 [更新描述]，輸入新的描述，然後按 Enter。

  • 若要更新 OS 摘要類型，請展開裝置群組，以滑鼠右鍵按一下 [作業系統摘要類型]，選取 [ 更新]，然後從功能表中選擇 [ 零售 ] 或 [ 零售] 。

  • 若要變更更新原則，請展開裝置群組，以滑鼠右鍵按一下 [更新原則]，選取 [ 更新]，然後從功能表中選擇 [No3rdPartyAppUpdates ] 或 [ UpdateAll ]。 (第三個選項 NoUpdates目前保留供內部使用。如果您選擇此選項，會在 [ 輸出 ] 視窗中回報錯誤 )

使用 azsphere 裝置更新 命令或使用裝置 - 移動 API，將裝置移到不同的裝置群組。

  1. 開啟 Azure 球體總管。

  2. 針對您感興趣的租使用者，展開產品節點。

  3. 針對您感興趣的產品，展開產品節點以顯示其隨附的裝置群組。 您可以重新命名裝置群組或更新其描述、作業系統摘要類型或更新原則：

  • 若要重新命名裝置群組，請選取裝置組名，然後按 F2 或以滑鼠右鍵按一下裝置組名，然後選取 [重新命名]、輸入新名稱，然後按 Enter 或按一下 [ 套用]。 裝置群組的名稱只能包含英數位元字元和空格。 它們不能超過 50 個字元。 如果您指定不正確名稱，則會在 [ 輸出 ] 視窗中回報錯誤。

  • 若要更新裝置群組的描述，請展開裝置群組，選取 [ 描述 ]，然後按 F2 或以滑鼠右鍵按一下 [ 描述 ]，然後選取 [修改]、輸入新的描述，然後按 Enter 或按一下 [ 套用]。

  • 若要更新 OS 摘要類型，請展開裝置群組，選取 [作業系統摘要類型 ]，然後按 F2 或以滑鼠右鍵按一下 [作業系統摘要類型 ]，然後選取 [修改]，從功能表中選擇 [ 零售 ] 或 [ 零售 ]，然後按 Enter 或按一下 [ 套用]。

  • 若要變更更新原則，請展開裝置群組，選取 [更新原則 ]，然後按 F2 或以滑鼠右鍵按一下 [更新原則 ]，然後選取 [修改]，從功能表中選擇 [No3rdPartyAppUpdates ] 或 [ 更新所有 ]，然後按 Enter 或按一下 [ 套用]。 (第三個選項 NoUpdates目前保留供內部使用。如果您選擇此選項，會在 [ 輸出 ] 視窗中回報錯誤) 。

使用 azsphere 裝置更新 命令或使用裝置 - 移動 API，將裝置移到不同的裝置群組。

將裝置移至不同的裝置群組

使用 azsphere 裝置更新 命令或使用裝置 - 移動 API，將裝置移到不同的裝置群組。

以產品名稱 > / < device-group-name 格式指定裝置組識別碼或產品名稱與裝置組名 <> 的組合：

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

刪除裝置群組

使用 azsphere 裝置群組刪除 命令或使用裝置群組 - 刪除 API，在 Azure 球體租使用者中刪除指定的裝置群組。

裝置群組只能在下列時機刪除：

以產品名稱 > / < device-group-name 格式指定裝置組識別碼或產品名稱與裝置組名 <> 的組合：

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>