管理產品
重要
這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。
產品會識別已併入連線裝置以執行特定功能的 Azure Sphere MCU。 身為製造商，您可以為每個連接的裝置型號建立產品，例如洗碗機或咖啡機。 例如，Contoso 會為其 DW100 洗碗機建立產品，並在製造期間將此產品指派給每個 DW100 洗碗機。 每個產品都有租使用者內唯一且無法變更的 GUID。
每個連線的裝置都有單一產品，但單一產品可以與許多裝置相關聯。 每個產品的名稱在其租用戶中必須是唯一的，以及描述。 產品名稱和描述提供人類可讀的方式，以區分一個產品與另一個產品。 您可以視需要修改產品的名稱和描述。
列出產品
使用 azsphere product list 命令或使用 Azure Sphere 公用 API 列出 Azure Sphere 租使用者中的所有產品。
列出所有產品：
azsphere product list
如果未選取預設租使用者，可能會顯示訊息。 從清單中選取必要的租用戶，然後重試命令。
若要列出 Azure Sphere 租使用者中的所有產品：
在 Visual Studio Code 的活動列中選取 Azure Sphere Explorer 圖示，以開啟 Azure Sphere Explorer。 如果 [租使用者] 窗格顯示 [登入以查看租使用者]，請登入 Azure Sphere，然後選取 [ 重新 整理] 以查看可用的租使用者。
展開您感興趣的租使用者。
展開產品節點。
建立產品
使用 azsphere product create 命令或使用 Azure Sphere 公用 API，在 Azure Sphere 租使用者中建立產品。
若要建立產品：
azsphere product create --name <product-name>
將產品名稱>取代<為您產品的人類可讀取名稱，例如 DW100。 產品的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果名稱或描述包含空格，請以引弧括住它。
根據預設，當您建立新產品時，Azure Sphere 會自動建立五個裝置群組以用於建立部署。 五個預設裝置群組為開發、現場測試、生產、現場測試OS評估，以及生產作業系統評估。 若要在沒有預設裝置群組的情況下建立產品，請使用 命令：
azsphere product create --name <product-name> --no-default-device-groups
租使用者可能包含許多產品，因此提供每個產品的描述可能很有用。 您可以將描述新增至產品，如下所示：
azsphere product create --name <product-name> --description <product-description>
若要建立產品：
針對您感興趣的租使用者，以滑鼠右鍵按兩下 [產品] 節點，然後選取 [ 新產品]。
指定產品的名稱，然後按 Enter。 產品的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果您指定了無效的名稱，則會在 [ 輸出 ] 視窗中回報錯誤。
當您在 Azure Sphere Explorer 中建立產品時，會自動建立五個預設裝置群組。 如果您想要建立不含裝置群組的產品，請使用 azsphere product create 命令或 Azure Sphere 公用 API 並指定 --no-default-device-groups。
您可以在 Azure Sphere Explorer 中建立產品，但無法將其刪除。 若要刪除產品，請使用 azsphere product delete 命令或 Azure Sphere 公用 API。
若要建立產品：
針對您感興趣的租使用者，以滑鼠右鍵按兩下 [產品] 節點，然後選取 [ 新產品]。
指定產品的名稱，然後按 Enter 或按兩下 [ 套用]。 產品的名稱只能包含英數位元和空格。 它們不能超過 50 個字元。 如果您指定了無效的名稱，則會在 [ 輸出 ] 視窗中回報錯誤。
當您在 Azure Sphere Explorer 中建立產品時，會自動建立五個預設裝置群組。 如果您想要建立不含裝置群組的產品，請使用 azsphere product create 命令或 Azure Sphere 公用 API 並指定 --no-default-device-groups。
您可以在 Azure Sphere Explorer 中建立產品，但無法將其刪除。 若要刪除產品，請使用 azsphere product delete 命令或 Azure Sphere 公用 API。
更新產品
使用 azsphere product update 命令或使用 Azure Sphere 公用 API 隨時修改產品的名稱或描述。 若要更新產品的名稱和描述：
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
刪除產品
使用 azsphere product delete 命令或使用 Azure Sphere 公用 API 隨時刪除產品。
只有在下列情況下，才能刪除產品：
- 使用者具有租用戶的系統管理員許可權。
- 產品是空的，裝置群組中沒有任何裝置。 azsphere product device list 命令會列出產品中的所有裝置。 執行 azsphere device update --device-group 將裝置移至不同的 device-group 或 azsphere device-group delete 以刪除裝置群組。
若要刪除產品：
azsphere product delete --product <product-name>
針對您感興趣的租用戶，展開 [產品] 節點。
若要重新命名產品，請以滑鼠右鍵按下產品名稱，然後選取 [重新命名]，指定新的產品名稱，然後按 Enter。
若要更新描述，請以滑鼠右鍵按下產品名稱，然後選取 [更新描述]、指定新的描述，然後按 Enter。
針對您感興趣的租用戶，展開 [產品] 節點。
若要重新命名產品，請選取產品名稱，然後按 F2 或以滑鼠右鍵按兩下產品名稱，然後選取 [重新命名]、指定新的產品名稱，然後按 Enter 或按兩下 [套用]。
若要更新描述，請展開產品，選取 [描述]，然後按 F2 或以滑鼠右鍵按兩下 [描述]，然後選取 [修改]、指定新的描述，然後按 Enter 或按兩下 [套用]。
顯示產品詳細數據
使用 azsphere product show 命令或使用 Azure Sphere 公用 API，檢視租使用者中產品的詳細數據。
azsphere product show --product <product-name>
若要檢視租用戶中產品的詳細數據：
在 Visual Studio Code 的活動列中選取 Azure Sphere Explorer 圖示，以開啟 Azure Sphere Explorer。 如果 [租使用者] 窗格顯示 [登入以查看租使用者]，請登入 Azure Sphere，然後選取 [ 重新 整理] 以查看可用的租使用者。
針對您感興趣的租用戶，展開 [產品] 節點。
展開您感興趣的產品。