Installera Azure Az PowerShell-modulen

  • Artikel
  • 5 minuter för att läsa

Den här artikeln beskriver hur du installerar Azure Az PowerShell-modulen med Hjälp av PowerShellGet. De här instruktionerna fungerar för Windows-, macOS- och Linux-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 för plattformarna Windows, macOS och Linux. 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 avsnittet Az och AzureRM-samexistens i den här artikeln 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

Här följer några vanliga problem när du installerar Azure Az PowerShell-modulen. Om du stöter på ett problem som inte tas upp här kan du öppna ett ärende på GitHub.

Az och AzureRM samexistens

Varning

Det går inte att ha både modulen AzureRM och modulen Az installerade samtidigt för PowerShell 5.1 för Windows.

I ett scenario där du vill installera både AzureRM och Az PowerShell-modulen i samma system måste AzureRM endast installeras i användaromfånget för Windows PowerShell. Installera Az PowerShell-modulen för PowerShell 7.0.6 LTS, PowerShell 7.1.3 eller senare i samma system.

Viktigt

Eftersom Az PowerShell-moduler nu har alla funktioner i AzureRM PowerShell-moduler och mycket mer drar vi tillbaka AzureRM PowerShell-moduler den 29 februari 2024.

För att undvika avbrott i tjänsten uppdaterar du skripten som använder AzureRM PowerShell-moduler för att använda Az PowerShell-moduler senast den 29 februari 2024. Följ snabbstartsguiden om du vill uppdatera skripten automatiskt.

Visual Studio

Äldre versioner av Visual Studio kan installera Azure PowerShell som en del av Azure Development-arbetsbelastningen, som installerar AzureRM-modulen. Azure PowerShell kan tas bort med hjälp av Visual Studio-installationsprogrammet eller med hjälp av "Avinstallera" i appfunktioner&. Om du redan har installerat PowerShell 7.x kan du behöva installera Azure Az PowerShell-modulen manuellt .

Proxy blockerar anslutning

Om du får fel från Install-Module att PowerShell-galleriet inte kan nås kan du vara bakom en proxyserver. Olika operativsystem och nätverksmiljöer har olika krav för att konfigurera en systemomfattande proxy. Systemadministratören kan ge dig information om proxyinställningarna och hur du konfigurerar dem för din miljö.

Själva PowerShell kan inte konfigureras för att använda den här proxyn automatiskt. Med PowerShell 5.1 och senare konfigurerar du proxyn för PowerShell-sessionen med följande kommandon:

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Om autentiseringsuppgifter för operativsystemet är rätt konfigurerade dirigerar den här konfigurationen PowerShell-begärandena genom proxyn. För att den här inställningen ska finnas kvar mellan sessionerna lägger du till kommandona i en PowerShell-profil.

För att installera paketet måste proxyn tillåta att HTTPS-anslutningar www.powershellgallery.com.

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.