製品の管理
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。
製品 は、接続されるデバイスに組み込まれて特定の機能を実行する Azure Sphere MCU を識別します。 製造元は、食器洗い機やコーヒーメーカーなど、接続されているデバイスの各モデルに対して製品を作成します。 たとえば、Contoso は DW100 食器洗い機のために製品を作成し、製造時にこの製品をそれぞれの DW100 食器洗い機に割り当てます。 各製品は、テナント内で一意で、変更することができない GUID を持ちます。
接続されるすべてのデバイスには 1 つの製品がありますが、1 つの製品を多くのデバイスに関連付けることができます。 各製品にはテナント内で一意である必要がある名前があり、説明が付随しています。 製品名と説明は、個々の製品を区別するために人が判読できる方法となっています。 製品の名前と説明は、何度でも変更できます。
製品を一覧表示する
azsphere 製品リストコマンドを使用するか、Azure Sphere パブリック API を使用して、Azure Sphere テナント内のすべての製品を一覧表示。
すべての製品を一覧表示するには:
azsphere product list
既定のテナントが選択されていない場合は、メッセージが表示されることがあります。 一覧から必要なテナントを選択し、コマンドを再試行します。
Azure Sphere テナント内のすべての製品を一覧表示するには:
Visual Studio Code のアクティビティ バーで Azure Sphere Explorer アイコンを選択して、 Azure Sphere Explorer を開きます。 [テナント] ウィンドウに Log in と表示されてテナントが表示される場合 Azure Sphere にログインし、 Refresh を選択して使用可能なテナントを表示します。
目的のテナントを展開します。
製品ノードを展開します。
View>その他の Windows>Azure Sphere Explorer を選択して、Azure Sphere Explorer を開きます。 [テナント] ウィンドウに Log in と表示されてテナントが表示される場合 Azure Sphere にログインし、 Refresh を選択して使用可能なテナントを表示します。
目的のテナントを展開します。
製品ノードを展開します。
製品の作成
azsphere product create コマンドを使用するか、Azure Sphere Public API を使用して、Azure Sphere テナントに製品を作成します。
製品を作成するには:
azsphere product create --name <product-name>
<product-name>を、DW100 などの製品の人間が判読できる名前に置き換えます。 製品の名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 名前または説明にスペースが含まれている場合は、引用符で囲みます。
既定では、新しい製品を作成すると、デプロイの作成に使用する 5 つのデバイス グループが Azure Sphere によって自動的に作成されます。 既定の 5 つのデバイス グループは、開発、フィールド テスト、運用、フィールド テスト OS 評価、運用 OS 評価です。 既定のデバイス グループなしで製品を作成するには、次のコマンドを使用します。
azsphere product create --name <product-name> --no-default-device-groups
テナントには多数の製品が含まれている場合があり、それぞれの説明を提供すると便利です。 次のように製品に説明を追加できます。
azsphere product create --name <product-name> --description <product-description>
製品を作成するには:
Azure Sphere Explorer を開きます。
目的のテナントの [製品] ノードを右クリックし、[新しい製品] 選択。
製品の名前を指定し、 Enter キーを押します。 製品の名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、 Output ウィンドウでエラーが報告されます。
Azure Sphere Explorer で製品を作成すると、5 つの既定のデバイス グループが自動的に作成されます。 デバイス グループなしで製品を作成する場合は、 azsphere product create コマンドまたは Azure Sphere Public API を使用し、 --no-default-device-groups を指定します。
Azure Sphere Explorer で製品を作成することはできますが、削除することはできません。 製品を削除するには、 azsphere product delete コマンドまたは Azure Sphere Public API を使用します。
製品を作成するには:
Azure Sphere Explorer を開きます。
目的のテナントの [製品] ノードを右クリックし、[新しい製品] 選択。
製品の名前を指定し、 Enter キーを押すか、[ Apply] をクリック。 製品の名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、 Output ウィンドウでエラーが報告されます。
Azure Sphere Explorer で製品を作成すると、5 つの既定のデバイス グループが自動的に作成されます。 デバイス グループなしで製品を作成する場合は、 azsphere product create コマンドまたは Azure Sphere Public API を使用し、 --no-default-device-groups を指定します。
Azure Sphere Explorer で製品を作成することはできますが、削除することはできません。 製品を削除するには、 azsphere product delete コマンドまたは Azure Sphere Public API を使用します。
製品を更新する
azsphere product update コマンドを使用するか、Azure Sphere Public API を使用して、いつでも製品の名前または説明を変更します。 製品の名前と説明を更新するには:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
製品を削除する
azsphere product delete コマンドを使用するか、Azure Sphere Public API を使用して、いつでも製品を削除。
製品は、次の場合にのみ削除できます。
- ユーザーはテナントに対する管理者権限を持っています。
- 製品が空で、デバイス グループにデバイスがありません。 azsphere 製品デバイスリストコマンドは、製品内のすべてのデバイスを一覧表示します。 azsphere device update --device-group を実行してデバイスを別のデバイス グループに移動するかazsphere device-group deleteデバイス グループを削除します。
製品を削除するには:
azsphere product delete --product <product-name>
Azure Sphere Explorer を開きます。
関心のあるテナントの場合は、[製品] ノードを展開します。
製品の名前を変更するには、製品名を右クリックし、 Renameを選択し、新しい製品名を指定して、 Enter キーを押します。
説明を更新するには、製品名を右クリックし、 Update Description を選択し、新しい説明を指定して、 Enter キーを押します。
Azure Sphere Explorer を開きます。
関心のあるテナントの場合は、[製品] ノードを展開します。
製品の名前を変更するには、製品名を選択して F2 キーを押すか、製品名を右クリックして Rename を選択し、新しい製品名を指定して、 Enter キーを押すか、[ Apply] をクリック。
説明を更新するには、製品を展開し、Descriptionを選択し、F2 キーを押すかDescription を右クリックして Modify を選択し、新しい説明を指定して、Enter キーを押すか、[Apply] をクリックします。
製品の詳細を表示する
azsphere product show コマンドを使用するか、Azure Sphere Public API を使用して、テナント内の製品の詳細を表示します。
azsphere product show --product <product-name>
テナント内の製品の詳細を表示するには:
Visual Studio Code のアクティビティ バーで Azure Sphere Explorer アイコンを選択して、 Azure Sphere Explorer を開きます。 [テナント] ウィンドウに Log in と表示されてテナントが表示される場合 Azure Sphere にログインし、 Refresh を選択して使用可能なテナントを表示します。
関心のあるテナントの場合は、[製品] ノードを展開します。
関心のある製品を展開します。
View>その他の Windows>Azure Sphere Explorer を選択して、Azure Sphere Explorer を開きます。 [テナント] ウィンドウに Log in と表示されてテナントが表示される場合 Azure Sphere にログインし、 Refresh を選択して使用可能なテナントを表示します。
関心のあるテナントの場合は、[製品] ノードを展開します。
関心のある製品を展開します。