Dela via

Introduktion till Az PowerShell-modulen

  • Artikel

Översikt

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 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 kanske fortfarande fungerar, underhålls eller stöds den inte längre, vilket innebär att fortsatt användning sker på användarens eget ansvar och risk. 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:

Egenskaper

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 API-versionsuppgraderingar sedan AzureRM
  • Nya funktioner
    • Stöd i Cloud Shell och på alla plattformar
    • 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

Anmärkning

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 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 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 installera sedan 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. 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:

Supportbarhet

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 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. Följ snabbstartsguiden om du vill uppdatera skripten automatiskt.

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 ha mer information.