Azure 球體 CLI 概觀
Azure 球體 CLI 是用來管理 Azure 球體資源的一組命令。
下列命令可供使用:
- ca-certificate
- 裝置
- device-group
- 回饋
- get-support-data
- 硬體定義
- 圖像
- image-package
- 互動式 (命令處於預覽)
- 登錄
- 登出
- 產品
- register-user
- 作用
- show-user
- show-version
- 設置
- 租戶
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 命令時,請注意殼層如何使用引號和逸出字元。 如果您支援用於不同殼層的腳本,您必須瞭解它們的差異。
例如:
- Bash: 引用
- PowerShell: 關於引用規則
- Windows 命令提示字元: 使用方法:Windows 命令列的逸出字元、分隔符號和引號
雲端相依的命令
下列 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
下載及選取裝置的功能檔案。