Installieren der Azure CLI mit aptInstall Azure CLI with apt

Wenn Sie eine Distribution mit apt verwenden (etwa Ubuntu oder Debian), steht ein x86_64-Paket für die Azure CLI zur Verfügung.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's an x86_64 package available for the Azure CLI. Dieses Paket wurde mit folgenden Produkten getestet und wird für diese unterstützt:This package has been tested with and is supported for:

  • Ubuntu Trusty, Senial, Artful, Bionic und DiscoUbuntu trusty, xenial, artful, bionic, and disco
  • Debian Wheezy, Jessie und StretchDebian wheezy, jessie, and stretch

Die aktuelle CLI-Version ist 2.0.64.The current version of the CLI is 2.0.64. Informationen zur neuesten Version finden Sie in den Versionshinweisen.For information about the latest release, see the release notes. Führen Sie az --version aus, um Ihre installierte Version zu ermitteln und festzustellen, ob Sie die CLI aktualisieren müssen.To find your installed version and see if you need to update, run az --version.

Hinweis

Das Paket für die Azure CLI installiert einen eigenen Python-Interpreter und verwendet nicht die Python-Version des Systems.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

InstallierenInstall

Wir bieten zwei Möglichkeiten zum Installieren der Azure-Befehlszeilenschnittstelle (Azure Command Line Interface, Azure CLI) mit Verteilungen, die apt unterstützen: Als All-in-One-Skript, das die Installationsbefehle für Sie ausführt, und mithilfe von Anweisungen, die Sie Schritt für Schritt selbst ausführen können.We offer two ways to install the Azure CLI with distributions that support apt: As an all-in-one script that runs the install commands for you, and instructions that you can run as a step-by-step process on your own.

Installieren mit einem BefehlInstall with one command

Wir bieten und pflegen ein Skript, das alle Installationsbefehle in einem Schritt ausführt.We offer and maintain a script which runs all of the installation commands in one step. Führen Sie das Skript mit curl aus, und leiten Sie es direkt an bash um, oder laden Sie das Skript in eine Datei herunter, und überprüfen Sie es vor dem Ausführen.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Wichtig

Dieses Skript wurde nur für Ubuntu 16.04 und höher und Debian 8 und höher geprüft.This script is only verified for Ubuntu 16.04+ and Debian 8+. Bei anderen Verteilungen funktioniert es möglicherweise nicht.It may not work on other distributions. Wenn Sie eine abgeleitete Verteilung wie Linux Mint verwenden, folgen Sie den Anweisungen für die manuelle Installation, und führen Sie ggf. eine Problembehandlung durch.If you're using a derived distribution such as Linux Mint, follow the manual install instructions and perform any necessary troubleshooting.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Anweisungen für die manuelle InstallationManual install instructions

Falls Sie ein Skript nicht als Superuser ausführen möchten, führen Sie die folgenden Schritte zum manuellen Installieren der Azure CLI aus.If you don't want to run a script as superuser, follow these manual steps to install the Azure CLI.

  1. Laden Sie die für die Installation erforderlichen Pakete herunter:Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install curl apt-transport-https lsb-release gnupg
    
  2. Laden Sie den Microsoft-Signaturschlüssel herunter, und installieren Sie ihn.Download and install the Microsoft signing key:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc | \
        gpg --dearmor | \
        sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
    
  3. Fügen Sie das Azure CLI-Softwarerepository hinzu:Add the Azure CLI software repository:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" | \
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Aktualisieren Sie die Repositoryinformationen, und installieren Sie das Paket azure-cli:Update repository information and install the azure-cli package:

    sudo apt-get update
    sudo apt-get install azure-cli
    

Führen Sie die Azure CLI mit dem Befehl az aus.Run the Azure CLI with the az command. Verwenden Sie den Befehl az login, um sich anzumelden.To sign in, use the az login command.

  1. Führen Sie den Befehl login aus.Run the login command.

    az login
    

    Die CLI öffnet Ihren Standardbrowser, sofern sie dazu in der Lage ist, und lädt eine Anmeldeseite.If the CLI can open your default browser, it will do so and load a sign-in page.

    Andernfalls müssen Sie eine Browserseite öffnen und den Anweisungen zur Befehlszeile folgen, um einen Autorisierungscode einzugeben, nachdem Sie in Ihrem Browser zu https://aka.ms/devicelogin navigiert sind.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. Melden Sie sich im Browser mit Ihren Anmeldeinformationen an.Sign in with your account credentials in the browser.

Weitere Informationen zu verschiedenen Authentifizierungsmethoden finden Sie unter Anmelden mit der Azure CLI.To learn more about different authentication methods, see Sign in with Azure CLI.

ProblembehandlungTroubleshooting

In diesem Abschnitt finden Sie einige allgemeine Probleme, die bei der Installation mit apt auftreten können.Here are some common problems seen when installing with apt. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.If you experience a problem not covered here, file an issue on github.

„lsb_release“ gibt nicht die richtige Basisdistributionsversion zurück.lsb_release does not return the correct base distribution version

Einige von Ubuntu oder Debian abgeleiteten Distributionen wie Linux Mint geben über lsb_release unter Umständen nicht den richtigen Versionsnamen zurück.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Mit diesem Wert wird im Installationsprozess das zu installierende Pakete ermittelt.This value is used in the install process to determine the package to install. Wenn Sie den Codenamen der Ubuntu- oder Debian-Version kennen, von der Ihre Distribution abgeleitet ist, können Sie beim Hinzufügen des Repositorys den Wert AZ_REPO manuell festlegen.If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the AZ_REPO value manually when adding the repository. Sehen Sie sich andernfalls Informationen dazu an, wie Sie für Ihre Distribution den Basisdistributions-Codenamen ermitteln, und legen Sie AZ_REPO auf den richtigen Wert fest.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Kein Paket für Ihre DistributionNo package for your distribution

Manchmal dauert es nach der Veröffentlichung einer Distribution etwas, bis ein Azure CLI-Paket dafür zur Verfügung gestellt wird.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. Die Azure CLI ist im Hinblick auf zukünftige Abhängigkeitsversionen resilient konzipiert und nutzt daher möglichst wenige dieser Abhängigkeiten.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Ist für Ihre Basisdistribution kein Paket verfügbar, verwenden Sie ein Paket für eine ältere Distribution.If there's no package available for your base distribution, try a package for an earlier distribution.

Legen Sie dazu beim Hinzufügen des Repositorys den Wert AZ_REPO manuell fest.To do this, set the value of AZ_REPO manually when adding the repository. Verwenden Sie für Ubuntu-Distributionen das Repository disco und für Debian-Distributionen stretch.For Ubuntu distributions use the disco repository, and for Debian distributions use stretch. Distributionen, die vor Ubuntu Trusty und Debian Wheezy veröffentlicht wurden, werden nicht unterstützt.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

Die CLI kann auf dem Windows-Subsystem für Linux nicht installiert oder ausgeführt werden.CLI fails to install or run on Windows Subsystem for Linux

Das Windows-Subsystem für Linux (WSL) ist eine Übersetzungsebene für Systemaufrufe, die auf der Windows-Plattform basiert. Daher tritt unter Umständen ein Fehler auf, wenn Sie die Azure CLI installieren oder ausführen.Since Windows Subsystem for Linux (WSL) is a system call translation layer on top of the Windows platform, you might experience an error when trying to install or run the Azure CLI. Die CLI nutzt einige Features, die in WSL unter Umständen einen Fehler enthalten.The CLI relies on some features that may have a bug in WSL. Falls unabhängig von der Art der CLI-Installation ein Fehler auftritt, ist die Wahrscheinlichkeit hoch, dass ein Problem mit dem WSL und nicht mit dem CLI-Installationsvorgang vorliegt.If you experience an error no matter how you install the CLI, there's a good chance it's an issue with WSL and not with the CLI install process.

So beheben Sie Probleme mit Ihrer WSL-Installation und ggf andere Probleme:To troubleshoot your WSL installation and possibly resolve issues:

  • Führen Sie möglichst den gleichen Installationsvorgang auf einem Linux-Computer oder einem virtuellen Computer aus, um zu sehen, ob er erfolgreich ist.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Ist dies der Fall, hängt das Problem mit hoher Wahrscheinlichkeit mit WSL zusammen.If it does, your issue is almost certainly related to WSL. Informationen zum Starten eines virtuellen Linux-Computers in Azure finden Sie in der Dokumentation zum Erstellen eines virtuellen Linux-Computers im Azure-Portal.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Stellen Sie sicher, dass die neueste Version von WSL ausgeführt wird.Make sure that you're running the latest version of WSL. Um die aktuelle Version zu erhalten, aktualisieren Sie Ihre Windows 10-Installation.To get the latest version, update your Windows 10 installation.
  • Suchen Sie nach offenen Problemen mit WSL. Mithilfe dieser Informationen kann Ihr Problem vielleicht behoben werden.Check for any open issues with WSL which might address your problem. Häufig finden Sie Vorschläge, wie Sie das Problem umgehen, bzw. Informationen zu einem Release, in dem das Problem behoben wird.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • Gibt es noch keinen Eintrag für Ihr Problem, melden Sie ein neues Problem mit WSL, und geben Sie dabei möglichst viele Details an.If there are no existing issues for your problem, file a new issue with WSL and make sure that you include as much information as possible.

Treten beim Installieren oder Ausführen auf dem WSL weiterhin Probleme auf, ziehen Sie die Installation der CLI für Windows in Betracht.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

AktualisierenUpdate

Verwenden Sie apt-get upgrade zum Aktualisieren des CLI-Pakets.Use apt-get upgrade to update the CLI package.

sudo apt-get update && sudo apt-get upgrade

Hinweis

Durch diesen Befehl werden alle installierten Pakete auf Ihrem System aktualisiert, deren Abhängigkeiten nicht geändert wurden.This command upgrades all of the installed packages on your system that have not had a dependency change. Wenn Sie nur ein Upgrade für die CLI durchführen möchten, verwenden Sie apt-get install.To upgrade the CLI only, use apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

DeinstallierenUninstall

Es tut uns leid, wenn Sie die Azure CLI deinstallieren möchten.If you decide to uninstall the Azure CLI, we're sorry to see you go. Verwenden Sie vor der Deinstallation den az feedback-Befehl, um uns mitzuteilen, was verbessert oder behoben werden sollte.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Unser Ziel ist eine fehlerfreie und benutzerfreundliche Azure CLI.Our goal is to make the Azure CLI bug-free and user-friendly. Falls ein Fehler aufgetreten ist, wären wir Ihnen dankbar, wenn Sie ein GitHub-Problem melden.If you found a bug, we'd appreciate it if you file a GitHub issue.

  1. Deinstallieren Sie sie mit apt-get remove:Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Entfernen Sie die Azure CLI-Repositoryinformationen, wenn Sie nicht planen, die CLI neu zu installieren:If you don't plan to reinstall the CLI, remove the Azure CLI repository information:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Entfernen Sie den Signaturschlüssel:Remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg
    
  4. Entfernen Sie alle nicht benötigten Pakete:Remove any unneeded packages:

    sudo apt autoremove
    

Nächste SchritteNext Steps

Machen Sie sich nach der Installation der Azure-Befehlszeilenschnittstelle kurz mit den Features sowie mit häufig verwendeten Befehlen vertraut.Now that you've installed the Azure CLI, take a short tour of its features and common commands.