Dela via

Introduktion till Az PowerShell-modulen

  • Artikel

Översikt

Az PowerShell-modulen är en uppsättning cmdlets för hantering av Azure-resurser direkt från PowerShell. PowerShell innehåller kraftfulla funktioner för automatisering som kan användas för att hantera dina Azure-resurser, till exempel i samband med en CI/CD-pipeline.

Az PowerShell-modulen ersätter AzureRM och är den rekommenderade modulen som ska användas för att interagera med Azure.

Varning

AzureRM PowerShell-modulen har officiellt avvecklats från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Du kan använda Az PowerShell-modulen genom att göra något av följande:

Funktioner

Az PowerShell-modulen har följande fördelar:

  • Säkerhet och stabilitet
    • Kryptering av tokencache
    • Förhindrande av attacktypen man-in–the-middle
    • Stöd för autentisering med ADFS 2019
    • Autentisering med användarnamn och lösenord i PowerShell 7
    • Stöd för funktioner som utvärdering av kontinuerlig åtkomst
  • Stöd för alla Azure-tjänster
    • Alla allmänt tillgängliga Azure-tjänster har en motsvarande PowerShell-modul som stöds
    • Flera felkorrigeringar och uppgraderingar av API-versioner sedan AzureRM
  • Nya funktioner
    • Stöd i Cloud Shell och på alla plattformar
    • Kan hämta och använda åtkomsttoken för åtkomst till Azure-resurser
    • Cmdlet som är tillgänglig för avancerade REST-åtgärder med Azure-resurser

Kommentar

PowerShell 7.2 eller senare är den rekommenderade versionen av PowerShell för användning med Az PowerShell-modulen på alla plattformar.

Az PowerShell-modulen baseras på .NET Standard-biblioteket och fungerar med PowerShell 7.2 och senare på alla plattformar, inklusive Windows, Linux och macOS. Den är också kompatibel med Windows PowerShell 5.1.

Vår ambition är att alla plattformar ska ha stöd för Azure och att alla Az PowerShell-moduler ska vara plattformsoberoende.

Uppgradera din miljö till Az

För att dra nytta av de senaste Azure-funktionerna i PowerShell rekommenderar vi att du migrerar till Az-modulen. Om du inte är redo att ersätta AzureRM med Az-modulen finns det ett par alternativ för att experimentera med Az:

  • Du kan använda en PowerShell-miljö med Azure Cloud Shell. Azure Cloud Shell är en webbläsarbaserad skalmiljö där Az-modulen redan är installerad och Enable-AzureRM-kompatibilitetsalias aktiverade.
  • Behåll AzureRM-modulen i Windows PowerShell 5.1 och installera Az-modulen i PowerShell 7 eller senare. Windows PowerShell 5.1 och PowerShell 7 och senare använder separata samlingar med moduler. Följ anvisningarna för att installera den senaste versionen av PowerShell och installera sedan Az-modulen från PowerShell 7 eller senare.

Så uppgraderar du från en befintlig AzureRM-installation:

  1. Avinstallera Azure PowerShell AzureRM-modulen
  2. Installera Az PowerShell-modulen
  3. VALFRITT: Aktivera kompatibilitetsläge för att lägga till alias för AzureRM-cmdletar med Enable-AzureRMAlias medan du bekantar dig med den nya kommandouppsättningen. Mer information finns i nästa avsnitt och i Starta migrering från AzureRM till Az.

Migrera befintliga skript från AzureRM till Az

Om dina skript fortfarande baseras på AzureRM-modulen har vi flera resurser som hjälper dig med migreringen:

Supportmöjlighet

Az är den mest aktuella PowerShell-modulen för Azure. Problem eller önskemål om funktioner kan loggas direkt på GitHub-lagringsplatsen eller via Microsofts support om du har ett supportavtal. Funktionsbegäranden implementeras i den senaste versionen av Az. Kritiska problem implementeras på de två senaste versionerna av Az.

Eftersom Az PowerShell-moduler nu har alla funktioner i AzureRM PowerShell-moduler med mera har vi föråldrat AzureRM PowerShell-modulerna från och med den 29 februari 2024.

För att undvika tjänstavbrott uppdaterar du skripten som använder AzureRM PowerShell-moduler för att använda Az PowerShell-moduler. Följ snabbstartsguiden om du vill uppdatera skripten automatiskt.

Datainsamling

Azure PowerShell samlar in telemetridata som standard. Microsoft samlar in data för att upptäcka användningsmönster, identifiera vanliga problem och förbättra upplevelsen av Azure PowerShell. Microsoft Azure PowerShell samlar inte in privata eller personliga data. Användningsdata hjälper oss att identifiera problem, t.ex. cmdlets som inte ger väntat resultat, och att prioritera vårt arbete.

Även om vi har stor nytta av insikterna från dessa data, förstår vi att inte alla vill skicka sina användningsdata. Du kan inaktivera datainsamling med cmdleten Disable-AzDataCollection. Du kan också läsa vår sekretesspolicy om du vill ha mer information.