De Azure CLI installeren met aptInstall Azure CLI with apt

Als u een distributie uitvoert die wordt geleverd met apt, zoals Ubuntu of Debian, is er een x86_64-pakket beschikbaar voor de Azure CLI.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. Dit pakket is getest met en wordt ondersteund voor:This package has been tested with and is supported for:

  • Ubuntu Trusty, xenial, Artful, Bionic en detectiebereikUbuntu trusty, xenial, artful, bionic, and disco
  • Debian Wheezy, Jessie, stretch en BusterDebian wheezy, jessie, stretch, and buster

De huidige versie van de Azure CLI is 2.0.76.The current version of the Azure CLI is 2.0.76. Zie de opmerkingen bij de release voor meer informatie over de nieuwste release.For information about the latest release, see the release notes. Voer az --version uit om de geïnstalleerde versie te vinden en te controleren of u deze moet bijwerken.To find your installed version and see if you need to update, run az --version.

Notitie

Het pakket voor Azure CLI installeert een eigen Python-interpreter en maakt geen gebruik van het systeem python.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

InstallatieInstall

We bieden twee manieren om de Azure CLI te installeren met distributies die ondersteuning bieden voor apt: als een alles-in-één script waarmee de installatie opdrachten voor u worden uitgevoerd en instructies die u zelf kunt uitvoeren als stapsgewijze procedure.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.

Installeren met één opdrachtInstall with one command

We bieden en onderhouden een script waarmee alle installatie opdrachten in één stap worden uitgevoerd.We offer and maintain a script which runs all of the installation commands in one step. Voer de oplossing uit met behulp van curl en-pipe rechtstreeks naar bash, of down load het script naar een bestand en inspecte het voordat u het uitvoert.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Belangrijk

Dit script wordt alleen gecontroleerd voor Ubuntu 16.04 + en Debian 8 +.This script is only verified for Ubuntu 16.04+ and Debian 8+. Het werkt mogelijk niet op andere distributies.It may not work on other distributions. Als u een afgeleide distributie zoals Linux licht gebruikt, volgt u de hand matige installatie-instructies en voert u de benodigde problemen op te lossen.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

Hand matige installatie-instructiesManual install instructions

Als u geen script wilt uitvoeren als super gebruiker of het script all-in-One mislukt, voert u de volgende stappen uit om de Azure CLI te installeren.If you don't want to run a script as superuser or the all-in-one script fails, follow these steps to install the Azure CLI.

  1. Pakketten ophalen die nodig zijn voor het installatie proces:Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Down load en installeer de micro soft-handtekening sleutel: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. De Azure CLI-software opslagplaats toevoegen: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. Informatie over de opslag plaats bijwerken en het azure-cli-pakket installeren:Update repository information and install the azure-cli package:

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

Voer Azure CLI uit met de opdracht az.Run the Azure CLI with the az command. Als u zich wilt aanmelden, gebruikt u de opdracht AZ login .To sign in, use the az login command.

  1. Voer de opdracht login uit.Run the login command.

    az login
    

    Als de CLI uw standaard browser kan openen, wordt dit gedaan en wordt er een Azure-aanmeldings pagina geladen.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    Als dat niet het geval is, https://aka.ms/devicelogin opent u een browser pagina op en voert u de autorisatie code in die wordt weer gegeven in uw Terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Meldt u zich in de browser aan met uw accountreferenties.Sign in with your account credentials in the browser.

Raadpleeg Aanmelden met Azure CLI voor meer informatie over verschillende verificatiemethoden.To learn more about different authentication methods, see Sign in with Azure CLI.

Problemen oplossenTroubleshooting

Hieronder volgen enkele veelvoorkomende problemen tijdens het installeren met apt.Here are some common problems seen when installing with apt. Als u een probleem ondervindt dat hier niet wordt beschreven, meldt u dat op github.If you experience a problem not covered here, file an issue on github.

lsb_release retourneert niet de juiste versie van de basis distributielsb_release does not return the correct base distribution version

Bij bepaalde van Ubuntu of Debian afgeleide distributies, zoals Linux Mint, wordt niet de juiste versienaam van lsb_release geretourneerd.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Deze waarde wordt in het installatieproces gebruikt om te bepalen welk pakket moet worden geïnstalleerd.This value is used in the install process to determine the package to install. Als u de code naam van de Ubuntu-of Debian-versie kent waarvan uw distributie is afgeleid, kunt u de AZ_REPO-waarde hand matig instellen wanneer u de opslag plaats toevoegt.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. Als dat niet het geval is, kunt u informatie opzoeken voor uw distributie over het bepalen van de naam van de basis distributie code en het AZ_REPO instellen op de juiste waarde.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Geen pakket voor uw distributieNo package for your distribution

Soms kan het enige tijd duren nadat een distributie is vrijgegeven voordat er een Azure CLI-pakket beschikbaar is.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. De Azure CLI is zodanig ontworpen dat deze kan worden uitgevoerd met betrekking tot toekomstige versies van afhankelijkheden en is zo weinig mogelijk afhankelijk.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Als er geen pakket beschikbaar is voor uw basis distributie, probeert u een pakket voor een eerdere distributie.If there's no package available for your base distribution, try a package for an earlier distribution.

U doet dit door de waarde van AZ_REPO hand matig in te stellen bij het toevoegen van de opslag plaats.To do this, set the value of AZ_REPO manually when adding the repository. Voor Ubuntu-distributies gebruikt u de opslag plaats bionic en voor Debian-distributies wordt gebruikgemaakt van stretch.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Distributies die zijn vrijgegeven vóór Ubuntu Trusty en Debian Wheezy worden niet ondersteund.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

Proxy blokkeert verbindingProxy blocks connection

Als u geen verbinding maken met een externe resource vanwege een proxy, zorg ervoor dat u goed hebt ingesteld de HTTP_PROXY en HTTPS_PROXY variabelen in de shell.If you're unable to connect to an external resource due to a proxy, make sure that you've correctly set the HTTP_PROXY and HTTPS_PROXY variables in your shell. U moet contact opnemen met uw systeembeheerder om te weten wat host (s) en poort(en) moet worden gebruikt voor deze proxy's.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

Deze waarden worden nageleefd door veel Linux-programma's, inclusief verbindingen die worden gebruikt in het installatieproces.These values are respected by many Linux programs, including those which are used in the install process. Deze waarden instellen:To set these values:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Belangrijk

Als u zich achter een proxy bevindt, moeten deze shell-variabelen worden ingesteld op verbinding maken met Azure-services met de CLI.If you are behind a proxy, these shell variables must be set to connect to Azure services with the CLI. Als u Basisverificatie niet gebruikt, het is raadzaam om te exporteren van deze variabelen in uw .bashrc bestand.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Voer altijd beveiligingsbeleid van uw bedrijf en de vereisten van uw systeembeheerder.Always follow your business' security policies and the requirements of your system administrator.

Mogelijk wilt u apt ook expliciet configureren om deze proxy te gebruiken.You may also want to explicitly configure apt to use this proxy at all times. Zorg ervoor dat de volgende regels worden weer gegeven in een apt-configuratie bestand in /etc/apt/apt.conf.d/.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. U kunt het beste uw bestaande globale configuratie bestand, een bestaand proxy configuratie bestand, 40proxies of 99local gebruiken, maar de vereisten voor systeem beheer volgen.We recommend using either your existing global configuration file, an existing proxy configuration file, 40proxies, or 99local, but follow your system administration requirements.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Als uw proxy geen basis verificatie gebruikt, verwijdert u het [username]:[password]@ gedeelte van de proxy-URI.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. Zie de officiële Ubuntu-documentatie als u meer informatie over de proxy configuratie nodig hebt.If you require more information for proxy configuration, see the official Ubuntu documentation:

Om de micro soft-handtekening sleutel op te halen en het pakket op te halen uit onze opslag plaats, moet uw proxy HTTPS-verbindingen toestaan op het volgende adres:In order to get the Microsoft signing key and get the package from our repository, your proxy needs to allow HTTPS connections to the following address:

  • https://packages.microsoft.com

CLI te installeren of uitvoeren op Windows-subsysteem voor Linux is misluktCLI fails to install or run on Windows Subsystem for Linux

Aangezien Windows-subsysteem voor Linux (WSL) is een systeem aanroep vertaling laag boven op het Windows-platform, kan er een fout optreedt bij het installeren of uitvoeren van de Azure CLI.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. De CLI is afhankelijk van bepaalde functies waarvoor een bug in WSL.The CLI relies on some features that may have a bug in WSL. Als er een fout, ongeacht hoe u de CLI installeren, is er een goede kans dat het is een probleem met WSL en niet met het installatieproces van de CLI.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.

Problemen met de installatie van uw WSL en problemen mogelijk oplossen:To troubleshoot your WSL installation and possibly resolve issues:

  • Indien mogelijk, moet u een identieke installeren-proces uitvoeren op een Linux-machine of virtuele machine om te controleren of het is gelukt.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Als dit het geval is, wordt uw probleem vrijwel zeker met betrekking tot WSL.If it does, your issue is almost certainly related to WSL. Zie voor informatie over het starten van een Linux-VM in Azure de een Linux-VM maken in de Azure-Portal documentatie.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Zorg ervoor dat u de nieuwste versie van WSL uitvoert.Make sure that you're running the latest version of WSL. Aan de meest recente versie bijwerken van de installatie van Windows 10.To get the latest version, update your Windows 10 installation.
  • Controleer voor elk problemen melden met WSL waarmee het probleem mogelijk.Check for any open issues with WSL which might address your problem. Vaak zal er suggesties voor het omzeilen van het probleem of informatie over een release waar het probleem wordt opgelost.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • Als er geen bestaande problemen voor uw probleem, dient u een nieuw probleem met WSL en zorg ervoor dat u net zoveel mogelijk informatie bevatten.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.

Als u problemen installeren of uitvoeren op WSL hebt, kunt u blijven installeren van de CLI voor Windows.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

BijwerkenUpdate

Gebruik apt-get upgrade om het CLI-pakket bij te werken.Use apt-get upgrade to update the CLI package.

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

Notitie

Deze opdracht voert een upgrade uit voor alle geïnstalleerde pakketten in uw systeem waarvan de afhankelijkheid nog niet is gewijzigd.This command upgrades all of the installed packages on your system that have not had a dependency change. Als u alleen de CLI wilt upgraden, gebruikt u 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

VerwijderenUninstall

We zouden het jammer vinden als u besluit om Azure CLI te verwijderen.If you decide to uninstall the Azure CLI, we're sorry to see you go. Voordat u de CLI verwijdert, gebruikt u de az feedback-opdracht om ons te laten weten wat er kan worden verbeterd of opgelost.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Ons doel is om Azure CLI zo gebruiksvriendelijk mogelijk te maken en vrij te houden van bugs.Our goal is to make the Azure CLI bug-free and user-friendly. Als u een bug vindt, zouden we het waarderen als u dat meldt op GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

  1. Verwijderen met apt-get remove:Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Als u niet van plan bent om de CLI opnieuw te installeren, verwijdert u de Azure CLI-opslagplaats gegevens: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. Als u geen andere pakketten van micro soft gebruikt, verwijdert u de handtekening sleutel:If you use no other packages from Microsoft, remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg
    
  4. Verwijder overbodige pakketten:Remove any unneeded packages:

    sudo apt autoremove
    

Volgende stappenNext Steps

Nu u de Azure CLI hebt geïnstalleerd, kunt u een korte rondleiding volgen om kennis te maken met de functies en veelgebruikte opdrachten.Now that you've installed the Azure CLI, take a short tour of its features and common commands.