共用方式為

Azure Sphere CLI 互動式模式 （預覽）

  • 發行項

重要

這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。

Azure Sphere CLI 支援互動式模式，其提供執行 Azure Sphere CLI 命令的互動式環境，非常適合學習 CLI 功能、命令結構和輸出格式的新使用者。 您可以使用 PowerShell、Windows 命令提示字元或 Bash 殼層，在命令行介面中使用 azsphere interactive 命令啟動互動式模式。 命令提示字元會變更為 azsphere>> ，表示您現在正在互動式殼層中執行命令。

Azure Sphere 互動式模式

重要

此功能處於預覽。 未來版本中可能會變更或移除。

設定

互動式模式選擇性地顯示命令描述、參數描述和命令範例。

選項 描述
F1 開啟或關閉描述和範例。
F2 開啟或關閉參數預設值的顯示。
F3 切換某些按鍵手勢的顯示。
[Ctrl+D] 結束互動式模式。

Azure Sphere 互動式模式 F1

集合範圍

互動式模式可讓您將命令範圍設定為特定命令群組。 如果您只想要使用 device certificate 命令，您可以使用下列命令來設定正確的範圍，讓不需要 device certificate 輸入所有後續命令。

例如，當您將範圍設定為 %%device certificate時：

azsphere>> %%device certificate
defaulting: device
defaulting: certificate
azsphere device certificate>>

若要移除範圍輸入， $ %% .. 並移除所有範圍，請輸入 %%。

範例

當您輸入命令時，互動式模式會列出某些命令的內容相關範例。 如果命令有太多範例無法放入終端機視窗，您可以透過分別使用 CTRL+Y 和 CTRL+N 捲動範例窗格來查看所有範例，以取得 'up' 和 'down'。

互動式模式提供多種方式來建立和執行命令。 範例窗格中會指出範例編號。 您可以在範例窗格中選取要檢視的特定專案。 例如：

Azure Sphere 互動式模式：多種方式

自動完成

互動式模式會顯示輸入命令的結果。 它提供自動完成下拉式清單框、自動快取的建議，以及動態檔，包括如何使用每個命令的範例。 --enable-rt-core-debugging、、、、、、--tenant--type--temporary--style--role--product--targeted-scan--state--manual-start--os-feed--none--force--full 與 --user 參數都支援--application-update--debug-mode參數值完成。 --device-group--device

Azure Sphere 互動式模式：自動完成

常用命令

互動式模式會追蹤先前類型的命令和最常使用的命令。 命令會在命令提示字元介面中輸入初始字元時顯示。

結束代碼

選項 $ 可讓您查看最後一個執行命令的結束代碼，以確認其已正確執行。 例如：

azsphere>> $
Success: 0

互動式模式以外的命令

Azure Sphere CLI 互動式模式可讓使用者在 Azure Sphere CLI 外部執行命令，而不需要在命令行介面中使用 結束互動式模式 #[command] 。 例如：

azsphere>> #git --version
git version 2.28.0.windows.1

查詢上一個命令

您可以在使用 執行的最後一個命令 ?? 結果上執行 JMESPath 查詢，後面接著 JMESPath 查詢。 例如，列出所有產品之後，您可以執行查詢，只列出產品名稱。

azsphere>> azsphere product list
 ------------------------------------ ------------------------------------ --------------- --------------------
 Id                                   TenantId                             Name            Description
 ==============================================================================================================
 a2cd64be-adc2-4bfd-8f34-7d8c90293893 143adbc9-1bf0-4be2-84a2-084a331d81cb MyFridgeProduct None
 ------------------------------------ ------------------------------------ --------------- --------------------
 e5fe65f7-0df5-481e-9f4c-44b1a00d2d60 143adbc9-1bf0-4be2-84a2-084a331d81cb CoffeeMaker     None
 ------------------------------------ ------------------------------------ --------------- --------------------

jmespath 查詢的輸出會是：

azsphere>> ??"[].{Productname:name}"
[
  {
    "Productname": "MyFridgeProduct"
  },
  {
    "Productname": "CoffeeMaker"
  }
]