Versionshantering, lanseringstakt och icke-bakåtkompatibla ändringar i Azure PowerShell

Az PowerShell-modulen är en sammanslagningsmodul som innehåller fler än 70 allmänt tillgängliga (GA) eller stabila tjänstmoduler för hantering av Azure-resurser direkt från PowerShell.

Versionshantering

Az PowerShell-modulerna följer semantisk versionshantering för versionsnumrering. Versioner av Azure-tjänstmoduler finns i någon av tre kategorier:

  • Allmänt tillgänglig. Moduler version 1.0.0 och senare utan förhandsversion i versionen. Följer policyn för icke-bakåtkompatibla ändringar.
  • Förhandsversion. Moduler som är mindre än version 1.0.0. Följ inte policyn för icke-bakåtkompatibla ändringar.
  • Funktionsförhandsvisning. Moduler version 1.0.0 och senare med förhandsversion i versionen. Följ inte policyn för icke-bakåtkompatibla ändringar.

Det finns två Az PowerShell-sammanslagningsmoduler:

  • Az. Installerar alla GA-tjänstmoduler för hantering av Azure-resurser.
  • AzPreview. Installerar alla GA- och förhandsversionsmoduler för hantering av Azure-resurser. Innehåller inte förhandsversionsmoduler för funktioner.

AzPreview-modulen är alltid samma version och släpps samtidigt som Az-modulen.

Frisläpp miljö

Planerade uppdateringar av Az PowerShell-modulen släpps den första tisdagen i varje månad. Dessa 12 planerade uppdateringar per kalenderår finns i två kategorier:

  • Huvudversioner. Högst två per kalenderår medför icke-bakåtkompatibla ändringar. Det första numret i versionsnumret uppdateras. Till exempel version 6.6.0 till version 7.0.0.
  • Delversioner. 10 per kalenderår som inte medför icke-bakåtkompatibla ändringar. Det andra numret i versionsnumret uppdateras. Till exempel version 7.0.0 till version 7.1.0.

Varning

Innan du uppgraderar till en viktig icke-bakåtkompatibel ändringsversion av Az PowerShell-modulen bör du läsa migreringsguiden.

Oplanerade korrigeringsversioner kan släppas när som helst för att åtgärda buggar. Korrigeringsversioner medför inte icke-bakåtkompatibla ändringar. Det tredje numret i versionsnumret uppdateras. Till exempel version 6.2.0 till version 6.2.1.

Icke-bakåtkompatibla ändringar

Viktigt!

Icke-bakåtkompatibla ändringar kan inträffa när som helst för förhandsversioner och förhandsgranskningsmoduler för funktioner. Icke-GA-moduler krävs inte för att följa icke-bakåtkompatibla ändringsprinciper.

När inträffar icke-bakåtkompatibla ändringar

Vi släpper två icke-bakåtkompatibla ändringsversioner per år:

  • En på senvåren
  • En på hösten

Information om kommande icke-bakåtkompatibla ändringsversioner finns i Azure PowerShell-milstolpar.

Typer av icke-bakåtkompatibla ändringar

Olika typer av icke-bakåtkompatibla ändringar kan inträffa i cmdletar. Mer information finns i Icke-bakåtkompatibel ändringsdefinition.

Lista över icke-bakåtkompatibla ändringar

Detaljerad information om icke-bakåtkompatibla ändringar i större versioner av Az PowerShell-modulen finns i följande artiklar.

Varningsmeddelanden om icke-bakåtkompatibel ändring

Varningsmeddelanden om icke-bakåtkompatibla ändringar gör det möjligt för Azure PowerShell-cmdlet-författare att kommunicera kommande icke-bakåtkompatibla ändringar med slutanvändare.

Ignorera varningsmeddelanden om icke-bakåtkompatibel ändring

Om du vill förhindra meddelanden om icke-bakåtkompatibla ändringar kan du läsa Hur gör jag för att inaktivera varningsmeddelanden om icke-bakåtkompatibla ändringar i Azure PowerShell?.

Mer information finns i Hjälp om attribut för icke-bakåtkompatibla ändringar.

Ge feedback

Andra resurser