az sphere device capability

Note

このリファレンスは、Azure CLI (バージョン 2.45.0 以降) の azure-sphere 拡張機能の一部です。 拡張機能は、az sphere device capability コマンドを初めて実行 するときに自動的に インストールされます。 拡張機能の詳細をご覧ください。

デバイス機能の構成を管理します。

コマンド

名前	説明	型	状態
az sphere device capability apply	接続されているデバイスに機能セッションを一時的に適用します。	拡張機能	GA
az sphere device capability download	Azure Sphere Security Service からデバイス機能ファイルをダウンロードします。	拡張機能	GA
az sphere device capability show-attached	接続されているデバイスの現在のデバイス機能の構成を表示します。	拡張機能	GA
az sphere device capability update	接続されているデバイスのデバイス機能の構成を更新します。	拡張機能	GA

az sphere device capability apply

接続されているデバイスに機能セッションを一時的に適用します。

az sphere device capability apply [--capability-file]
                                  [--none {false, true}]

例

デバイス機能セッションを一時的に適用します。

az sphere device capability apply --capability-file myCapabilities.cap

一時的に適用されたデバイス機能セッションを終了します。

az sphere device capability apply --none

省略可能のパラメーター

--capability-file

機能ファイルのパスとファイル名。 相対または絶対パスを指定できます。

--none -n

接続されているデバイスで一時的な機能セッションを終了します。

指定可能な値: false, true

規定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sphere device capability download

Azure Sphere Security Service からデバイス機能ファイルをダウンロードします。

az sphere device capability download --catalog
                                     --resource-group
                                     [--device]
                                     [--output-file]
                                     [--type {ApplicationDevelopment, FieldServicing}]

例

リソース グループ、カタログ名、デバイス ID、および機能を使用して、デバイスの "ApplicationDevelopment" 機能をダウンロードします。

az sphere device capability download --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue> --type ApplicationDevelopment --output-file myCapabilities.cap

リソース グループ、カタログ名、およびデバイス ID を使用して、デバイスの "None" 機能をダウンロードします。

az sphere device capability download --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue> --output-file myCapabilities.cap

必須のパラメーター

--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。

省略可能のパラメーター

--device -d

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

値の取得元: az sphere device list

--output-file -of

機能をダウンロードするパスとファイル名。 このパラメーターが設定されていない場合、ファイルは既定の名前 (capability-device.cap) で現在のフォルダーに保存されます。

--type -t

ダウンロードする機能のスペース区切りの一覧。 このパラメーターが設定されていない場合は、機能 "None" がダウンロードされます。

指定可能な値: ApplicationDevelopment, FieldServicing

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sphere device capability show-attached

接続されているデバイスの現在のデバイス機能の構成を表示します。

az sphere device capability show-attached [--device]

例

接続されているデバイスのデバイス機能の構成を表示します。

az sphere device capability show-attached

指定したデバイスのデバイス機能の構成を表示します。

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

省略可能のパラメーター

--device -d

複数のデバイスが接続されているときにコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。

値の取得元: az sphere device list-attached

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sphere device capability update

接続されているデバイスのデバイス機能の構成を更新します。

az sphere device capability update --capability-file
                                   [--device]

例

接続されているデバイスのデバイス機能の構成を更新します。

az sphere device capability update --capability-file myCapabilities.cap

指定したデバイスのデバイス機能の構成を更新します。

az sphere device capability update --capability-file myCapabilities.cap --device <DeviceIdValue>

必須のパラメーター

--capability-file

適用するデバイス機能構成ファイルのパスとファイル名。

省略可能のパラメーター

--device -d

複数のデバイスが接続されているときにコマンドを実行するデバイス。 接続されているデバイスの ID、IP アドレス、またはローカル接続 ID を指定します。

値の取得元: az sphere device list-attached

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。