製品を管理する
製品は、特定の機能を実行するために接続されたデバイスに組み込まれている Azure Sphere MCU を識別します。 製造元は、食器洗い機やコーヒーメーカーなど、接続されたデバイスのモデルごとに製品を作成します。 たとえば、Contoso は DW100 食器洗い機用の製品を作成し、製造時にこの製品を各 DW100 食器洗い機に割り当てます。 各製品には、テナント内で一意の GUID があり、変更できません。
接続されているすべてのデバイスには 1 つの製品がありますが、1 つの製品を多数のデバイスに関連付けることができます。 各製品には、テナント内で一意である必要がある名前と説明があります。 製品名と説明は、ある製品を別の製品と区別するための人間が判読できる方法を提供します。 製品の名前と説明は、必要に応じて頻繁に変更できます。
製品を一覧表示する
azsphere product list コマンドを使用するか、Azure Sphere Public API を使用して、Azure Sphere テナント内のすべての製品を一覧表示します。
すべての製品を一覧表示するには:
azsphere product list
既定のテナントが選択されていない場合、メッセージが表示されることがあります。 一覧から必要なテナントを選択し、コマンドを再試行します。
Azure Sphere テナント内のすべての製品を一覧表示するには:
Visual Studio Code のアクティビティ バーで [Azure Sphere エクスプローラー] アイコンを選択して、Azure Sphere エクスプローラーを開きます。 [テナント] ウィンドウに [ テナントを表示するためのログイン] が表示されている場合は、Azure Sphere にログインし、[ 最新の情報に更新 ] を選択して使用可能なテナントを表示します。
目的のテナントを展開します。
製品ノードを展開します。
[他の Windows Azure>Sphere エクスプローラーの表示>] を選択して、Azure Sphere エクスプローラーを開きます。 [テナント] ウィンドウに [ テナントを表示するためのログイン] が表示されている場合は、Azure Sphere にログインし、[ 最新の情報に更新 ] を選択して使用可能なテナントを表示します。
目的のテナントを展開します。
製品ノードを展開します。
製品を作成する
azsphere product create コマンドを使用するか、Azure Sphere パブリック API を使用して、Azure Sphere テナントに製品を作成します。
製品を作成するには:
azsphere product create --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>
製品を作成するには:
目的のテナントの [製品] ノードを右クリックし、[ 新しい製品] を選択します。
製品の名前を指定し、Enter キーを押 します。 製品の名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、[ 出力 ] ウィンドウでエラーが報告されます。
Azure Sphere エクスプローラーで製品を作成すると、5 つの既定のデバイス グループが自動的に作成されます。 デバイス グループなしで製品を作成する場合は、 azsphere product create コマンドまたは Azure Sphere Public API を使用し、 --no-default-device-groups を指定します。
Azure Sphere エクスプローラーで製品を作成することはできますが、削除することはできません。 製品を削除するには、 azsphere product delete コマンドまたは Azure Sphere Public API を使用します。
製品を作成するには:
目的のテナントの [製品] ノードを右クリックし、[ 新しい製品] を選択します。
製品の名前を指定し、 Enter キーを押すか、[ 適用] をクリックします。 製品の名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、[ 出力 ] ウィンドウでエラーが報告されます。
Azure Sphere エクスプローラーで製品を作成すると、5 つの既定のデバイス グループが自動的に作成されます。 デバイス グループなしで製品を作成する場合は、 azsphere product create コマンドまたは Azure Sphere Public API を使用し、 --no-default-device-groups を指定します。
Azure Sphere エクスプローラーで製品を作成することはできますが、削除することはできません。 製品を削除するには、 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 product device list コマンドは、製品内のすべてのデバイスを一覧表示します。 azsphere device update --device-group を実行して、デバイスを別のデバイス グループに移動するか、azsphere device-group delete を実行してデバイス グループを削除します。
製品を削除するには:
azsphere product delete --product <product-name>
対象のテナントの [製品] ノードを展開します。
製品の名前を変更するには、製品名を右クリックし、[ 名前の変更] を選択し、新しい製品名を指定して Enter キーを押します。
説明を更新するには、製品名を右クリックし、[説明の 更新] を選択し、新しい説明を指定して Enter キーを押します。
対象のテナントの [製品] ノードを展開します。
製品の名前を変更するには、製品名を選択して F2 キーを押すか、製品名を右クリックして [名前の変更] を選択し、新しい製品名を指定して Enter キーを 押すか、[ 適用] をクリックします。
説明を更新するには、製品を展開し、[ 説明 ] を選択して F2 キーを押すか、[ 説明 ] を右クリックして [変更] を選択し、新しい説明を指定して Enter キーを 押すか、[ 適用] をクリックします。
製品の詳細を表示する
azsphere product show コマンドを使用するか、Azure Sphere Public API を使用して、テナント内の製品の詳細を表示します。
azsphere product show --product <product-name>
テナント内の製品の詳細を表示するには:
Visual Studio Code のアクティビティ バーで [Azure Sphere エクスプローラー] アイコンを選択して、Azure Sphere エクスプローラーを開きます。 [テナント] ウィンドウに [ テナントを表示するためのログイン] が表示されている場合は、Azure Sphere にログインし、[ 最新の情報に更新 ] を選択して使用可能なテナントを表示します。
対象のテナントの [製品] ノードを展開します。
関心のある製品を展開します。
[他の Windows Azure>Sphere エクスプローラーの表示>] を選択して、Azure Sphere エクスプローラーを開きます。 [テナント] ウィンドウに [ テナントを表示するためのログイン] が表示されている場合は、Azure Sphere にログインし、[ 最新の情報に更新 ] を選択して使用可能なテナントを表示します。
対象のテナントの [製品] ノードを展開します。
関心のある製品を展開します。