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.
- Installera den senaste versionen av PowerShell för ditt operativsystem.
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:
- Uppdatera till Windows PowerShell 5.1. Om du använder Windows 10 version 1607 eller senare är PowerShell 5.1 redan installerat.
- Installera .NET Framework 4.7.2 eller senare.
- 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.