Installera Azure Az PowerShell-modulen

Den här artikeln beskriver hur du installerar Azure Az PowerShell-modulen från The PowerShell-galleriet. De här instruktionerna fungerar på Windows-, Linux- och macOS-plattformar.

Azure Az PowerShell-modulen är förinstallerad i Azure Cloud Shell och i Docker-avbildningar.

Azure Az PowerShell-modulen är en sammanslagningsmodul. När du installerar den laddas de allmänt tillgängliga Az PowerShell-modulerna ned och deras cmdletar blir tillgängliga för användning.

Krav

Anteckning

PowerShell 7.0.6 LTS, PowerShell 7.1.3 eller senare är den rekommenderade versionen av PowerShell för användning med Azure Az PowerShell-modulen på alla plattformar.

Azure PowerShell har inga ytterligare krav vid körning på PowerShell 7.0.6 LTS och PowerShell 7.1.3 eller senare.

Kontrollera din PowerShell-version genom att köra följande kommando inifrån en PowerShell-session:

$PSVersionTable.PSVersion

Körningsprincipen för PowerShell-skript måste vara inställd på fjärrsignerad eller mindre restriktiv. Get-ExecutionPolicy -List kan användas för att fastställa den aktuella körningsprincipen. Mer information finns i about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Installation

Att använda cmdleten Install-Module är den rekommenderade installationsmetoden för Az PowerShell-modulen. Installera Az-modulen endast för den aktuella användaren. Detta är det rekommenderade installationsomfånget. Den här metoden fungerar på samma sätt på Windows-, Linux- och macOS-plattformar. Kör följande kommando från en PowerShell-session:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Andra installationsalternativ

PowerShell 7.0.6 LTS, PowerShell 7.1.3 eller senare är den rekommenderade versionen av PowerShell och är det rekommenderade installationsalternativet, men Install-Module det finns ytterligare installationsalternativ om det behövs.

Installation på Windows PowerShell

Viktigt

Om du har AzureRM PowerShell-modulen installerad kan du läsa Az och AzureRM-samexistens innan du fortsätter.

Azure Az PowerShell-modulen stöds också för användning med PowerShell 5.1 i Windows. Så här använder du Azure Az PowerShell-modulen i PowerShell 5.1 i Windows:

  1. Uppdatera till Windows PowerShell 5.1. Om du använder Windows 10 version 1607 eller senare är PowerShell 5.1 redan installerat.
  2. Installera .NET Framework 4.7.2 eller senare.
  3. Kontrollera att du har den senaste versionen av PowerShellGet. Kör Install-Module -Name PowerShellGet -Force.

Offlineinstallation

I en del miljöer går det inte att ansluta till PowerShell-galleriet. I sådana situationer kan du installera Az PowerShell-modulen offline med någon av följande metoder:

  • Ladda ned Azure PowerShell MSI. Tänk på att MSI-installationsprogrammet endast fungerar för PowerShell 5.1 på Windows.
  • Ladda ned modulerna till en annan plats i nätverket och använd den som en installationskälla. Med den här metoden kan du cachelagra PowerShell-moduler på en enda server eller filresurs så att de kan distribueras med PowerShellGet till frånkopplade system. Läs artikeln om hur du arbetar med lokala PowerShellGet-lagringsplatser för mer information om hur du konfigurerar lokala lagringsplatser och installerar på frånkopplade system.
  • Spara modulen med Save-Module till en filresurs eller spara den i en annan källa och kopiera den manuellt till andra datorer.

Logga in

Börja arbeta med Azure PowerShell genom att logga in med dina autentiseringsuppgifter för Azure.

Connect-AzAccount

När du har kört det här kommandot öppnas ett nytt webbläsarfönster och du kan logga in på ditt Azure-konto.

Uppdatera Azure PowerShell-modulen

Om du vill uppdatera en PowerShell-modul ska du använda samma metod som för att installera modulen. Om du ursprungligen till exempel använde Install-Module använder du Update-Module för att hämta den senaste versionen. Om du ursprungligen använde MSI-paketet bör du ladda ned och installera det nya MSI-paketet.

PowerShellGet-cmdletar kan inte uppdatera moduler som har installerats från ett MSI-paket. MSI-paket uppdaterar inte moduler som har installerats med PowerShellGet. Om du har problem med att uppdatera med PowerShellGet bör du installera om i stället för att uppdatera. Ominstallation sker på samma sätt som installation. Se till att du använder parametern Force med Install-Module när du installerar om.

Till skillnad från MSI-baserade installationer, tar installationer eller uppdateringar med PowerShellGet inte bort äldre versioner som kan finnas i systemet.

Anteckning

Avinstallationen kan vara komplicerad om du har fler än en version av Az PowerShell-modulen installerad. På grund av den här komplexiteten stöder vi endast avinstallation av alla versioner av Az PowerShell-modulen som för närvarande är installerade.

Information om hur du tar bort alla versioner av Az PowerShell-modulen från systemet finns i Avinstallera modulen Azure PowerShell. Mer information om MSI-baserade installationer finns i Installera Azure PowerShell med MSI.

Felsökning

Felsöka installationsproblem med Azure Az PowerShell-modulen.

Ge feedback

Om du hittar en bugg i Azure Az PowerShell-modulen kan du skapa ett problem på GitHub. Om du vill ge feedback inifrån en PowerShell-session använder du cmdleten Skicka feedback.

Nästa steg

Mer information om Azure Az PowerShell-moduler och deras funktioner finns i Komma igång med Azure PowerShell. Om du känner till Azure PowerShell och behöver migrera från AzureRM läser du Migrera från AzureRM till Az.