英語で読む

次の方法で共有


コマンド ライン インターフェイス (CLI) のドキュメント

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替方法の詳細をご確認ください

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 コマンドを使用するには、次の 2 つの方法があります。

--token パラメーターの使用

  1. Full Access API トークンを作成します (手順 1 から 5 を参照)。
  2. ターミナル/コマンド ウィンドウを開きます。
  3. --token スイッチを、実行中の CLI コマンドに追加します。 たとえば、 appcenter apps list --token {API-token} を実行して、構成済みのアプリケーションの一覧を取得します。

APPCENTER_ACCESS_TOKEN環境変数を使用して環境変数を API トークンで設定できます。 これは、各 CLI コマンドに --token スイッチを追加する必要なく機能します。

最初の CLI コマンドの実行

  1. ターミナル/コマンド ウィンドウを開きます。
  2. appcenterを実行して、CLI コマンドの一覧を表示します。
  3. appcenter profile listを実行して、ログインしているユーザーに関する情報を取得します。

CLI コマンドの一覧の詳細については、 App Center CLI GitHub リポジトリを参照してください。

--app パラメーターの使用に関する注意事項:

アプリ名の解析方法に制限があるため、アプリケーション名は、GNU スタイルパーサーを混乱させる可能性のあるハイフンやその他のあいまいな文字で始めてはなりません。 詳細については、関連する CLI の問題を参照してください。

プロキシの使用

プロキシを介して CLI を使用できます。 そのためには、 npm config を設定し、プロキシ アドレスを使用して環境変数を指定する必要があります。 プロキシ アドレスはプロトコル ( http:// など) で指定する必要があることに注意してください。

NPM 構成

npm でプロキシの使用を設定するには、コマンドを実行する必要があります。

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"