共用方式為


Azure 球體 CLI 概觀

Azure 球體 CLI 是用來管理 Azure 球體資源的一組命令。

下列命令可供使用:

Azure 球體 CLI 和 Azure 球體傳統 CLI

Azure 球體 CLI 與 Windows 和 Linux 上現有的 CLI 一起安裝,因此您可以存取這兩個介面。 Azure 球體傳統 CLI 會如往常一樣繼續運作。

若要使用 Azure 球體 CLI:

  • 在 Windows 上,使用 PowerShell 或標準 Windows 命令提示字元。
  • 在 Linux 上,使用任何命令殼層。 如果您在安裝 SDK 時將 Azure 球體 CLI 設為預設值,請指定 azsphere 命令;如果您將 Azure 球體傳統 CLI 設為預設值,則指定 azsphere_v2 命令。

如需 Azure 球體 CLI 支援之功能和命令的詳細資料,請參閱 Azure 球體 CLI。

重要

  • 在 Windows 上,淘汰的 Azure 球體傳統開發人員命令提示 字元快速鍵只能與 Azure 球體傳統 CLI 搭配使用。

命令列格式

azsphere 命令列具有下列格式:

azsphere [command] [subcommand] operation [parameters]

一般說來, 命令子命令 都是名詞, 而運 算則是動詞,因此組合會同時識別動作和動作的物件。 大部分的命令和作業都有全名和縮寫。 例如, 裝置 命令是縮寫 d

大部分 的參數 都具有長名稱和縮寫。 在命令列上,以雙連字號介紹長名稱,並以單一連字號介紹縮寫。 例如,下列兩個命令相等:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey
azsphere device wifi add -s MyNetwork -p mynetworkkey

某些命令允許單一參數使用多個值。 在 Azure 球體 CLI 中,您可以提供單一參數,後面接著以空格分隔的值清單,而在 Azure 球體傳統 CLI 中,值清單會以逗號分隔。 例如:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

引號和逸出字元

當您使用 Azure 球體 CLI 命令時,請注意殼層如何使用引號和逸出字元。 如果您支援用於不同殼層的腳本,您必須瞭解它們的差異。

例如:

雲端相依的命令

下列 azsphere 命令需要雲端連線並登入 Azure 球體安全性服務:

  • ca-certificate
  • device-group
  • get-support-data
  • 圖像
  • 登錄
  • 登出
  • 產品
  • register-user
  • 作用
  • show-user
  • 租戶

此外,下列 azsphere 裝置 命令也需要雲端連線:

azsphere 裝置 命令 評論
能力 需要 Azure 球體安全性服務以下載裝置功能
索賠
enable-cloud-test
enable-development
圖像
清單
恢復 需要網際網路連線,但不登入 Azure 球體安全性服務
顯示
show-count
show-deployment-status
show-os-version 需要網際網路連線,但不登入 Azure 球體安全性服務
更新

裝置功能相依的命令

下列azsphere 裝置命令需要在製造狀態DeviceComplete的裝置上使用裝置功能

操作 描述
應用程式 在連接的裝置上管理應用程式。
能力 管理裝置功能設定。 功能 更新的必要專案
證書 管理裝置證書存放區。
圖像 管理裝置影像。
製造狀態 管理附加裝置的製造狀態。 製造 狀態更新的必要專案
重新 啟動 重新開機連接的裝置。
show-deployment-status 顯示附加裝置上作業系統和應用程式的部署狀態。
show-os-version 在附加的裝置上顯示作業系統版本。
側載 在連接的裝置上部署和管理應用程式。 需要 側載部署側載刪除
無線 管理附加裝置的 Wi-Fi 設定。

如果您嘗試在沒有功能的情況下執行這些命令,您會收到錯誤訊息,告訴您執行 azsphere device enable-development 或用來 azsphere device capability 下載及選取裝置的功能檔案。