デバイス グループの管理
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。
このトピックでは、CLI または Azure Sphere Explorer を使用してデバイス グループを管理する方法について説明します。 このトピックの手順では、Azure Sphere テナント、、 products、および device グループの概念を理解していることを前提としています。
デバイス グループの一覧を取得
azsphere device-group list コマンドを使用するか、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>
Azure Sphere Explorer を開きます。
目的のテナントの [テナント] ノードを展開します。
Azure Sphere Explorer を開きます。
目的のテナントの [テナント] ノードを展開します。
テナントの製品とデバイス グループを表示するには:
Azure Sphere Explorer を開きます。
目的のテナントの [テナント] ノードを展開します。
デバイスが既に製品に関連付けられ、グループに割り当てられている場合は、いつでもデバイス グループを更新できます。
テナントの製品とデバイス グループを表示するには:
Azure Sphere Explorer を開きます。
目的のテナントの [テナント] ノードを展開します。
デバイスが既に製品に関連付けられ、グループに割り当てられている場合は、いつでもデバイス グループを更新できます。
デバイス グループを作成する
azsphere device-group create コマンドを使用するか、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は、このデバイス グループのアプリケーション更新ポリシーを設定します。
Azure Sphere Explorer を開きます。
関心のあるテナントの場合は、[製品] ノードを展開します。
関心のある製品の場合は、右クリックして [新しいデバイス グループ 選択。
デバイス グループの名前を指定し、Enter キーを押します。 デバイス グループの名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、 Output ウィンドウでエラーが報告されます。
デバイス グループは Visual Studio Code で作成できますが、削除することはできません。 デバイス グループを削除するには、 azsphere device-group delete コマンドまたは Azure Sphere Public API を使用します。
Azure Sphere Explorer を開きます。
関心のあるテナントの場合は、[製品] ノードを展開します。
関心のある製品の場合は、右クリックして [新しいデバイス グループ 選択。
デバイス グループの名前を指定し、 Enter キーを押すか、[ Apply をクリックします。 デバイス グループの名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、 Output ウィンドウでエラーが報告されます。
デバイス グループは Visual Studio で作成できますが、削除することはできません。 製品を削除するには、 azsphere device-group delete コマンドまたは Azure Sphere Public API を使用します。
デバイス グループを更新する
azsphere device-group update コマンドを使用するか、Device Group - Patch 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 パラメーターを更新することもできます。
Azure Sphere Explorer を開きます。
関心のあるテナントの場合は、[製品] ノードを展開します。
関心のある製品の場合は、製品ノードを展開して、含まれているデバイス グループを表示します。 デバイス グループの名前を変更するか、説明、OS フィードの種類、または更新ポリシーを更新できます。
デバイス グループの名前を変更するには、デバイス グループ名を右クリックし、 Renameを選択し、新しい名前を入力して、 Enter キーを押します。 デバイス グループの名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、 Output ウィンドウでエラーが報告されます。
デバイス グループの説明を更新するには、デバイス グループ名を右クリックし、 Update Descriptionを選択し、新しい説明を入力して、 Enter キーを押します。
OS フィードの種類を更新するには、デバイス グループを展開し、 OS フィードの種類を右クリックし、 Update を選択し、メニューから Retail または RetailEval を選択します。
更新ポリシーを変更するには、デバイス グループを展開し、 Update ポリシーを右クリックし、 Update を選択し、メニューから [ No3rdPartyAppUpdates または UpdateAll を選択します。 (3 番目のオプション NoUpdates は現在、内部使用のために予約されています。このオプションを選択すると、 Output ウィンドウにエラーが報告されます。
azsphere device update コマンドを使用するか、Devices - Move API を使用して、デバイスを別のデバイス グループに移動します。
Azure Sphere Explorer を開きます。
関心のあるテナントの場合は、[製品] ノードを展開します。
関心のある製品の場合は、製品ノードを展開して、含まれているデバイス グループを表示します。 デバイス グループの名前を変更するか、説明、OS フィードの種類、または更新ポリシーを更新できます。
デバイス グループの名前を変更するには、デバイス グループ名を選択して F2 キーを押すか、デバイス グループ名を右クリックして Rename を選択し、新しい名前を入力して、 Enter キーを押すか、 Apply をクリックします。 デバイス グループの名前には、英数字とスペースのみを含めることができます。 50 文字を超えることはできません。 無効な名前を指定すると、 Output ウィンドウでエラーが報告されます。
デバイス グループの説明を更新するには、デバイス グループを展開し、Descriptionを選択し、F2 キーを押すかDescription を右クリックして Modify を選択し、新しい説明を入力して、Enter キーを押すか、[Apply] をクリックします。
OS フィードの種類を更新するには、 デバイス グループを展開し、OS フィードの種類を選択しF2 を押すかOS フィードの種類 を右クリックしてModifyを選択し、メニューから Retail または RetailEval を選択して、Enter キーを押すか、[Apply] をクリックします。
更新ポリシーを変更するには、デバイス グループを展開します。 Update ポリシーを選択しF2キーを押すか、Update ポリシーを右クリックしてModifyを選択し、メニューから [No3rdPartyAppUpdates または UpdateAll を選択し、Enter キーを押すか、[Apply] をクリックします。 (3 番目のオプション NoUpdates は現在、内部使用のために予約されています。このオプションを選択すると、 Output ウィンドウ) にエラーが報告されます。
azsphere device update コマンドを使用するか、Devices - Move API を使用して、デバイスを別のデバイス グループに移動します。
デバイスを別のデバイス グループに移動する
azsphere device update コマンドを使用するか、Devices - Move API を使用して、デバイスを別のデバイス グループに移動します。
デバイス グループ ID、または製品名とデバイス グループ名の組み合わせを <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 コマンドを使用するか、Device Group - Delete API を使用して、Azure Sphere テナント内の指定されたデバイス グループを削除します。
デバイス グループは、次の場合にのみ削除できます。
- ユーザーはテナントに対する管理者権限を持っています。
- デバイス グループが空で、デバイスがありません。 azsphere device-group device list コマンドは、デバイス グループ内のすべてのデバイスを一覧表示します。 azsphere device update --device-group を実行して、デバイスを別のデバイス グループに移動します。
デバイス グループ ID、または製品名とデバイス グループ名の組み合わせを <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>