Installera Azure Az PowerShell-modulen

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

I den här artikeln förklaras hur du installerar Azure Az PowerShell-modulen med PowerShellGet. De här instruktionerna fungerar Windows, macOS och Linux.

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

Azure Az PowerShell-modulen är en samlad modul. När du installerar det laddas de allmänt tillgängliga Az PowerShell-modulerna ned och deras cmdlets 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 inte några ytterligare krav när du kör det på PowerShell 7.0.6 LTS och PowerShell 7.1.3 eller senare.

Om du vill kontrollera din PowerShell-version kör du följande kommando från en PowerShell-session:

$PSVersionTable.PSVersion

Körningsprincipen för PowerShell-skript måste vara inställd på fjärrstyrd 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 modulen Az enbart för den aktuella användaren. Det här är den rekommenderade installationsomfånget. Den här metoden fungerar på samma sätt 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

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

Installation på Windows PowerShell

Viktigt

Om du har AzureRM PowerShell-modulen installerad läser du avsnittet Om 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 på Windows. Så här använder du Azure Az PowerShell-modulen i PowerShell 5.1 på Windows:

  1. Uppdatera till Windows PowerShell 5.1. Om du använder version Windows 10 1607 eller senare har du redan PowerShell 5.1 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 vissa miljöer går det inte att ansluta till PowerShell-galleriet. I sådana fall kan du installera Az PowerShell-modulen offline på något av följande sätt:

  • Ladda ned Azure PowerShell MSI. Kom ihåg 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 dem som installationskälla. Med den här metoden kan du cachelagra PowerShell-moduler på en enda server eller filresurs som ska distribueras med PowerShellGet till alla frånkopplade system. Lär dig konfigurera en lokal lagringsplats och installera i frånkopplade system med Arbeta med lokala PowerShellGet-lagringslager.
  • Spara modulen med Spara-modul till en filresurs eller spara den i en annan källa och kopiera den manuellt till andra datorer.

Logga in

Om du vill börja arbeta Azure PowerShell loggar du in med dina Azure-autentiseringsuppgifter.

Connect-AzAccount

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

Uppdatera Azure PowerShell modul

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

PowerShellGet-cmdlet:arna kan inte uppdatera moduler som har installerats från ett MSI-paket. MSI-paket uppdaterar inte moduler som installerades med PowerShellGet. Om du har problem med att uppdatera med PowerShellGet bör du installera om istället för att uppdatera. Ominstallation görs på samma sätt som installationen. Se till att du använder Force parametern tillsammans Install-Module med när du installerar om.

Till skillnad från MSI-baserade installationer tas inte äldre versioner som kan finnas i ditt system bort när du installerar eller uppdaterar med PowerShellGet.

Anteckning

Avinstallationen kan vara komplicerat om du har installerat mer än en version av Az PowerShell-modulen. På grund av denna komplexitet har vi bara stöd för att avinstallera alla versioner av Az PowerShell-modulen som är installerade.

Om du vill ta bort alla versioner av Az PowerShell-modulen från systemet går du till Avinstallera Azure PowerShell. Mer information om MSI-baserade installationer finns i Installera Azure PowerShell med en MSI.

Felsökning

Här är några vanliga problem som kan uppstå när du installerar Azure Az PowerShell-modulen. Om du får problem som inte anges här arkiverar du ett problem GitHub.

Az- och AzureRM-samexistens

Varning

Vi stöder inte att både AzureRM- och Az-modulerna är installerade för PowerShell 5.1 på Windows samtidigt.

I ett scenario där du vill installera både AzureRM och Az PowerShell-modulen på samma system måste AzureRM bara installeras i användaromfattningen för Windows PowerShell. Installera Az PowerShell-modulen för PowerShell 7.0.6 LTS, PowerShell 7.1.3 eller senare på 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 skript som använder AzureRM PowerShell-moduler så att du använder Az PowerShell-moduler senast den 29 februari 2024. Följ snabbstartsguiden för att uppdatera dina skript automatiskt.

Visual Studio

Äldre versioner av Visual Studio installera Azure PowerShell som en del av Azure-utvecklingsarbetsbelastningen, som installerar AzureRM-modulen. Azure PowerShell kan tas bort med hjälp Visual Studio installationsprogrammet eller genom att använda "Avinstallera" i & programfunktioner. 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 felmeddelanden om att PowerShell-galleriet inte kan nås kan du Install-Module vara bakom en proxy. Olika operativsystem och nätverksmiljöer har olika krav för konfiguration av en systemomfattande proxy. Kontakta systemadministratören för proxyinställningarna och hur du konfigurerar dem för din miljö.

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

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

Om dina autentiseringsuppgifter för operativsystemet är korrekt konfigurerade dirigerar den här konfigurationen PowerShell-begäranden via proxyn. För att den här inställningen ska bevaras mellan sessioner lägger du till kommandona i din PowerShell-profil.

Om du vill installera paketet måste din proxy tillåta HTTPS-anslutningar att www.powershellgallery.com.

Ge feedback

Om du hittar ett fel i Azure Az PowerShell-modulen arkiverar du ett problem GitHub. Om du vill ge feedback från en PowerShell-session använder du cmdleten Send-Feedback.

Nästa steg

Mer information om Azure Az PowerShell-modulerna och deras funktioner finns i Kom igång med Azure PowerShell. Om du är bekant med Azure PowerShell behöver migrera från AzureRM kan du gå till Migrera från AzureRM till Az.