Dokumentation zum Command-Line Interface (CLI)

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

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.

Einrichtung

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

Anmelden

1. Öffnen Sie ein Terminal-/Befehlsfenster.
2. Führen Sie appcenter login aus. Dadurch wird ein neuer Browser geöffnet und ein neues API token generiert.
3. Kopieren Sie API token aus dem Browser und fügen Sie es in das Befehlsfenster ein.
4. Im Befehlsfenster wird Logged in as {user-name} angezeigt.
5. 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 AccessAPI-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 in der zugehörigen CLI-Frage.

Verwenden eines Proxys

Sie können CLI über einen Proxy verwenden. Dazu müssten Sie npm config einrichten und die Umgebungsvariable mit der Proxyadresse festlegen. 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:

Schlagen:

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

PowerShell:

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