アズ スフィア デバイス (Azure Sphereデバイス)

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

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

Commands

az sphere device rescan-attached

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

必須パラメーター

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

Examples

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

az sphere device rescan-attached

az sphere device list-attached

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

必須パラメーター

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

Examples

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

az sphere device list-attached

az sphere device show-attached

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

省略可能なパラメーター

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

Examples

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

az sphere device show-attached

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

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

az sphere device list

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

必須パラメーター

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

省略可能なパラメーター

パラメーター Description
--product -p 製品名。 値の取得元: az sphere product list。
--device-group -dg デバイス グループ名。 値の由来: az sphere device-group list。

Examples

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

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

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

必須パラメーター

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

省略可能なパラメーター

パラメーター Description
--product -p 製品名。 値の取得元: az sphere product list。
--device-group -dg デバイス グループ名。 値の由来: az sphere device-group list。

Examples

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

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

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

必須パラメーター

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

省略可能なパラメーター

パラメーター Description
--device -d このコマンドの対象となるデバイス。 これは、どのデバイスをターゲットにするかを明確にするために、デバイスまたは複数のデバイスが接続されていない場合に必要です。 デバイスが接続されている場合は、デバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 それ以外の場合は、デバイス ID のみを指定する必要があります。 値の由来: az sphere device list。

Examples

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

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

az sphere device assign

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

必須パラメーター

パラメーター Description
--device -d このコマンドの対象となるデバイス。 これは、どのデバイスをターゲットにするかを明確にするために、デバイスまたは複数のデバイスが接続されていない場合に必要です。 デバイスが接続されている場合は、デバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 それ以外の場合は、デバイス ID のみを指定する必要があります。 値の由来: az sphere device list。
--target-product ターゲット製品の名前。 値の取得元: az sphere product list。
--target-device-group ターゲット デバイス グループの名前。 値の由来: az sphere device-group list。
--catalog -c この操作を実行するAzure Sphere カタログ。 Azure Sphere のカタログ名を指定します。 既定のAzure Sphere カタログは、az config set defaults.sphere.catalog=<name> を使用して構成できます。 値の由来: az sphere catalog list。
--resource-group -g Azure リソース グループの名前。 az config set defaults.group=<name>を使用して既定のグループを構成できます。 値の由来: az group list。

Examples

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

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

az sphere device unassign

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

必須パラメーター

パラメーター Description
--device -d このコマンドの対象となるデバイス。 これは、どのデバイスをターゲットにするかを明確にするために、デバイスまたは複数のデバイスが接続されていない場合に必要です。 デバイスが接続されている場合は、デバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 それ以外の場合は、デバイス 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 -g Azure リソース グループの名前。 az config set defaults.group=<name>を使用して既定のグループを構成できます。 値の由来: az group list。

Examples

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

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

az sphere device restart

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

必須パラメーター

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

省略可能なパラメーター

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

Examples

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

az sphere device restart

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

az sphere device restart --device <DeviceIdValue>

Azure Sphere デバイスの要求

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

必須パラメーター

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

省略可能なパラメーター

パラメーター Description
--device -d このコマンドの対象となるデバイス。 これは、どのデバイスをターゲットにするかを明確にするために、デバイスまたは複数のデバイスが接続されていない場合に必要です。 デバイスが接続されている場合は、デバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 それ以外の場合は、デバイス ID のみを指定する必要があります。 値の由来: az sphere device list。
--product -p デバイスを要求する製品名。 値の取得元: az sphere product list。
--device-group -dg デバイスを要求するデバイス グループ名。 値の由来: az sphere device-group list。

Examples

リソース グループ、カタログ名、デバイス 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

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

必須パラメーター

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

省略可能なパラメーター

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

Examples

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

az sphere device recover

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

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

az sphere device show-os-version

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

必須パラメーター

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

省略可能なパラメーター

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

Examples

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

az sphere device show-os-version

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

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

az sphere device show-deployment-status

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

必須パラメーター

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

省略可能なパラメーター

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

Examples

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

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

az sphere device enable-development

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

必須パラメーター

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

省略可能なパラメーター

パラメーター Description
--device -d 複数のデバイスが接続されているときにコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 値の取得元: az sphere device list-attached。
--enable-rt-core-debugging -r リアルタイム コアで実行されているアプリケーションをデバッグするために必要なドライバーをインストールします。 管理者権限が必要です。
--product -p ターゲットの製品名。 デバイス グループも指定されていない限り、デバイスは選択した製品の既定の開発デバイス グループに割り当てられます。 値の取得元: az sphere product list。
--device-group -dg デバイスが割り当てられるデバイス グループ名。 既定では、これは製品の開発デバイス グループです。 値の由来: az sphere device-group list。

Examples

リソース グループ、カタログ名、デバイス 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

"接続されているデバイスの開発とデバッグを無効にし、クラウドからのアプリケーションの更新を有効にするデバイス グループに割り当てることで、クラウドの読み込みをテストするためにデバイスを有効にします。 既定では、これはデバイスの製品のフィールド テスト デバイス グループですが、他のデバイス グループを指定できます。 製造シナリオでは使用できません。詳細については、「 https://aka.ms/AzureSphereManufacturing 」を参照してください。

必須パラメーター

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

省略可能なパラメーター

パラメーター Description
--device -d 複数のデバイスが接続されているときにコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 値の取得元: az sphere device list-attached。
--product -p ターゲットの製品名。 デバイス グループも指定されていない限り、デバイスは選択した製品の既定のフィールド テスト デバイス グループに割り当てられます。 値の取得元: az sphere product list。
--device-group -dg デバイスが割り当てられるデバイス グループ名。 既定では、これは製品のフィールド テスト デバイス グループです。 値の由来: az sphere device-group list。

Examples

リソース グループ、カタログ名、デバイス 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>
  • 最終更新: