Så här uppdaterar du Azure PowerShell-moduler i Azure AutomationHow to update Azure PowerShell modules in Azure Automation

Uppdatera Azure moduler i ditt Automation-konto måste du använda den uppdatera Azure-moduler runbook, som är tillgängligt som öppen källkod.To update the Azure modules in your Automation Account you need to use the Update Azure modules runbook, which is available as open source. Att börja använda den uppdatering AutomationAzureModulesForAccount runbook för att uppdatera din Azure-moduler, ladda ned det från den uppdatera Azure-moduler runbook databasen på GitHub.To start using the Update-AutomationAzureModulesForAccount runbook to update your Azure modules, download it from the Update Azure modules runbook repository on GitHub. Du kan sedan importera den till ditt Automation-konto eller köra den som ett skript.You can then import it into your Automation Account or run it as a script. Läs hur du importerar en runbook i ditt Automation-konto i importerar en runbook.To learn how to import a runbook in your Automation Account, see Import a runbook.

De vanligaste AzureRM PowerShell-modulerna som tillhandahålls som standard i varje Automation-konto.The most common AzureRM PowerShell modules are provided by default in each Automation account. Azure-teamet uppdaterar Azure-moduler regelbundet, därför för att hålla dig uppdaterad du vill använda den uppdatering AutomationAzureModulesForAccount runbook för att uppdatera moduler i ditt Automation-konton.The Azure team updates the Azure modules regularly, therefore to keep up to date you will want to use the Update-AutomationAzureModulesForAccount runbook to update the modules in your Automation accounts.

Eftersom modulerna uppdateras regelbundet av produktgruppen och ändringar som kan uppstå med cmdletarna som ingår.Because modules are updated regularly by the product group, changes can occur with the included cmdlets. Den här åtgärden kan negativt påverka dina runbooks beroende på vilken typ av ändring, till exempel byta namn på en parameter eller avvecklar en cmdlet helt och hållet.This action may negatively impact your runbooks depending on the type of change, such as renaming a parameter or deprecating a cmdlet entirely.

För att undvika att påverka dina runbooks och de processer som de automatisera, testa och verifiera innan du fortsätter.To avoid impacting your runbooks and the processes they automate, test and validate before proceeding. Om du inte har ett särskilt Automation-konto som är avsedd för detta ändamål kan du skapa en så att du kan testa många olika scenarier under utvecklingen av dina runbooks.If you don't have a dedicated Automation account intended for this purpose, consider creating one so that you can test many different scenarios during the development of your runbooks. Detta test bör innehålla iterativ ändringar, till exempel uppdaterar PowerShell-moduler.This testing should include iterative changes such as updating the PowerShell modules.

Om du utvecklar dina skript lokalt, rekommenderar vi för att ha samma modulversioner lokalt som du har i ditt Automation-konto när testning för att se till att du får samma resultat.If you develop your scripts locally, it's recommended to have the same module versions locally that you have in your Automation Account when testing to ensure you'll receive the same results. När resultaten verifieras och du har använt alla ändringar som krävs, kan du flytta ändringarna till produktion.After the results are validated and you've applied any changes required, you can move the changes to production.

Anteckning

Ett nytt Automation-konto kan inte innehålla de senaste modulerna.A new Automation account might not contain the latest modules.

ÖvervägandenConsiderations

Här följer några saker att beakta när du använder den här processen för att uppdatera din Azure-moduler:The following are some considerations to take into account when using this process to update your Azure Modules:

  • Denna runbook har stöd för uppdatering av den Azure och AzureRm moduler som standard.This runbook supports updating the Azure and AzureRm modules by default. Denna runbook har stöd för uppdatering av den Az samt moduler.This runbook supports updating the Az modules as well. Granska den uppdatera Azure-moduler runbook README för mer information om hur du uppdaterar Az moduler med denna runbook.Review the Update Azure modules runbook README for more information on updating Az modules with this runbook. Det finns ytterligare viktiga faktorer som du behöver ta hänsyn till när du använder den Az moduler i ditt Automation-konto, mer information, se med hjälp av Az-moduler i ditt Automation-konto.There are additional important factors that you need to take into account when using the Az modules in your Automation Account, to learn more, see Using Az modules in your Automation Account.

  • Innan du startar den här runbooken ska du kontrollera ditt Automation-konto har en Azure kör som-kontouppgiften skapas.Before starting this runbook, make sure your Automation account has an Azure Run As account credential created.

  • Du kan använda den här koden som en vanlig PowerShell-skript i stället för en runbook: bara logga in på Azure med hjälp av den Connect-AzureRmAccount kommandot först och sedan skicka -Login $false till skriptet.You can use this code as a regular PowerShell script instead of a runbook: just sign in to Azure using the Connect-AzureRmAccount command first, then pass -Login $false to the script.

  • Om du vill använda denna runbook på suveräna moln, använder de AzureRmEnvironment parameter för att skicka rätt miljö till runbooken.To use this runbook on the sovereign clouds, use the AzureRmEnvironment parameter to pass the correct environment to the runbook. Godkända värden är AzureCloud, AzureChinaCloud, AzureGermanCloud, och azureusgovernment eller.Acceptable values are AzureCloud, AzureChinaCloud, AzureGermanCloud, and AzureUSGovernment. Dessa värden kan hämtas från att använda Get-AzureRmEnvironment | select Name.These values can be retrieved from using Get-AzureRmEnvironment | select Name. Om du inte skickar ett värde för den här parametern, runbooken som standard i Azures offentliga moln AzureCloudIf you don't pass a value to this parameter, the runbook will default to the Azure public cloud AzureCloud

  • Om du vill använda en specifik version av Azure PowerShell-modulen i stället för den senaste tillgängliga på PowerShell-galleriet, skicka dessa versioner till den valfria ModuleVersionOverrides -parametern för den Update-AutomationAzureModulesForAccountrunbook.If you want to use a specific Azure PowerShell module version instead of the latest available on the PowerShell Gallery, pass these versions to the optional ModuleVersionOverrides parameter of the Update-AutomationAzureModulesForAccount runbook. Exempel finns i den uppdatering AutomationAzureModulesForAccount.ps1 runbook.For examples, see the Update-AutomationAzureModulesForAccount.ps1 runbook. Azure PowerShell-moduler som inte nämns i den ModuleVersionOverrides parametern uppdateras med de senaste modulversionerna på PowerShell-galleriet.Azure PowerShell modules that aren't mentioned in the ModuleVersionOverrides parameter are updated with the latest module versions on the PowerShell Gallery. Om du skickar något till den ModuleVersionOverrides parameter, alla moduler som uppdateras med de senaste modulversionerna på PowerShell-galleriet.If you pass nothing to the ModuleVersionOverrides parameter, all modules are updated with the latest module versions on the PowerShell Gallery. Det här beteendet är samma som den uppdatera Azure-moduler knappen.This behavior is the same as the Update Azure Modules button.

Kända problemKnown issues

Det finns ett känt problem med uppdatering AzureRM-moduler i ett Automation-konto som tillhör en resursgrupp med det numeriska namn som börjar med 0.There is a known issue with updating the AzureRM modules in an Automation Account that is in a resource group with a numeric name that starts with 0. Om du vill uppdatera din Azure-moduler i ditt Automation-konto, måste den vara i en resursgrupp som har ett alfanumeriskt namn.To update your Azure modules in your Automation Account, it must be in a resource group that has an alphanumeric name. Resursgrupper med numeriska namn som börjar med 0 kan inte uppdatera AzureRM-moduler just nu.Resource groups with numeric names starting with 0 are unable to update AzureRM modules at this time.

Nästa stegNext steps

Gå till öppen källkod uppdatera Azure-moduler runbook mer information om den.Visit the open source Update Azure modules runbook to learn more about it.