Command-Line 介面（CLI）文件

這很重要

Visual Studio App Center 於 2025 年 3 月 31 日淘汰，但分析和診斷功能除外，這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。

App Center 命令行介面是統一的工具，可從命令行執行 App Center 服務。 CLI 是一個功能強大的工具，可用來使用 App Center 服務和編寫一連串要執行的命令腳本。 您目前可以在 App Center 中登入和檢視或設定所有可存取的應用程式。

若要取得 CLI 安裝和目前支援命令的詳細資訊，請參閱 App Center CLI GitHub 存放庫。

入門指南

先決條件

建議 Node.js 版本號為 12 或更高。

安裝

開啟終端機/命令提示字元，然後執行 npm install -g appcenter-cli。

登入

1. 開啟終端機/命令視窗。
2. 執行 appcenter login。 這會開啟瀏覽器並產生新的 API token。
3. API token從瀏覽器複製 ，並貼到命令視窗中。
4. 命令視窗會顯示 Logged in as {user-name}。
5. 祝賀！ 您已成功登入，而且可以執行 CLI 命令。

有兩種方式可以在不先執行 appcenter login 的情況下使用 App Center CLI 命令：

使用--token參數

1. 建立 Full AccessAPI 令牌 （請參閱步驟 1-5）。
2. 開啟終端機/命令視窗。
3. 將 --token 切換新增至您正在執行的 CLI 命令。 例如，執行 appcenter apps list --token {API-token} 以取得已設定的應用程式清單。

APPCENTER_ACCESS_TOKEN使用環境變數 您可以使用 API 令牌來設定APPCENTER_ACCESS_TOKEN環境變數。 此功能可運作，無需將 --token 參數附加到每個 CLI 命令。

執行您的第一個 CLI 命令

1. 開啟終端機/命令視窗。
2. 執行 appcenter 以查看 CLI 命令的清單。
3. 執行 appcenter profile list 以取得登入使用者的相關信息。

如需 CLI 命令列表的詳細資訊，請參閱 App Center CLI GitHub 存放庫。

關於使用 參數的 --app 附註：

由於應用程式名稱剖析方式的限制，應用程式名稱不得以連字元或其他混淆 GNU 樣式剖析器的模棱兩可字元開頭。 您可以在相關聯的 CLI 問題中深入瞭解此問題。

使用代理伺服器

您可以透過 Proxy 使用 CLI。 為此，您必須使用 Proxy 位址來設定 npm config 及指定環境變數。 請注意，應該使用通訊協定來指定 Proxy 位址（例如 http://）。

NPM 組態

若要在 npm 中設定 Proxy 使用量，您需要執行命令：

npm config set proxy http://username:password@host:port
npm config set https-proxy http://username:password@host:port

環境變數

若要設定環境變數執行命令：

Bash：

export HTTP_PROXY="http://host:port"

PowerShell：

$Env:HTTP_PROXY="http://host:port"