Erste Schritte mit Azure DevOps CLI
Azure DevOps Services
Mit der Azure DevOps-Erweiterung für die Azure-Befehlszeilenschnittstelle (Command Line Interface, CLI) können Sie viele Azure DevOps Services über die Befehlszeile verwalten. CLI-Befehle ermöglichen es Ihnen, unter Umgehung von Benutzeroberflächenworkflows Ihre Aufgaben mit schnellerem und flexiblem interaktivem Canvas zu optimieren.
Hinweis
Die Befehlszeilenschnittstelle (Cli) von Azure DevOps ist nur für die Verwendung mit Azure DevOps Services verfügbar. Die Azure DevOps-Erweiterung für die Azure CLI unterstützt keine Version von Azure DevOps Server.
Um mit der Verwendung der Azure DevOps-Erweiterung für Azure CLI zu beginnen, führen Sie die folgenden Schritte aus:
Azure CLI installieren: Befolgen Sie die Anweisungen unter Installieren der Azure CLI, um Ihre Azure CLI-Umgebung einzurichten. Ihre Azure CLI-Version muss mindestens 2.10.1 lauten. Sie können
az --version
verwenden, um dies zu überprüfen.Die Azure DevOps-Erweiterung hinzufügen:
az extension add --name azure-devops
Sie können
az extension list
oderaz extension show --name azure-devops
verwenden, um die Installation zu bestätigen.Anmelden: Führen
az login
Sie aus, um sich anzumelden. Beachten Sie, dass wir nur die interaktive Anmeldung mit Benutzername und Kennwort mittelsaz login
unterstützen. Informationen zum Anmelden mit einem persönlichen Zugriffstoken (PAT) finden Sie unter Anmelden mit einem persönlichen Azure DevOps-Zugriffstoken (PAT).
Hinweis
Die Azure DevOps-Erweiterung unterstützt derzeit keine Authentifizierung mit verwalteten Identitäten.
Standardeinstellungen konfigurieren: Es wird empfohlen, dass Sie die Standardkonfiguration für Ihre Organisation und Ihr Projekt festlegen. Andernfalls können Sie diese im Rahmen der einzelnen Befehle selbst festlegen.
az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp
Befehlssyntax
Durch das Hinzufügen der Azure DevOps-Erweiterung werden die Gruppen devops
, pipelines
, artifacts
, boards
und repos
hinzugefügt.
Syntax- und Hilfeinhalte zu jedem Befehl erhalten Sie, indem Sie den Parameter -h eingeben, z. B.:
az devops -h
Group
az devops : Manage Azure DevOps organization level operations.
Related Groups
az pipelines: Manage Azure Pipelines
az boards: Manage Azure Boards
az repos: Manage Azure Repos
az artifacts: Manage Azure Artifacts.
Subgroups:
admin : Manage administration operations.
extension : Manage extensions.
project : Manage team projects.
security : Manage security related operations.
service-endpoint : Manage service endpoints/service connections.
team : Manage teams.
user : Manage users.
wiki : Manage wikis.
Commands:
configure : Configure the Azure DevOps CLI or view your configuration.
feedback : Displays information on how to provide feedback to the Azure DevOps CLI team.
invoke : This command will invoke request for any DevOps area and resource. Please use
only json output as the response of this command is not fixed. Helpful docs -
https://zcusa.951200.xyz/rest/api/azure/devops/.
login : Set the credential (PAT) to use for a particular organization.
logout : Clear the credential for all or a particular organization.
Öffnen von Elementen im Browser
Mit dem Switch --open
können Sie ein beliebiges Artefakt im Azure DevOps-Portal in Ihrem Standardbrowser öffnen.
Beispiel:
az pipelines build show --id 1 --open
Dieser Befehl zeigt die Details des Builds mit id 1
in der Befehlszeile an und öffnet sie auch im Standardbrowser.