Teilen über

Dokumentation zur Befehlszeilenschnittstelle (CLI)

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis sie vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie die Migration in Betracht ziehen können.

Erfahren Sie mehr über die Fristen für den Support sowie über mögliche Alternativen.

Die Befehlszeilenschnittstelle von App Center ist ein einheitliches Tool zum Ausführen von App Center-Diensten über die Befehlszeile. Die CLI ist ein leistungsstarkes Tool für die Verwendung von App Center-Diensten und Skripting einer Sequenz von Befehlen, die ausgeführt werden sollen. Sie können sich derzeit anmelden und anzeigen oder alle Apps konfigurieren, auf die Sie im App Center zugreifen können.

Weitere Informationen zur CLI-Installation und derzeit unterstützten Befehlen finden Sie unter App Center CLI GitHub-Repository.

Erste Schritte

Voraussetzungen

Die empfohlene Node.js Version ist 12 oder höher.

Installation

Öffnen Sie eine Terminal-/Eingabeaufforderung, und führen Sie sie aus npm install -g appcenter-cli.

Anmelden

  1. Öffnen Sie ein Terminal-/Befehlsfenster.
  2. Führen Sie appcenter login aus. Dadurch wird ein Browser geöffnet und ein neues API tokengeneriert.
  3. Kopieren Sie den API token Browser, und fügen Sie ihn in das Befehlsfenster ein. Abbildung des Browsertokens
  4. Das Befehlsfenster wird angezeigt Logged in as {user-name}. Abbildung der Terminalanmeldung
  5. Herzlichen Glückwunsch! Sie sind erfolgreich angemeldet und können CLI-Befehle ausführen.

Es gibt zwei Möglichkeiten zum Verwenden von App Center CLI-Befehlen ohne vorherige Ausführung appcenter login :

Verwenden des --token Parameters

  1. Erstellen eines Full Access API-Tokens (siehe Schritte 1-5).
  2. Öffnen Sie ein Terminal-/Befehlsfenster.
  3. Fügen Sie den --token Schalter zum CLI-Befehl hinzu, den Sie ausführen. Führen Sie beispielsweise die Ausführung appcenter apps list --token {API-token} aus, um eine Liste Ihrer konfigurierten Anwendungen abzurufen.

Mit der APPCENTER_ACCESS_TOKEN Umgebungsvariable können Sie die APPCENTER_ACCESS_TOKEN Umgebungsvariable mit Ihrem API-Token festlegen. Dies funktioniert, ohne den --token Switch an jeden CLI-Befehl anzufügen.

Ausführen des ersten CLI-Befehls

  1. Öffnen Sie ein Terminal-/Befehlsfenster.
  2. Führen Sie die Ausführung appcenter aus, um eine Liste der CLI-Befehle anzuzeigen.
  3. Führen Sie diese Schritte appcenter profile list aus, um die Informationen zum angemeldeten Benutzer abzurufen.

Weitere Informationen zu einer Liste von CLI-Befehlen finden Sie unter App Center CLI GitHub-Repository.

Hinweis zur Verwendung des --app Parameters:

Aufgrund von Einschränkungen bei der Analyse von App-Namen dürfen Anwendungsnamen nicht mit Bindestrichen oder anderen mehrdeutigen Zeichen beginnen, die GNU-Stilparser verwirren können. Weitere Informationen hierzu finden Sie im zugehörigen CLI-Problem.

Verwenden eines Proxys

Sie können CLI über einen Proxy verwenden. Dazu müssen Sie die Umgebungsvariable mit Proxyadresse einrichten npm config und angeben. Beachten Sie, dass Proxyadressen mit Protokollen angegeben werden sollen (z. B http://. ).

NPM-Konfiguration

Zum Einrichten der Proxyverwendung in npm müssen Sie Befehle ausführen:

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

Umgebungsvariable

So richten Sie den Befehl "Umgebungsvariable ausführen" ein:

Bash:

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

PowerShell:

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