デバイス
Azure Sphere デバイスを管理します。
| 操作 | 説明 |
|---|---|
| アプリ | デバイス上のアプリケーションの状態を変更します。 |
| 機能 | デバイス機能を管理します。 |
| 証明 書 | デバイス証明書ストアを管理します。 |
| 主張 | 以前に要求されていないデバイスを Azure Sphere テナントに要求します。 |
| enable-cloud-test | デバッグを無効にして更新プログラムを受け取るデバイスを設定します。 |
| enable-development | ローカル デバッグ用のデバイスを設定します。 |
| イメージ | デバイスのイメージを管理します。 |
| リスト | テナント内のすべてのデバイスを表示します。 |
| list-attached | 接続されているデバイスをListsします。 |
| 製造状態 | 接続されているデバイスの製造状態を管理します。 |
| ネットワーク | デバイス上のネットワーク インターフェイスの状態に関する情報を提供します。 |
| 回復 | 特別な回復モードを使用して、デバイスに新しいファームウェアを読み込みます。 |
| 再スキャン接続済み | 接続されているデバイスをトラブルシューティングの支援として再スキャンします (Windows のみ)。 |
| 再起動 | 接続されているデバイスを再起動します。 |
| 表示 | デバイスの更新構成に関する詳細を表示します。 |
| show-attached | デバイス自体から接続されているデバイスに関する詳細を表示します。 |
| show-count | テナント内のデバイスの合計数を表示します。 |
| show-deployment-status | 最新のデプロイ更新プログラムの状態を表示します。 |
| show-os-version | ローカル デバイス オペレーティング システムのバージョンを表示します。 |
| sideload | アタッチされたデバイスにイメージを読み込みます。 |
| 更新 | 特定のデバイス グループに配置して、デバイスを更新します。 |
| Wifi | デバイスの Wi-Fi 構成を管理します。 |
アプリ
デバイス上のアプリケーションを管理します。
アプリ オプションの多くは、azsphere デバイス enable-development を使用して取得できる appDevelopment 機能を必要とします。 SDK 署名されたアプリケーションまたは運用署名されたアプリケーションを開始、停止、またはデバッグするには、デバイスに appDevelopment 機能が必要です。
azsphere device app stop と azsphere device app start を使用して、実行中のリアルタイム対応アプリケーションを再起動して、実行されているリアルタイム コアを判断できます。
| 操作 | 説明 |
|---|---|
| show-memory-stats | 接続されているデバイス上のアプリケーションのメモリ統計を表示します。 |
| show-quota | デバイス上の現在のアプリケーションによって使用されるストレージの量を表示します。 |
| show-status | デバイス上の現在のアプリケーションの状態を返します。 |
| 開始 | デバイスに読み込まれたアプリケーションを起動します。 |
| 停止 | デバイスで実行されているアプリケーションを停止します。 |
アプリ show-memory-stats
接続されているデバイス上のアプリケーションのメモリ統計を表示します。 このコマンドは、 appDevelopment デバイス機能が構成されている場合にのみ使用できます。 ヒープ メモリ割り当て追跡が構成されている場合は、追加情報が表示されます。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device app show-memory-stats
-------------- -------------
Name Usage (bytes)
============================
Total 434176
User Mode 147456
Peak User Mode 147456
-------------- -------------
アプリの show-quota
接続されているデバイスで割り当てられ、使用中の変更可能なストレージの量を表示します。
変更 可能なストレージ クォータは アプリケーション マニフェストで設定し、Azure Sphere OS はファイルにセクターを割り当てるときにクォータを適用します。 その結果、値を MutableStorage 小さくすると、使用中のストレージの量は変更されませんが、報告される割り当てられた値は異なります。 たとえば、アプリケーションが既に 16 KB を使用していて、値を MutableStorage 8 KB に変更した場合、コマンドは、割り当てられた 8 KB の 16 KB をアプリケーションが使用することを報告します。 データはデバイスに残ります。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--component-id | Guid | クォータ情報を取得するコンポーネントの ID を指定します。 省略すると、すべてのコンポーネントのクォータ情報が表示されます。 |
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.
アプリの表示状態
デバイス上のアプリケーションの現在の状態を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--component-id | Guid | 状態を表示するコンポーネントの ID を指定します。 省略すると、すべてのコンポーネントの状態が表示されます。 |
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running
アプリの起動
デバイスでアプリケーションを起動します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --debug-mode | ブール | デバッグ用にアプリケーションを起動します。 を --component-id 指定する必要があります。 |
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -i、--component-id | Guid | 開始するコンポーネントの ID を指定します。 省略すると、すべてのアプリケーションが起動します。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core : High-level
アプリの停止
デバイス上のアプリケーションを停止します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--component-id | Guid | 停止するコンポーネントの ID を指定します。 省略すると、すべてのアプリケーションが停止します。 |
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped
機能
デバイス機能を管理します。 デバイス機能は、個々の Azure Sphere デバイスで実行できる操作を決定します。
デバイス機能は、 azsphere device capability download コマンドを使用して、Azure Sphere Security Service からファイルとしてダウンロードされます。 azsphere device capability update コマンドを使用して、接続されている Azure Sphere デバイスにデバイス機能の構成を適用し、azsphere device capability select コマンドを使用してサービス セッションを作成できます。 デバイス機能の詳細については、「デバイスの機能 と通信」を参照してください。
| 操作 | 説明 |
|---|---|
| ダウンロード | Azure Sphere Security Service からデバイス機能の構成をダウンロードします。 |
| 選択 | サービス セッションに使用するダウンロードされた機能ファイルを選択します。 |
| show-attached | 接続されているデバイスの機能構成を表示します。 |
| 更新 | 接続されているデバイスにデバイス機能の構成を適用します。 |
機能のダウンロード
Azure Sphere Security Service からデバイス機能をダウンロードします。
appDevelopment 機能を使用すると、SDK で署名されたアプリケーションをサイドロードし、デバイス上のアプリケーションを起動、停止、デバッグ、または削除できます。 appDevelopment 機能がないと、クラウドに読み込まれたアプリケーションのみが読み込まれ、起動、停止、デバッグ、削除が禁止されます。 appDevelopment 機能は、azsphere device enable-development コマンドの一部として適用されます。
fieldServicing 機能をダウンロードすると、1 つの Azure Sphere デバイスの機能を含むファイルが作成されます。 fieldServicing 機能ファイルはローカル コンピューターにダウンロードされ、azsphere device capability select コマンドと組み合わせて使用できます。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --型 | Capability-type | ダウンロードするデバイス機能の種類を指定します。 値は appDevelopment、 fieldServicing、または none です。 appDevelopment 機能または fieldServicing 機能を削除するには、none を使用します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | コマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合、またはデバイスが接続されていない場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されていないデバイスのデバイス ID を指定することも、接続されているデバイスの IP アドレスまたはローカル接続 ID を指定することもできます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| --先 | 文字列 | 機能構成を保存するパスとファイル名を指定します。 絶対パスまたは相対パスを含めます。 パスを指定しない場合、コマンドは、デバイス ID.cap> の名前付け規則<機能 type-first>< 8 文字を使用して、ファイルをローカル ディレクトリに格納します。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
--------------------------------------------
Result
============================================
C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
--------------------------------------------
機能の選択
接続されている Azure Sphere デバイスで使用する機能ファイルを選択します。
azsphere device capability select コマンドは、任意の機能で使用できますが、多くの場合、サービス セッションを有効にするために fieldServicing 機能で使用されます。 任意のユーザー ロールは、 azsphere device capability select コマンドにアクセスできます。
fieldServicing 機能を使用すると、Azure Sphere デバイスと、機能ファイルを含むローカル コンピューターとの間で通信が有効になります。 fieldServicing 機能ファイルは、ローカル コンピューターと Azure Sphere デバイス間のセッションに使用され、セッション内の各コマンドの先頭に、使用中の機能ファイルを示すメッセージが付加されます。
サービス セッションを終了するには、 azsphere device capability select --none を使用します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --capability-file | 文字列 | 選択するデバイス機能構成ファイルのパスとファイル名を指定します。 相対パスまたは絶対パスを指定できます。 |
| -n、--none | - | 以前に選択したデバイス機能の構成をクリアします。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.
機能 show-attached
接続されているデバイスに格納されている機能構成を表示します。
メモ
このコマンドは、機能ファイルを使用して構成された機能と、ボードに既定で存在する一部の機能 (すべてではない) を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableFieldServicing
--------------------
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableAppDevelopment
--------------------
機能の更新
接続されているデバイスにデバイス機能の構成を適用します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --capability-file | 文字列 | 適用するデバイス機能ファイルのパスとファイル名を指定します。 相対パスまたは絶対パスを指定できます。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | コマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合、またはデバイスが接続されていない場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されていないデバイスのデバイス ID を指定することも、接続されているデバイスの IP アドレスまたはローカル接続 ID を指定することもできます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.
証明 書
接続されているデバイス上の証明書を管理します。
| 操作 | 説明 |
|---|---|
| 追加 | 接続されているデバイス上の証明書ストアに証明書を追加します。 |
| 削除 | 接続されているデバイスの証明書ストアから証明書を削除します。 |
| リスト | 接続されているデバイスの証明書ストアで使用できる証明書 ID をListsします。 |
| 表示 | 添付デバイスの証明書ストアに証明書の詳細を表示します。 |
| show-quota | 接続されているデバイスの証明書ストアで使用可能な空き領域を表示します。 |
certificate add
接続されているデバイスの証明書ストアに証明書を追加します。
Azure Sphere デバイスに読み込むには、ルート CA 証明書とクライアント証明書が .pem 形式である必要があります。 デバイスのクライアント証明書と秘密キー (および必要に応じて秘密キーのパスワード) と共に、適切なサーバーからルート CA 証明書を取得する必要があります。 各証明書は、EAP-TLS ネットワーク内の適切なサーバーによって生成され、署名されている必要があります。 ネットワーク管理者またはセキュリティ チームは、証明書を取得するために必要な詳細を指定できます。 ルート CA 証明書の取得の詳細については、「 EAP-TLS ネットワークの証明書を取得して展開する」を参照してください。
注意
証明書 ID はクライアントとルート CA の両方の証明書に対してシステム全体であるため、 azsphere コマンドまたは新しい証明書を追加する関数呼び出しによって、以前のコマンドまたは関数呼び出しによって追加された証明書が上書きされ、ネットワーク接続エラーが発生する可能性があります。 明確な証明書の更新手順を開発し、証明書 ID を慎重に選択することを強くお勧めします。
詳細については、「 証明書 ID 」を参照してください。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--cert-id | 文字列 | 追加する証明書の識別子を指定します。 文字列識別子 (最大 16 文字)。 有効な文字には、大文字 (A から Z)、小文字 (a から z)、数字 (0 から 9)、アンダースコア (_)、ピリオド (.)、ハイフン (-) が含まれます。 この識別子は、EAP-TLS ネットワークの Wi-Fi 構成でも使用されます。 |
| --cert-type | 文字列 | 追加する証明書の種類 (クライアントまたはルートカ) を指定します。 |
| -p、--public-key-file | 文字列 | 公開キー証明書 .pem ファイルへのパスを指定します。 相対パスまたは絶対パスを指定できます。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| --private-key-file | 文字列 | クライアント秘密キー証明書 .pem ファイルへのパスを指定します。 クライアント型の証明書を追加するときに必要です。 相対パスまたは絶対パスを指定できます。 |
| -w、--private-key-password | 文字列 | クライアント秘密キーの省略可能なパスワードを指定します。 パスワードは、暗号化されたクライアント証明書の秘密キーを追加するときに必要です。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.
azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.
証明書の削除
接続されているデバイスの証明書ストアから証明書を削除します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -c、--certificate または --cert-id [Retiring] |
文字列 | 削除する証明書の識別子を指定します。 引数は --cert-id 廃止され、今後のリリースで削除される予定です。 詳細については、「 Azure Sphere CLI での重要な変更 (廃止機能)」を参照してください。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device certificate delete --certificate certclient
証明書の一覧
デバイスの証明書ストアで使用できる証明書をListsします。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device certificate list
-----------
Identifiers
===========
rootCert
-----------
certificate show
デバイスの証明書ストア内の個々の証明書の詳細を表示します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -c、--certificate または --cert-id [Retiring] |
文字列 | 詳細を表示する証明書の識別子を指定します。 引数は --cert-id 廃止され、今後のリリースで削除される予定です。 詳細については、「 Azure Sphere CLI での重要な変更 (廃止機能)」を参照してください。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
Id StartDate EndDate SubjectName IssuerName
==========================================================================================================================
certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
certificate show-quota
接続されているデバイスの証明書ストアで使用可能な空き領域を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------
主張
現在の Azure Sphere テナントに対して、以前に要求されていないデバイスを要求します。
大事な
デバイスを要求する前に、正しい Azure Sphere テナントにサインインしていることを確認 します。 デバイスは 1 回だけ要求できます。 要求されると、デバイスを別のテナントに移動することはできません。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | コマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合、またはデバイスが接続されていない場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されていないデバイスのデバイス ID を指定することも、接続されているデバイスの IP アドレスまたはローカル接続 ID を指定することもできます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
| --力 | ブール | 現在のユーザーが選択した Azure Sphere テナントでデバイスを要求するように強制します。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.
enable-cloud-test
アプリケーション開発を無効にし、既存のアプリケーションを削除し、クラウドで読み込まれたアプリケーションの更新を有効にすることで、クラウド読み込みをテストするために接続されているデバイスを読み取ります。
デバイスを PC に接続し、接続されているデバイスでのみ動作する必要があります。
具体的には、 enable-cloud-test:
- アタッチされたデバイスの appDevelopment 機能を削除します。
- クラウド読み込みアプリケーションの更新を有効にするデバイス グループにデバイスを割り当てます。
- デバイスを再起動します。
enable-cloud-test が実行する特定のタスクは、製品とデバイス グループがこのデバイスに既に割り当てられているかどうかによって異なります。
azsphere device enable-cloud-test がパラメーターなしで実行された場合、デバイスはデバイスの現在の製品のフィールド テスト デバイス グループに配置されます。 これは、アプリケーションの更新を有効にする、製品ごとに自動的に作成される既定のデバイス グループの 1 つです。 デバイスに製品がない場合、またはフィールド テスト デバイス グループが存在しない場合は、エラーが返されます。
製品が指定されている場合、デバイスはその製品のフィールド テスト デバイス グループに配置されます。 このデバイス グループが存在しない場合は、エラーが返されます。
デバイス グループが指定されている場合は、そのデバイスにデバイスが配置されます。 ターゲット デバイス グループでアプリケーションの更新が有効になっていない場合は、エラーが返されます。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -p、--product | GUID または名前 | ターゲット製品を指定します。 これを指定すると、デバイスも指定されていない限り --device-group 、デバイスはこの製品の既定のフィールド テスト デバイス グループに移動されます。 Azure Sphere 製品の ID または名前を指定できます。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
| -g、--device-group | GUID または名前 | デバイスを移動するデバイス グループを指定します。 デバイス グループ ID またはデバイス グループ名を指定できます。 デバイス グループ名を使用するには、製品名とデバイス グループ名の両方を形式で指定する <product-name/device-group-name> 必要があります。 既定では、これは製品のフィールド テスト デバイス グループです。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
例 1。 ID を使用して既存のデバイス グループにデバイスを割り当てる
次の使用例は、接続されているデバイスを既存の製品とデバイス グループに割り当てます。
azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')
例 2。 デバイスを別のデバイス グループに割り当てる
この例は前の例に似ていますが、デバイスの既存の製品を保持します。 ここで、 enable-cloud-test 操作は、デバイスが属するデバイス グループを変更し、appDevelopment 機能を削除します。 このコマンドは、アプリケーションの更新を有効にしない開発環境からデバイスを移行する運用環境に移動する場合に役立ちます。
azsphere device enable-cloud-test --device-group "Marketing/Field Test"
例 3. 製品名でデバイスを割り当てる
この例では、クラウドの読み込みを有効にし、名前でデバイスを製品に割り当てます。
azsphere device enable-cloud-test --product DW100
enable-development
デバイスでサイドローディングとデバッグを有効にし、クラウドからのアプリケーションの更新を無効にするデバイス グループに割り当てることで、開発用のデバイスを有効にします。 既定では、これはデバイスの製品の開発デバイス グループですが、他のデバイス グループを指定できます。 製造シナリオでは使用しないでください。 詳細については、「 接続されたデバイスの製造 」を参照してください。
具体的には、 enable-development:
- 接続されているデバイスの appDevelopment 機能をダウンロードして適用します。
- クラウド読み込みアプリケーションの更新を有効にしないデバイス グループにデバイスを割り当てます。
- デバイスを再起動します。
パラメーターなしで azsphere device enable-development コマンドを実行する場合:
- デバイスに製品またはデバイス グループがまだない場合、コマンドは、接続されているデバイスの appDevelopment 機能をダウンロードして適用し、デバイスを再起動します。 既存のアプリはすべてデバイスに残り、OS が更新されます。 デバイスを要求するインストール プロセスと、高度なアプリケーションを構築するためのクイック スタートは影響を受けません。
- デバイスに既に製品がある場合、コマンドはデバイスを製品の 開発 デバイス グループに移動します。 既定では、このグループのアプリケーション更新プログラムは無効になっており、サイドロードされたアプリが上書きされないようにします。
パラメーターを指定して azsphere device enable-development コマンドを実行する場合:--product
- 製品の開発デバイス グループ内のデバイスをPlacesします。 このデバイス グループが存在しない場合は、エラーが返されます。
パラメーターを指定して azsphere device enable-development コマンドを実行する場合:--device-group
- 指定したデバイス グループ内のデバイスが指定されているPlaces。 ターゲット デバイス グループでアプリケーションの更新を有効にしないか、エラーが返されます。
場合によっては、 azsphere device enable-development によってエラーが報告され、デバイスを要求するよう提案されます。 デバイスを既に要求している場合は、 azsphere tenant show-selected を使用して、デバイスを要求したテナントにログインしていることを確認します。 そうでない場合は、 azsphere login を使用して正しいテナントにログインします。 適切なテナントにログインしていることを確認したら、 azsphere device claim を使用してデバイスを要求します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -g、--device-group | GUID または名前 | デバイスを移動するデバイス グループを指定します。 省略した場合は、デバイスを既定のグループに割り当てます。 デバイス グループ ID またはデバイス グループ名を指定できます。 デバイス グループ名を使用するには、製品名とデバイス グループ名の両方を形式で指定する <product-name/device-group-name> 必要があります。 |
| -r、--enable-rt-core-debugging | ブール | リアルタイム コアで実行されているアプリケーションをデバッグするために必要なドライバーをインストールします。 このオプションには管理者権限が必要です。 |
| -p、--product | GUID または名前 | ターゲット製品を指定します。 この値を指定すると、デバイスも指定されていない限り--device-group、デバイスはこの製品の既定の開発デバイス グループに移動されます。 Azure Sphere 製品の ID または名前を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')
イメージ
接続されているデバイスにインストールされているイメージまたは対象となるイメージに関する情報を返します。
| 操作 | 説明 |
|---|---|
| list-installed | 接続されているデバイスに現在インストールされているイメージの詳細を提供します。 |
| list-targeted | アタッチされたデバイスを対象とするイメージの詳細を提供します。 |
image list-installed
接続されているデバイスにインストールされているイメージをListsします。 情報の一覧には、コンポーネント ID とイメージ ID が含まれます。
メモ
長いイメージ名は 31 文字で切り捨てられます。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -f、--full | ブール | デバイスにインストールされているすべてのソフトウェア イメージをListsします。 既定では、アプリケーション イメージ、デバッガー、およびボード構成イメージのみが一覧表示されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device image list-installed
Installed images:
--> gdbserver
--> Image type: Application
--> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
--> Image ID: dc6205bd-4478-4c9b-81ad-5e41ac23ed68
--> CrashApplicatio
--> Image type: Application
--> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
--> Image ID: cc77124e-6447-4c0f-9f99-fc0ad5ef46ef
image list-targeted
azure Sphere Security Service にアップロードされ、デバイスが更新されたときにインストールされるイメージをListsします。 Azure Sphere デバイスがクラウドベースのアプリケーション更新プログラムを受け入れる準備ができていることを確認する方法の詳細については、「 デバイスのクラウドベースのデプロイを有効にする」を参照してください。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | コマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合、またはデバイスが接続されていない場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されていないデバイスのデバイス ID を指定することも、接続されているデバイスの IP アドレスまたはローカル接続 ID を指定することもできます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
| -f、--full | ブール | Azure Sphere テナント内のすべてのイメージをListsします。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device image list-targeted
----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
Name ComponentId ImageId ImageType RegionalDataBoundary
=======================================================================================================================================
HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications None
----------------------- ------------------------------------ ------------------------------------ -------------------------------------
リスト
テナント内のすべてのデバイスをListsします。 リストは、最初の 500 台のデバイスの後に切り捨てられます。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device list
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
パラメーターを --query 使用して、このコマンドに表示される出力をカスタマイズできます。 詳細については、「 クエリ CLI コマンドの出力」を参照してください。
次の例では、デバイス ID と製品 ID のみを選択する方法を示します。
azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
ヒント
azsphere product show --product <product-ID を>実行して製品名を表示するか、azsphere device-group show --device-group <devicegroup-ID> を実行してデバイス グループ名を表示します。
list-attached
ローカル PC に接続されているデバイスをListsします。
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
--> Is responsive: yes
--> IP address: 192.128.48.1
--> Connection path: 21143
製造状態
接続されているデバイスの製造状態を管理します。
| 操作 | 説明 |
|---|---|
| 表示 | 接続されているデバイスの製造状態を表示します。 |
| 更新 | 接続されたデバイスの製造状態を更新します。 |
注意
製造状態の変更は永続的で元に戻すことはできません。
製造状態ショー
接続されているデバイスの製造状態を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------
製造状態の更新
接続されたデバイスの製造状態を更新します。 詳細については、「 デバイスの製造状態を設定する」を参照してください。
注意
製造状態の変更は永続的で元に戻すことはできません。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -s、--state | 製造状態 | デバイスに設定する製造状態を指定します。 可能な状態には、 と がModule1Complete含まれますDeviceComplete。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.
ネットワーク
接続されているデバイス上のネットワーク インターフェイスの状態に関する情報を提供します。
| 操作 | 説明 |
|---|---|
| 有効 | 接続されているデバイスでネットワーク インターフェイスを有効にします。 |
| 無効 | 接続されているデバイスのネットワーク インターフェイスを無効にします。 |
| list-firewall-rules | 接続されているデバイスのファイアウォール規則をListsします。 |
| list-interfaces | 接続されているデバイスのネットワーク インターフェイスをListsします。 |
| プロキシ | ネットワーク プロキシ設定を管理します。 |
| show-診断 | 接続されているデバイス上の 1 つまたはすべてのワイヤレス ネットワークのネットワーク 診断を表示します。 |
| show-status | 接続されているデバイスのネットワーク状態を表示します。 |
| update-interface | デバイスのネットワーク インターフェイス構成を更新します。 |
ネットワークの有効化
接続されているデバイスでネットワーク インターフェイスを有効にします。
メモ
このコマンドは、イーサネット eth0 と wlan0 接続を構成するためにサポートされています。 または azspheresvcを構成loするとエラーが返されます。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --インターフェイス | 文字列 | 有効にするインターフェイスを指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
ネットワークの無効化
接続されているデバイスのネットワーク インターフェイスを無効にします。
メモ
このコマンドは、イーサネット eth0 と wlan0 接続を構成するためにサポートされています。 または azspheresvcを構成loするとエラーが返されます。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --インターフェイス | 文字列 | 有効にするインターフェイスを指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
network list-firewall-rules
接続されているデバイスのファイアウォール規則をListsします。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
次のルールが表示されます。
- ファイアウォールルールセット名: ファイアウォールルールセットブロックの名前を表示します。
- 値は 、PREROUTING、 POSTROUTING、 INPUT、 FORWARD、 OUTPUT です。
- [ルール セットが有効です]: ルール セットの状態を表示します。 値は True または False です。
- ファイアウォール規則セット規則: 次の規則の値を表示します。
- ソース IP: 送信マシンの IP アドレスを表示します。
- ソース マスク: 送信側マシンのネットワーク マスクを表示します。
- 宛先 IP: 宛先マシンの IP アドレスを表示します。
- 宛先マスク: デストメーション マシンのネットワーク マスクを表示します。
- UID: ルールに適用されたユーザー ID を表示します。 4294967295 (0xFFFFFFFF) は、UID が適用されていないことを意味するため、すべてのユーザーに適用されます。
- アクション: 実行するアクションを表示します。 値は 受け入れ または 削除できます。
- インターフェイス IN 名: 入力インターフェイス名を表示します。 たとえば、 wlan0 です。
- インターフェイス OUT 名: 出力インターフェイス名を表示します。 たとえば、 wlan0 です。
- 状態: 接続状態を表示します。 値は none、 established、または related です。
- TCP マスク: TCP マスクの配列を表示します。 値は 、fin、 syn、 rst、 psh、 ack、 urg です。
- TCP Cmp: TCP フラグの配列を表示します。 値は urg、 ack、 psh、 rst、 syb、 fin です。
- TCP Inv: ブール値は、TCP フラグの感覚を反転させる必要があることを示します。 値は True または False です。
- プロトコル: ファイアウォール規則のプロトコルを表示します。 値は icmp、 igmp、 tcp、 udp です。
- 送信元ポート範囲: トラフィックを送信する送信元からのポート範囲を表示します。 値は 0 から 65535 の間で指定できます。
- 宛先ポート範囲: トラフィックを受信する宛先のポート範囲を表示します。 値は 0 から 65535 の間で指定できます。
- [パケット]: パケットの数を表示します。
- バイト数: バイト数を表示します。
フラグの概要を次に示します。
- URG: 緊急ポインター フィールドが有効
- ACK: 受信確認フィールドの有意性
- PSH: プッシュ関数
- RST: 接続をリセットする
- SYN: シーケンス番号を同期する
- FIN: 送信者からのデータはこれ以上ありません
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network list-firewall-rules
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
Ruleset IsValid SourceIp SourceMask DestinationIp DestinationMask UID Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes TcpMask TcpCmp
=====================================================================================================================================================================================================
PREROUTING False None None None None None None None None None None None None None None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False any 0-65535 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept True tcp 0-65535 0-65535 823 394754 syn,ack syn
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True 192.168.35.1 <value> <value> <value> <value> accept azspheresvc False any 0-65535 0-65535 15 780 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
network list-interfaces
接続されているデバイスのネットワーク インターフェイスをListsします。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network list-interfaces
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses ConnectedToInternet IpAssignment HardwareAddress
========================================================================================================================
azspheresvc True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
eth0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
lo True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
wlan0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
ネットワーク プロキシ
ネットワーク接続のプロキシ アドレスの使用を管理します。 プロキシ サーバー経由でインターネットに接続するように Azure Sphere デバイスを構成する方法の詳細については、「 プロキシ サーバー経由で接続する」を参照してください。
メモ
現在サポートされているのは HTTP プロキシのみです。
| 操作 | 説明 |
|---|---|
| プロキシの適用 | 接続されているデバイスでネットワーク プロキシを構成します。 |
| プロキシの削除 | 接続されているデバイス上のプロキシ接続を削除します。 |
| プロキシ ショー | 接続されているデバイス上のプロキシ接続を表示します。 |
プロキシの適用
接続されているデバイスでネットワーク プロキシを構成します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -a, --address | 文字列 | 使用するプロキシのネットワーク アドレスを指定します。 |
| -t、--authentication | 文字列 | 使用する認証の種類を指定します。 許可される値: anonymous または basic。 プロキシでユーザー名とパスワードが必要な場合は、 を に basic設定します。それ以外の場合は を使用 anonymousします。 |
| -r、--port | 整数 | 使用するネットワーク アドレスのポートを指定します。 値は 65535 以下である必要があります。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| --有効 | 文字列 | プロキシを有効にするかどうかを指定します。 または --disableを--enable設定する必要があります。 |
| --無効 | 文字列 | プロキシを無効にするかどうかを指定します。 または --disableを--enable設定する必要があります。 |
| -n、--no-proxy-addresses | 文字列 | プロキシ接続でデバイスが回避する必要があるスペース区切りのネットワーク アドレスの配列を指定します。 |
| -p、--password | 文字列 | 基本認証にのみ使用されるプロキシ認証のパスワードを指定します。 最大長: 64 文字。 |
| -u、--username | 文字列 | プロキシ認証のユーザー名を指定します。 基本認証にのみ使用されます。 最大長: 64 文字。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
プロキシの削除
接続されているデバイスのプロキシ接続を削除します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network proxy delete
プロキシ ショー
接続されているデバイス上のプロキシ接続を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network proxy show
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
network show-診断
接続されているデバイス上の 1 つまたはすべての Wi-Fi ネットワークの診断を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -n、--network | 整数 | 診断を表示する Wi-Fi ネットワークの ID を指定します。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network show-diagnostics
------------------------- --------- ----- ------------- --------------- --------
Timestamp NetworkId Ssid ConfigState ConnectionState Error
================================================================================
2021-06-16T20:51:29+00:00 0 <value> temp-disabled disconnected WrongKey
------------------------- --------- ----- ------------- --------------- --------
network show-status
接続されているデバイスのネットワーク状態を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network show-status
--------------------------- --------------- -----
DeviceAuthenticationIsReady NetworkTimeSync Proxy
=================================================
True complete ready
--------------------------- --------------- -----
network update-interface
デバイスのイーサネット ネットワーク インターフェイスを更新します。 デバイスの MAC アドレスの設定の詳細については、「イーサネット用に デバイスを構成する」を参照してください。
メモ
このコマンドは、イーサネット eth0 接続の構成でサポートされています。 または wlan0を構成loazspheresvcすると、エラーが返されます。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --hardware-address | 文字列 | デバイスに設定するハードウェア アドレスを、次のいずれかの形式で指定します。 AA:BB:33:DD:EE:FFaa:bb:33:dd:ee:ff |
| --インターフェイス または --interface-name [Retiring] |
文字列 | 構成するインターフェイスの名前を指定します。 azsphere device network list-interfaces を実行して、接続されているデバイスのネットワーク インターフェイスの詳細を表示します。 引数は --interface-name 廃止され、今後のリリースで削除される予定です。 詳細については、「 Azure Sphere CLI での重要な変更 (廃止機能)」を参照してください。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10
回復
デバイス上のシステム ソフトウェアを置き換えます。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 現在接続されているデバイスは、既定で使用されます。 デバイスの ID、IP アドレス、またはローカル接続 ID を指定します。 |
| -c、 --capability | 文字列 | 回復中にデバイスに適用するデバイス機能イメージを指定します。 |
| -i、--images | 文字列 | デバイスに書き込むイメージ パッケージを含むフォルダーへのパスを指定します。 既定では、このフラグで代替パスが指定されていない限り、回復では SDK 内のイメージが使用されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
例 1:
azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
例 2:
azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
再スキャン接続済み
接続されているデバイスを再スキャンし、すべての FTDI ポートの電源を入れ直し、接続されたデバイスの合計数を表示します。 Windows での デバイス接続の問題のトラブルシューティング を行う場合は、このコマンドを使用します。 このコマンドは Windows でのみ実行されます。
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device rescan-attached
-----------
Count
===========
2
-----------
再起動
接続されているデバイスを再起動します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device restart
Restarting device.
Device restarted successfully.
表示
Azure Sphere テナントに接続されているデバイスの詳細を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | コマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合、またはデバイスが接続されていない場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されていないデバイスのデバイス ID を指定することも、接続されているデバイスの IP アドレスまたはローカル接続 ID を指定することもできます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device show
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
パラメーターを --query 使用して、このコマンドに表示される出力をカスタマイズできます。 詳細については、「 クエリ CLI コマンドの出力」を参照してください。
次の例では、デバイス ID と製品 ID のみを選択する方法を示します。
azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
show-attached
デバイス自体から接続されているデバイスに関する情報を表示します。 これらの詳細は、Azure Sphere Security Service がデバイス用に格納しているものとは異なります。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143
show-deployment-status
デバイスのアプリケーションとオペレーティング システムの更新プログラムの展開状態を表示します。
このコマンドを使用して、デバイスが実行されている Azure Sphere OS のバージョン、または現在のデプロイ更新プログラムが完了しているかどうかを確認します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.
この例では、 <バージョン番号> は現在のオペレーティング システムのバージョンを表します。
show-count
現在のテナント内のデバイスの数を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device show-count
------
Result
======
2
------
show-os-version
接続されているデバイスの現在のオペレーティング システムのバージョンを表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>
この例では、 <バージョン番号> は現在のオペレーティング システムのバージョンを表します。
sideload
デバイス上のアプリケーションを管理します。
一部のサイドロード オプションでは、デバイスが製造状態の DeviceComplete になると、追加の機能が必要になります。 fieldServicing 機能を使用すると、一時的な運用署名付きイメージをデプロイおよび削除し、永続的な運用署名付きイメージをデプロイできます。 appDevelopment 機能を使用すると、運用署名済みイメージと SDK 署名済みイメージの両方をデプロイおよび削除できます。
| 操作 | 説明 |
|---|---|
| 削除 | デバイスから現在のアプリケーションを削除します。 |
| 展開 | デバイスにアプリケーションを読み込みます。 |
| set-deployment-timeout | デプロイのタイムアウト期間を秒単位で設定します。 |
| show-deployment-timeout | デプロイのタイムアウト期間を秒単位で表示します。 |
、 、 へのstartshow-quotastopshow-statusパラメーターは azsphere device app コマンドに移動されていることに注意してください。
sideload delete
デバイスからアプリケーションを削除します。
このコマンドは、 appDevelopment デバイス機能が構成されている場合にのみ使用できます。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--component-id | Guid | デバイスから削除するアプリケーションの ID を指定します。 省略すると、すべてのアプリケーションが削除されます。 |
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.
sideload deploy
接続されているデバイスにアプリケーションを読み込み、アプリケーションを起動します。
このコマンドは、アプリケーション マニフェストが、既にデバイス上にあるアプリケーションによって使用されているリソースを要求した場合に失敗します。 この場合は、 azsphere device sideload delete を使用して既存のアプリケーションを削除してから、もう一度サイドローディングを試してください。 azsphere device sideload delete コマンドは、高度なアプリケーションとリアルタイム アプリケーションの両方を削除します。 1 つのアプリケーションを削除し、もう一方のアプリケーションのままにするには、削除するアプリケーションのコンポーネント ID を指定します。
同じコマンドを使用して、高レベルアプリケーションとリアルタイム対応アプリケーションの両方をデプロイします。
メモ
周辺機器を使用する新しいアプリケーションがインストールされ、次の条件が満たされると、デバイスの再起動がトリガーされます。
- デバイスの製造状態は DeviceComplete に設定されます。
- appDevelopment 機能がデバイスに存在しません。 詳細については、「 周辺機器の構成のロック」を参照してください。
デバイスの再起動が開始された場合は、再起動が完了し、デバイスが応答するまで待ちます。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -p、--image-package | 文字列 | デバイスに読み込むイメージ パッケージのパスとファイル名を指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -m、--manual-start | ブール | 読み込み後にアプリケーションを自動的に起動しないように指定します。 |
| --力 | ブール | サポートされなくなったベータ API を使用するイメージのデプロイを強制します。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.
sideload set-deployment-timeout
デバイス上のイメージをサイドローディングするためのデプロイタイムアウト値を秒単位で設定します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -v、--value | 整数 | サイドロード コマンドがタイムアウトするまでの時間を秒単位で指定します。値は正の整数である必要があります。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device sideload set-deployment-timeout --value 60
------------------
Deployment timeout
==================
60
------------------
sideload show-deployment-timeout
デバイス上のイメージをサイドローディングするための現在の展開タイムアウト値を秒単位で表示します。
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device sideload show-deployment-timeout
------------------
Deployment timeout
==================
60
------------------
更新
Azure Sphere テナント内の別のデバイス グループにデバイスを移動します。
製品で作成するデバイス グループに加えて、製品の作成時に次の 5 つの既定のデバイス グループが追加されます。
- 開発: システム ソフトウェア更新プログラムのみを受け入れます。 アプリケーションの更新を受け入れない。
- フィールド テスト: Azure Sphere Security Service からのすべての更新プログラムを受け入れます。
- 運用: Azure Sphere Security Service からのすべての更新プログラムを受け入れます。
- 運用 OS 評価: Azure Sphere Security Service からのすべての更新プログラムを受け入れます。
- フィールド テスト OS 評価: Azure Sphere Security Service からのすべての更新プログラムを受け入れます。
デプロイに関連する基本的な要素の詳細については、「デプロイの 基本」を参照してください。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -g、--device-group | GUID または名前 | デバイスを移動するデバイス グループを指定します。 デバイス グループ ID またはデバイス グループ名を指定できます。 デバイス グループ名を使用するには、製品名とデバイス グループ名の両方を形式で指定する <product-name/device-group-name> 必要があります。 |
| -d、--device | 文字列 | コマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合、またはデバイスが接続されていない場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されていないデバイスのデバイス ID を指定することも、接続されているデバイスの IP アドレスまたはローカル接続 ID を指定することもできます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| -t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device update --device-group AW100/Marketing
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
==============================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
427D205E46A166B7E41135EB968
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
パラメーターを --query 使用して、このコマンドに表示される出力をカスタマイズできます。 詳細については、「 クエリ CLI コマンドの出力」を参照してください。
次の例では、デバイス ID と製品 ID のみを選択する方法を示します。
azsphere device update --device-group AW100/Marketing --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
Wifi
接続されているデバイスの Wi-Fi 構成を管理します。
Wi-Fi ネットワークでデバイスを使用するには、ネットワークに関する情報を追加し、デバイスでネットワークを有効にする必要があります。 SSD では ASCII 以外の文字を入力できますが、 azsphere では正しく表示されません。
アプリケーションで Wi-Fi 構成 API を使用する場合は、アプリケーションの app_manifest.json ファイルに WifiConfig 機能も含める必要があります。
| 操作 | 説明 |
|---|---|
| 追加 | ワイヤレス ネットワークの詳細をデバイスに追加します。 |
| 無効 | デバイスのワイヤレス ネットワークを無効にします。 |
| 有効 | デバイスでワイヤレス ネットワークを有効にします。 |
| 忘れて | デバイスからワイヤレス ネットワークの詳細を削除します。 |
| リスト | デバイスの現在の Wi-Fi 構成をListsします。 |
| reload-config | デバイス Wi-Fi 構成を再読み込みします。 |
| スキャン | 使用可能なネットワークをスキャンします。 |
| 表示 | Wi-Fi 構成の詳細を表示します。 |
| show-status | ワイヤレス インターフェイスの状態を表示します。 |
wifi add
接続されているデバイスに Wi-Fi ネットワークの詳細を追加します。
1 つのデバイスに複数の Wi-Fi 接続を設定できます。 SSD では ASCII 以外の文字を入力できますが、 azsphere では正しく表示されません。
パラメーターを --targeted-scan 含め、非表示の SSID に接続できます。 詳細については、「 Azure Sphere を Wi-Fi に接続する」を参照してください。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -s、--ssid | 文字列 | ネットワークの SSID を指定します。 ネットワーク SSID では、大文字と小文字が区別されます。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| --client-cert-id | 文字列 | [EAP-TLS]クライアント証明書 (公開キーと秘密キーの両方を含む) を識別する識別子 (最大 16 文字) を指定します。 EAP-TLS ネットワークを設定するために必要です。 |
| --client-id <user@domain> | 文字列 | [EAP-TLS]ネットワークの RADIUS サーバーによる認証で認識される ID を指定します。 一部の EAP-TLS ネットワークに必要です。 |
| --config-name | 文字列 | ネットワーク構成の名前を指定する文字列 (最大 16 文字) を指定します。 |
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
| --root-ca-cert-id | 文字列 | [EAP-tLS]デバイスがサーバーを認証する EAP-TLS ネットワークのサーバーのルート CA 証明書を識別する識別子 (最大 16 文字) を指定します。 |
| --targeted-scan | ブール | ネットワークがブロードキャストされていない場合や、ネットワークの輻輳によって非表示になっている場合でも、ネットワークへの接続を試みます。 |
| -p、--psk | 文字列 | 新しいネットワークの WPA/WPA2 キーを指定します。 [省略] を選択して、SSID を開いているネットワークとして追加します。 キーにアンパサンド (&) が含まれている場合は、キーを引用符で囲みます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
1 MyNetwork enabled unknown psk False
----- -------- ------------------ --------------- ------------- ------------
ネットワーク SSID またはキーにスペースまたはアンパサンドが埋め込まれている場合は、SSID またはキーを単一引用符で囲みます。 SSID またはキーに引用符が含まれている場合は、円記号を使用して引用符をエスケープします。 円記号は、値の一部である場合はエスケープする必要はありません。 詳細については、「 引用符とエスケープ文字」を参照してください。 例えば：
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
Wifi を無効にする
接続されているデバイス上の Wi-Fi ネットワークを無効にします。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--id | 整数 | 無効にするネットワークの ID を指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork disabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
Wifi の有効化
接続されているデバイスで Wi-Fi ネットワークを有効にします。
両方が範囲内にある場合に 1 つのネットワークから別のネットワークに変更するには、新しいネットワークを有効にする前に、現在接続されているネットワークを無効にします。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--id | 整数 | 有効にするネットワークの ID を指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi enable --id 0
Successfully enabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork enabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
Wifi の忘れ
接続されているデバイスから Wi-Fi ネットワークの詳細を削除します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--id | 整数 | 削除するネットワークの ID を指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi forget --id 0
Successfully forgotten network.
wifi リスト
接続されているデバイスの現在の Wi-Fi 構成をListsします。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi list
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork1 enabled connected psk False
----- --------- ------------------ --------------- ------------- ------------
1 MyNetwork2 enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
2 MyNetwork3 enabled disconnected eaptls False
----- --------- ------------------ --------------- ------------- ------------
wifi reload-config
接続されているデバイスの Wi-Fi ネットワーク構成を再読み込みします。 証明書 (azsphere デバイス証明書) を追加または削除した後、このコマンドを使用して、EAP-TLS ネットワークで証明書ストアの最新の内容が使用されるようにします。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.
wifi スキャン
接続されているデバイスに表示される使用可能な Wi-Fi ネットワークをスキャンします。 コマンドは最大 64 Wi-Fi ネットワークを返しますが、表示される Wi-Fi ネットワークの数は、範囲内のアクセス ポイントの密度などの環境要因によって制限される場合があります。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID SecurityState BSSID SignalLevel Frequency
=======================================================================
MyNetwork0 psk <value> -66 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1 psk <value> -75 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2 psk <value> -86 2412
----------------- ------------- ----------------- ----------- ---------
wifi ショー
接続されているデバイス上の Wi-Fi ネットワークの詳細を表示します。
必須パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -i、--id | 整数 | 表示するネットワーク構成の ID を指定します。 |
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi show --id 0
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
wifi show-status
接続されているデバイスの Wi-Fi インターフェイスの状態を表示します。
省略可能なパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| -d、--device | 文字列 | 複数のデバイスが接続されている場合にコマンドを実行するデバイスを指定します。 このパラメーターは、複数のデバイスが接続されている場合に必要です。 現在接続されているデバイスは、既定で使用されます。 接続されているデバイスのデバイス ID、IP アドレス、またはローカル接続 ID を指定できます。 Azure Sphere CLI では、Windows 上の複数の MT3620 デバイスがサポートされていますが、Linux では一度に 1 つのデバイスのみを接続できます。 このため、このパラメーターは Windows ではサポートされますが、Linux ではサポートされません。 Linux の コマンドでこのパラメーターを使用すると、エラーが返されます。 |
グローバル パラメーター
Azure Sphere CLI では、次のグローバル パラメーターを使用できます。
| パラメーター | 説明 |
|---|---|
| --デバッグ | ログ記録の詳細度を増やして、すべてのデバッグ ログを表示します。 バグが見つかる場合は、バグ レポートを送信するときに、 フラグを --debug 使用して生成された出力を指定します。 |
| -h、--help | コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。 |
| --only-show-errors | エラーのみを表示し、警告を抑制します。 |
| -o、--output | 出力形式を変更します。 使用可能な出力形式は、json、jsonc (色付けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は を出力します table。 使用可能な出力形式の詳細については、「 Azure Sphere CLI コマンドの出力形式」を参照してください。 |
| --クエリ | JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、「 JMESPath チュートリアル 」および 「Azure CLI コマンド出力のクエリ 」を参照してください。 |
| --詳細 | 操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログに使用 --debug します。 |
メモ
Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、「 グローバル パラメーター 」を参照してください。
例
azsphere device wifi show-status
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress
================================================================================================================================
<value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------