az sphere device

Azure Sphere デバイスを管理します。

操作	説明
az sphere device rescan-attached	接続されているデバイスの数を表示します。
az sphere device list-attached	接続されているすべてのデバイスを一覧表示します。
az sphere device show-attached	接続されているデバイスの詳細を表示します。
az sphere device list	カタログ、製品、またはデバイス グループ内のすべてのデバイスを一覧表示します。
az sphere device show-count	カタログ、製品、またはデバイス グループ内のデバイスの数を表示します。
az sphere device show	リソース グループとカタログ内の既存のデバイスの詳細を表示します。
az sphere device assign	リソース グループとカタログ内のデバイス グループにデバイスを割り当てます。
az sphere device unassign	リソース グループとカタログ内のデバイス グループからデバイスの割り当てを解除します。
az sphere device restart	接続されているデバイスを再起動します。
az sphere device claim	リソース グループとカタログ内のデバイスを要求します。
az sphere device recover	回復モードを使用して、接続されているデバイスに新しいファームウェアを読み込みます。
az sphere device show-os-version	接続されているデバイスにオペレーティング システムのバージョンを表示します。
az sphere device show-deployment-status	デバイス上のオペレーティング システムの展開状態を表示します。
az sphere device enable-development	"接続されているデバイスでサイドローディングとデバッグを有効にし、クラウドからのアプリケーションの更新を無効にするデバイス グループに割り当てることで、開発用のデバイスを有効にします。 既定では、これはデバイスの製品の開発デバイス グループですが、他のデバイス グループを指定できます。 製造シナリオでは使用できません
az sphere device enable-cloud-test	"接続されているデバイスで開発とデバッグを無効にし、クラウドからのアプリケーションの更新を可能にするデバイス グループに割り当てることで、クラウドの読み込みをテストするデバイスを有効にします。 既定では、これはデバイスの製品のフィールド テスト デバイス グループですが、他のデバイス グループを指定できます。 製造シナリオでは使用できません

コマンド

az sphere device rescan-attached

接続されているデバイスの数を表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

例

接続されているデバイスの数を表示します。

az sphere device rescan-attached

az sphere device list-attached

接続されているすべてのデバイスを一覧表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

例

接続されているすべてのデバイスを一覧表示します。

az sphere device list-attached

az sphere device show-attached

接続されているデバイスの詳細を表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list

例

接続されているデバイスの詳細を表示します。

az sphere device show-attached

指定したデバイスの詳細を表示します。

az sphere device show-attached --device <DeviceIdValue>

az sphere device list

カタログ、製品、またはデバイス グループ内のすべてのデバイスを一覧表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--product -p	製品名。 の値: az sphere 製品リスト
--device-group -dg	表示するデバイス グループ。 からの値: az sphere device

例

リソース グループとカタログ内のすべてのデバイスを一覧表示します。

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog

リソース グループ、カタログ、および製品内のすべてのデバイスを一覧表示します。

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

リソース グループ、カタログ、製品、デバイス グループ内のすべてのデバイスを一覧表示します。

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show-count

カタログ、製品、またはデバイス グループ内のデバイスの数を表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--product -p	製品名。 の値: az sphere 製品リスト
--device-group -dg	表示するデバイス グループ。 からの値: az sphere device

例

リソース グループとカタログ内のデバイスの数を表示します。

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog

リソース グループ、カタログ、および製品内のデバイスの数を表示します。

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

リソース グループ、カタログ、製品、デバイス グループ内のデバイスの数を表示します。

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show

リソース グループとカタログ内の既存のデバイスの詳細を表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list

例

リソース グループ、カタログ名、およびデバイス ID を使用して、デバイスの詳細を表示します。

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device assign

リソース グループとカタログ内のデバイス グループにデバイスを割り当てます。

必須パラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list
--target-product	ターゲット製品の名前。 の値: az sphere 製品リスト
--target-device-group	ターゲット デバイス グループの名前。 からの値: az sphere device
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

例

リソース グループ、カタログ名、ターゲット製品名、ターゲット デバイス グループ名、デバイス ID を使用してデバイスを割り当てます。

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

az sphere device unassign

リソース グループとカタログ内のデバイス グループからデバイスの割り当てを解除します。

必須パラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

例

リソース グループ、カタログ名、デバイス ID を使用してデバイスの割り当てを解除します。

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device restart

接続されているデバイスを再起動します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list

例

接続されているデバイスを再起動します。

az sphere device restart

指定したデバイスを再起動します。

az sphere device restart --device <DeviceIdValue>

az sphere device claim

リソース グループとカタログ内のデバイスを要求します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list
--product -p	製品名。 の値: az sphere 製品リスト
--device-group -dg	表示するデバイス グループ。 からの値: az sphere device

例

リソース グループ、カタログ名、デバイス ID を使用してデバイスを要求します。

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

リソース グループ、カタログ名、製品名、デバイス グループ名、デバイス ID を使用してデバイスを要求します。

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device recover

回復モードを使用して、接続されているデバイスに新しいファームウェアを読み込みます。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list
--機能	回復中にデバイスに適用するデバイス機能イメージのファイル名。 (パス)。
--画像	デバイスに書き込むイメージ パッケージを含むフォルダー。 指定しない場合は、最新の OS イメージがダウンロードされ、使用されます。 (パス)。

例

接続されているデバイスを回復します。

az sphere device recover

特定の機能とイメージを使用して接続されているデバイスを回復します。

az sphere device recover --capability myCapability.cap --images myImagesFolder

az sphere device show-os-version

接続されているデバイスにオペレーティング システムのバージョンを表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list

例

接続されているデバイスにオペレーティング システムのバージョンを表示します。

az sphere device show-os-version

指定したデバイス上のオペレーティング システムのバージョンを表示します。

az sphere device show-os-version --device <DeviceIdValue>

az sphere device show-deployment-status

デバイス上のオペレーティング システムの展開状態を表示します。

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list

例

リソース グループ、カタログ名、およびデバイス ID を使用して、操作システムのデプロイ状態を表示します。

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device enable-development

"接続されているデバイスでサイドローディングとデバッグを有効にし、クラウドからのアプリケーションの更新を無効にするデバイス グループに割り当てることで、開発用のデバイスを有効にします。 既定では、これはデバイスの製品の開発デバイス グループですが、他のデバイス グループを指定できます。 製造シナリオでは使用できません

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list
--enable-rt-core-debugging -r	リアルタイム コアで実行されているアプリケーションをデバッグするために必要なドライバーをインストールします。 管理者権限が必要です。
--product -p	製品名。 の値: az sphere 製品リスト
--device-group -dg	表示するデバイス グループ。 からの値: az sphere device

例

リソース グループ、カタログ名、デバイス ID、および既定の開発デバイス グループを使用してサイドローディングとデバッグを有効にすることで、開発用のデバイスを有効にします。

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

リソース グループ、カタログ名、製品名、デバイス グループ名、デバイス ID を使用してサイドローディングとデバッグを有効にすることで、開発用のデバイスを有効にします。

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device enable-cloud-test

"接続されているデバイスで開発とデバッグを無効にし、クラウドからのアプリケーションの更新を可能にするデバイス グループに割り当てることで、クラウドの読み込みをテストするデバイスを有効にします。 既定では、これはデバイスの製品のフィールド テスト デバイス グループですが、他のデバイス グループを指定できます。 製造シナリオでは使用できません

必須パラメーター

パラメーター	説明
--catalog -c	この操作を実行する Azure Sphere カタログ。 Azure Sphere カタログ名を指定します。 を使用して、既定の Azure Sphere カタログを az config set defaults.sphere.catalog=<name>構成できます。 からの値: az sphere catalog list。
--resource-group -r	Azure リソース グループの名前。 既定のグループは、 を使用して az config set defaults.group=<name>構成できます。 の値: az group list。

省略可能なパラメーター

パラメーター	説明
--device -d	複数のデバイスが接続されている場合にコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 からの値: az sphere device list
--product -p	製品名。 の値: az sphere 製品リスト
--device-group -dg	表示するデバイス グループ。 からの値: az sphere device

例

リソース グループ、カタログ名、デバイス ID、および既定のフィールド テスト デバイス グループを使用して、クラウドをテストするためのデバイスを有効にします。

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

リソース グループ、カタログ名、製品名、デバイス グループ名、デバイス ID を使用して、クラウドをテストするためのデバイスを有効にします。

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>