image-package
管理磁片上的 Azure 球體影像。
| 操作 | 描述 |
|---|---|
| pack 應用程式 | 建立圖像套件。 |
| pack-board-config | 建立版面設定圖像套件。 |
| 顯示 | 顯示圖像套件的詳細資料。 |
pack 應用程式
從編譯和連結的影像以及 app_manifest.json 檔案建立可執行檔應用程式。
RTApps) (適用的即時應用程式是以 ELF 或 AXF 檔案的形式建置，而非原始二進位檔。 封裝 RTApp 之前，請先編輯應用程式資訊清單檔案，讓 ApplicationType 設定為 「RealTimeCapable」，而 EntryPoint 則設定為 ELF 或 AXF 檔案的名稱，而這些名稱必須位於應用程式目錄的根目錄中。
提示
當您使用 Visual Studio Code 或 Visual Studio 建置高階應用程式或支援即時應用程式時，就會執行此命令。
- 組建程式會建立 App < 名稱 > 目錄，這是參數中指定的
--package-directory輸入目錄。 - 應用程式資訊清單檔案會在參數中
--application-manifest提供。 - 對於高階應用程式，參數中
--target-api-set會提供應用程式執行時間版本。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | 影像套件路徑 | 指定輸出映射套件的路徑和檔案名。 |
| --package-directory | approot_folder路徑 | 識別輸入目錄，此目錄是用來做為 Azure 球體影像檔的系統根目錄。 應用程式的 app_manifest.json 檔案必須在此目錄中。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -a， --application-manifest | 字串 | 指定應用程式資訊清單檔案的路徑。 這可以是 JSON 檔案或包含 app_manifest.json 的目錄。 您可以提供相對或絕對路徑。 |
| --hardware-definitions | 字串 | 指定包含硬體定義 (JSON) 檔案之目錄的選用空格分隔路徑清單。 檔案中的值會用來將 app_manifest.json 中的周邊名稱對應至基礎值。 您可以提供相對或絕對路徑。 如需詳細資訊，請參閱 硬體定義 。 |
| --target-api-set | 字串 | 指定編譯期間所使用的目標 API 集名稱。 如果應用程式資訊清單中未指定高階應用程式，則需要使用。 RTApps 不需要。 |
| --target-definition-filename | 字串 | 指定用來對應 app_manifest.json 中周邊名稱的硬體目標定義檔名稱。 如果應用程式使用硬體定義，則必須提供它。 |
| -x、--executables | executable1，executable2 ... | 指定一個或多個檔案的路徑，以在影像套件中標示為可執行檔。 app_manifest檔案中所列的 EntryPoint 一律標示為可執行檔，因此必須有其他可執行檔才能使用 -x 標幟。 根據預設，封裝至影像時無法執行檔案。 子路徑相對於可執行檔的路徑。 路徑可以使用 Windows 檔案名語法 (反斜線) 或 Linux 檔案名語法 (斜線) ;不允許空格、逗號和分號。 您可以為每個可執行檔指定 -x，或只使用一次，並提供多個以逗號分隔的路徑，而不需要中間空格。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
建立版面設定圖像套件。 您可以使用預設的版面設定映射或提供自訂設定映射。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | 字串 | 指定結果圖像套件的輸出檔案名路徑。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --board-config-file | 路徑 | 識別白板設定圖像的路徑。 如果這包含在內， --preset 則不可使用;這兩個參數互斥。 |
| -n， --name | 字串 | 在建立的檔案中繼資料中設定圖像套件名稱。 如果沒有提供，將會根據提供的面板設定產生新名稱，並結合元件識別碼的一部分以獲得唯一性。 |
| -p， --preset | 字串 | 提供要套用之預設面板設定圖像的識別碼。 輸入預設套件的識別碼，或使用 --board-config-file 自訂版面設定映射的參數提供版面設定檔案的路徑。 識別碼是列舉值，目前已修正為單一值 lan-enc28j60-isu0-int5 。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
顯示
顯示圖像套件的相關資訊。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -f， --image-package | 字串 | 指定圖像套件的路徑。 您可以提供相對或絕對路徑。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere image-package show --image-package C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage
Image package metadata:
Section: Identity
Image Type: Application
Component ID: 99d419ef-296d-43b0-ade1-809efe3a7aba
Image ID: d788fdd1-28eb-4477-9818-a4734289f2f1
Section: Signature
Signing Type: ECDsa256
Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5df0
Section: Debug
Image Name: QuickStart-AzureSphereBlink1
Built On (UTC): 09/07/2020 13:18:52
Built On (Local): 09/07/2020 14:18:52
Section: Temporary Image
Remove image at boot: False
Under development: True
Section: ABI Depends
Depends on: ApplicationRuntime, version 5