Dela via


Introduktion till Az PowerShell-modulen

Överblick

Az PowerShell-modulen är en uppsättning cmdletar för att hantera 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 är officiellt inaktuell 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 med någon av följande metoder:

Funktioner

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

  • Säkerhet och stabilitet
    • Kryptering av tokencache
    • Förebyggande av man-in-the-middle-attacktyp
    • 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 API-versionsuppgraderingar sedan AzureRM
  • Nya funktioner
    • Stöd i Cloud Shell och plattformskompatibel
    • Kan hämta och använda åtkomsttoken för att komma åt Azure-resurser
    • Cmdlet tillgänglig för avancerade REST-åtgärder med Azure-resurser

Notera

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. Det är också kompatibelt med Windows PowerShell 5.1.

Vi är fast beslutna att ge Azure-stöd till alla plattformar och alla Az PowerShell-moduler är plattformsoberoende.

Uppgradera din miljö till Az

Om du vill hålla dig uppdaterad om de senaste Azure-funktionerna i PowerShell bör du migrera till Az-modulen. Om du inte är redo att installera Az-modulen som en ersättning för AzureRM har du några alternativ att experimentera med Az:

  • Använd en PowerShell miljö med Azure Cloud Shell. Azure Cloud Shell är en webbläsarbaserad gränssnittsmiljö som medföljer Az-modulen installerad och Enable-AzureRM kompatibilitetsalias aktiverade.
  • Behåll AzureRM-modulen installerad 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 sedan installera Az-modulen från PowerShell 7 eller senare.

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

  1. Avinstallera Azure PowerShell AzureRM-modulen
  2. Installera Az PowerShell-modulen
  3. VALFRI: Aktivera kompatibilitetsläge för att lägga till alias för äldre AzureRM-kommandon med Enable-AzureRMAlias medan du bekantar dig med den nya kommandouppsättningen. Mer information finns i nästa avsnitt eller 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 senaste PowerShell-modulen för Azure. Problem eller funktionsbegäranden kan loggas direkt på GitHub-lagringsplatseller via Microsoft-support om du har ett supportavtal. Funktionsbegäranden implementeras i den senaste versionen av Az. Kritiska frågor åtgärdas i de två senaste versionerna av Az.

Eftersom Az PowerShell-modulerna nu har alla funktioner från AzureRM PowerShell-modulerna och mer därtill, har vi fasat ut AzureRM PowerShell-modulerna från och med den 29 februari 2024.

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

Datainsamling

Azure PowerShell samlar in telemetridata som standard. Microsoft aggregerar insamlade data för att identifiera användningsmönster för att identifiera vanliga problem och förbättra upplevelsen av Azure PowerShell. Microsoft Azure PowerShell samlar inte in några privata eller personliga data. Användningsdata hjälper till exempel att identifiera problem som cmdlets med låg framgångsgrad och hjälper oss att prioritera vårt arbete.

Vi uppskattar de insikter som dessa data ger, men vi förstår också att inte alla vill skicka användningsdata. Du kan inaktivera datainsamling med cmdleten Disable-AzDataCollection. Du kan också läsa vår sekretesspolicy om du vill veta mer.