Dokumentation zur Befehlszeilenschnittstelle (CLI)
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.
Die empfohlene Node.js Version ist 12 oder höher.
Öffnen Sie eine Terminal-/Eingabeaufforderung, und führen Sie sie aus npm install -g appcenter-cli
.
- Öffnen Sie ein Terminal-/Befehlsfenster.
- Führen Sie
appcenter login
aus. Dadurch wird ein Browser geöffnet und ein neuesAPI token
generiert. - Kopieren Sie den
API token
Browser, und fügen Sie ihn in das Befehlsfenster ein. - Das Befehlsfenster wird angezeigt
Logged in as {user-name}
. - 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
- Erstellen eines
Full Access
API-Tokens (siehe Schritte 1-5). - Öffnen Sie ein Terminal-/Befehlsfenster.
- Fügen Sie den
--token
Schalter zum CLI-Befehl hinzu, den Sie ausführen. Führen Sie beispielsweise die Ausführungappcenter 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.
- Öffnen Sie ein Terminal-/Befehlsfenster.
- Führen Sie die Ausführung
appcenter
aus, um eine Liste der CLI-Befehle anzuzeigen. - 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.
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"