共用方式為

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 下載及選取裝置的功能檔案。