イメージ
ディスク上の Azure Sphere イメージを管理します。
操作 | 説明 |
---|---|
追加 | 新しいイメージをアップロードします。 |
ダウンロード | イメージをダウンロードします。 |
表示 | 指定したイメージに関する情報を表示します。 |
追加
Azure Sphere テナントに新しいイメージをアップロードします。
必須パラメーター
パラメーター | 型 | 説明 |
---|---|---|
--イメージ | 文字列 | アップロードするイメージへのパスを指定します。 |
省略可能なパラメーター
パラメーター | 型 | 説明 |
---|---|---|
-t、--tenant | GUID または名前 | この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。 |
--一時 | ブール | イメージ パッケージを一時的なものとしてマークします。 このパラメーターは、製造プロセス中に使用することを目的としています。 |
--力 | ブール | ベータ API を使用してイメージのアップロードを強制します。 |
-r、--regional-data-boundary | 文字列 | このイメージの地域データ境界。 許可される値: EU 、 None 。 既定値は です None 。 値が指定されていない場合、既定値が使用されます。 詳細については、「クラッシュ ダンプの構成 - Pivacy に関する考慮事項」を参照してください。 |
グローバル パラメーター
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 image add --image C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage --temporary
Uploading image from file 'C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage':
--> Image ID: d788fdd1-28eb-4477-9818-a4734289f2f1
--> Component ID: 99d419ef-296d-43b0-ade1-809efe3a7aba
--> Component name: 'QuickStart-AzureSphereBlink1'
Retaining temporary state for uploaded image.
Successfully uploaded image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1' and name 'QuickStart-AzureSphereBlink1' to component with ID '99d419ef-296d-43b0-ade1-809efe3a7aba'.
ダウンロード
Azure Sphere テナントから既存のイメージをダウンロードします。
必須パラメーター
パラメーター | 型 | 説明 |
---|---|---|
-i、--image | 文字列 | ダウンロードするイメージの ID を指定します。 azsphere image add コマンドを実行して、イメージ ID を取得します。 |
--先 | 文字列 | イメージを保存するパスとファイル名を指定します。 ファイル パスには、絶対パスまたは相対パスを指定できます。 |
省略可能なパラメーター
パラメーター | 型 | 説明 |
---|---|---|
-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 image download --image d788fdd1-28eb-4477-9818-a4734289f2f1 --destination AzureSphereBlink1.image
Getting the image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
---------
Result
=========
Succeeded
---------
表示
Azure Sphere テナントからの既存のイメージの詳細を表示します。
必須パラメーター
パラメーター | 型 | 説明 |
---|---|---|
-i、--image | Guid | 詳細を取得するイメージの ID を指定します。 azsphere image add コマンドを実行して、イメージ ID を取得します。 |
省略可能なパラメーター
パラメーター | 型 | 説明 |
---|---|---|
-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 image show --image d788fdd1-28eb-4477-9818-a4734289f2f1
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------ ---------------------
ImageId ComponentId Name SigningStatus ImageType RegionalDataBoundary
========================================================================================================================================================
d788fdd1-28eb-4477-9818-a4734289f2f1 99d419ef-296d-43b0-ade1-809efe3a7aba QuickStart-AzureSphereBlink1 Succeeded Applications None
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------ ---------------------