Uppdatera Azure PowerShell-moduler i Automation

De vanligaste PowerShell-modulerna tillhandahålls som standard i varje Automation-konto. Se Standardmoduler. När Azure-teamet uppdaterar Azure-modulerna regelbundet kan ändringar ske med de inkluderade cmdletarna. Dessa ändringar, till exempel att byta namn på en parameter eller helt ta bort en cmdlet, kan påverka dina runbooks negativt.

Anteckning

Du kan inte ta bort globala moduler, som är moduler som Automation tillhandahåller direkt.

Konfigurera ett Automation-konto

För att undvika att påverka dina runbooks och de processer som de automatiserar måste du testa och validera när du gör uppdateringar. Om du inte har ett dedikerat Automation-konto avsett för det här ändamålet kan du skapa ett så att du kan testa många olika scenarier under utvecklingen av dina runbooks. Den här testningen bör innehålla iterativa ändringar, till exempel uppdatering av PowerShell-moduler.

Se till att ditt Automation-konto har lagt till en systemtilldelad hanterad identitet eller användartilldelad hanterad identitet.

Om du utvecklar skript lokalt rekommenderar vi att du har samma modulversioner lokalt som du har i ditt Automation-konto när du testar för att säkerställa att du får samma resultat. När resultaten har verifierats och du har tillämpat de ändringar som krävs kan du flytta ändringarna till produktion.

Anteckning

Ett nytt Automation-konto kanske inte innehåller de senaste modulerna.

Uppdatera Az-moduler

I följande avsnitt beskrivs hur du kan uppdatera Az-moduler antingen via portalen (rekommenderas) eller via runbooken.

Uppdatera Az-moduler via portalen

För närvarande är uppdatering av AZ-moduler endast tillgängligt via portalen. Uppdateringar via PowerShell och ARM-mallen kommer att vara tillgängliga i framtiden. Endast az-standardmoduler uppdateras när du utför följande steg:

  1. Logga in på Azure-Portal och gå till ditt Automation-konto.

  2. Under Delade resurser väljer du Moduler.

  3. Välj Uppdatera Az-moduler.

  4. Välj Modul att uppdatera. Som standard visas Az-modulen.

  5. I listrutan väljer du Modulversion och Runtype-version

  6. Välj Uppdatera för att uppdatera Az-modulen till den version som du har valt. På sidan Moduler kan du visa listan enligt nedan:

    Uppdatera sidan AZ-moduler med val.

Om du väljer en version som är lägre än den befintliga Az-modulversionen som importerats i Automation-kontot utför uppdateringsåtgärden en återställning till den valda lägre versionen.

Du kan verifiera uppdateringsåtgärden genom att kontrollera modulversionen och statusegenskapen för de uppdaterade modulerna som visas i listan över moduler under PowerShell-moduler.

Azure-teamet uppdaterar regelbundet modulversionen och tillhandahåller ett alternativ för att uppdatera Az-standardmodulerna genom att välja modulversionen i listrutan.

Uppdatera Az-moduler via runbook

Så här uppdaterar du Azure-modulerna i ditt Automation-konto:

  1. Använd Runbooken Update-AutomationAzureModulesForAccount, som är tillgänglig som Open Source.
  2. Ladda ned från GitHub-lagringsplatsen för att börja använda den här runbooken för att uppdatera dina Azure-moduler.
  3. Importera det till ditt Automation-konto eller kör det som ett skript. Information om hur du importerar en runbook i ditt Automation-konto finns i Importera en runbook.

Anteckning

Vi rekommenderar att du uppdaterar Az-moduler via Azure-Portal. Du kan också utföra detta med hjälp av skriptet Update-AutomationAzureModulesForAccount , tillgängligt som öppen källkod och tillhandahålls som referens. Men om det uppstår ett runbook-fel måste du ändra parametrarna i runbooken efter behov eller felsöka skriptet enligt scenariot.

Runbooken Update-AutomationAzureModulesForAccount stöder uppdatering av modulerna Azure, AzureRM och Az som standard. Mer information om hur du uppdaterar Az.Automation-moduler med den här runbooken finns i Readbook-runbooken Uppdatera Azure-moduler . Det finns ytterligare viktiga faktorer som du måste ta hänsyn till när du använder Az-modulerna i ditt Automation-konto. Mer information finns i Hantera moduler i Azure 自動化.

Använda runbook-koden för uppdateringen som ett vanligt PowerShell-skript

Du kan använda runbook-koden som ett vanligt PowerShell-skript i stället för en runbook. Det gör du genom att logga in på Azure med cmdleten Connect-AzAccount först och sedan skicka -Login $false till skriptet.

Använda uppdaterings-runbooken i nationella moln

Om du vill använda den här runbooken i nationella moln använder du parametern AzEnvironment för att skicka rätt miljö till runbooken. Godtagbara värden är AzureCloud (offentligt Azure-moln), AzureChinaCloud, AzureGermanCloud och AzureUSGovernment. Dessa värden kan hämtas med hjälp av Get-AzEnvironment | select Name. Om du inte skickar ett värde till den här cmdleten använder runbooken som standard AzureCloud.

Använd uppdaterings-runbooken för att uppdatera en specifik modulversion

Om du vill använda en specifik Azure PowerShell modulversion i stället för den senaste modulen som är tillgänglig på Galeria programu PowerShell skickar du dessa versioner till den valfria ModuleVersionOverrides parametern för Runbooken Update-AutomationAzureModulesForAccount. Exempel finns i Update-AutomationAzureModulesForAccount.ps1 runbook. Azure PowerShell moduler som inte nämns i parametern ModuleVersionOverrides uppdateras med de senaste modulversionerna på Galeria programu PowerShell. Om du inte skickar något till parametern ModuleVersionOverrides uppdateras alla moduler med de senaste modulversionerna på Galeria programu PowerShell. Det här beteendet är detsamma för knappen Uppdatera Azure-moduler i Azure-Portal.

Nästa steg