Azure PowerShell modules bijwerken in Automation

Dit artikel beschrijft hoe je Azure PowerShell (Az) modules kunt updaten in Azure Automation. De Az PowerShell-module is een set cmdlets voor het rechtstreeks beheren van Azure-resources vanuit PowerShell. Azure Automation biedt standaard gemeenschappelijke PowerShell-modules in elk Automation-account. Voor meer informatie, zie Standaardmodules. Naarmate het Azure team de Azure modules regelmatig bijwerkt, kunnen er wijzigingen optreden met de opgenomen cmdlets. Bijvoorbeeld het hernoemen van een parameter of het volledig afschaffen van een cmdlet. Deze wijzigingen kunnen bestaande runbooks en automatiseringsprocessen beïnvloeden als de modules niet dienovereenkomstig worden bijgewerkt. Om deze updates te beheren, biedt Azure Automation twee methoden om Az-modules bij te werken:

Notitie

U kunt geen algemene modules verwijderen. Dit zijn standaardmodules van Automation.

Belangrijk

Met de nieuwe runtime-omgevingservaring kunt u modules en pakketten beheren door de taakuitvoeringsomgeving te configureren. In de nieuwe ervaring zijn Modules en Packages blades niet beschikbaar. Zie Runtime-omgeving en bijbehorende runbooks beheren om modules en pakketten te beheren.

Een Automation-account instellen

Om te voorkomen dat dit van invloed is op uw runbooks en de processen die ze automatiseren, moet u testen en valideren wanneer u updates aanbrengt. Als u voor dit doel geen toegewezen Automation-account hebt, kunt u overwegen om er een te maken, zodat u veel verschillende scenario's kunt testen tijdens de ontwikkeling van uw runbooks. Deze test moet iteratieve wijzigingen bevatten, zoals het bijwerken van de PowerShell-modules.

Zorg ervoor dat uw Automation-account een door het systeem toegewezen beheerde identiteit of door de gebruiker toegewezen beheerde identiteit heeft toegevoegd.

Als u uw scripts lokaal ontwikkelt, is het raadzaam om bij het testen dezelfde moduleversies lokaal te hebben die u in uw Automation-account hebt om ervoor te zorgen dat u dezelfde resultaten ontvangt. Nadat de resultaten zijn gevalideerd en je eventuele benodigde wijzigingen hebt toegepast, kun je de wijzigingen naar productie verplaatsen.

Notitie

Een nieuw Automation-account bevat mogelijk niet de meest recente modules.

Az-modules bijwerken

De volgende secties leggen uit hoe je Az-modules kunt updaten via het portaal (aanbevolen) of via het runbook.

Werk Az-modules bij via de Azure-portal

Momenteel is het updaten van Az-modules alleen mogelijk via het portaal. Updates via PowerShell en een ARM-sjabloon zijn in de toekomst beschikbaar. Alleen standaard Az-modules worden bijgewerkt wanneer u de volgende stappen uitvoert:

  1. Meld u aan bij het Azure Portal en ga naar uw Automation-account.

  2. Onder Gedeelde resources selecteert u Modules.

  3. Selecteer Az-modules bijwerken.

  4. Selecteer Module om bij te werken. Standaard toont het de Az-module.

  5. Selecteer in de dropdownlijst Module Version en Runtime version.

  6. Selecteer Update om de Az-module bij te werken naar de versie die je hebt gekozen. Op de pagina Modules kunt u de lijst weergeven zoals hieronder wordt weergegeven:

    Update de Az-modulepagina met selecties.

Als u een versie selecteert die lager is dan de bestaande Az-moduleversie die is geïmporteerd in het Automation-account, wordt de updatebewerking teruggedraaid naar de geselecteerde lagere versie.

U kunt de updatebewerking verifiëren door de moduleversie en statuseigenschap te controleren van de bijgewerkte modules die worden weergegeven in de lijst met modules onder PowerShell-modules.

Het Azure-team werkt regelmatig de moduleversie bij en biedt een optie om de standaard Az-modules te updaten door de moduleversie uit de dropdownlijst te selecteren.

Az-modules bijwerken via runbook

De Azure-modules in uw Automation-account bijwerken:

  1. Gebruik het runbook Update-AutomationAzureModulesForAccount, beschikbaar als open source.
  2. Download uit de GitHub opslagplaats om dit runbook te gebruiken om uw Azure-modules bij te werken.
  3. Importeer het in uw Automation-account of voer het uit als een script. Zie Een runbook importeren voor meer informatie over het importeren van een runbook in uw Automation-account.

Notitie

U wordt aangeraden Az-modules bij te werken via Azure portal. U kunt dit ook uitvoeren met behulp van het Update-AutomationAzureModulesForAccount script, beschikbaar als opensource en opgegeven als referentie. In het geval van een runbookfout moet u echter parameters in het runbook wijzigen zoals vereist of fouten opsporen in het script volgens het scenario.

Het runbook Update-AutomationAzureModulesForAccount ondersteunt het standaard bijwerken van de modules Azure, AzureRM en Az. Raadpleeg de README van het runbook Update Azure-modules voor meer informatie over het updaten van Az. Automatiseringsmodules met dit runbook. Er zijn andere belangrijke factoren waarmee je rekening moet houden bij het gebruik van de Az-modules in je Automation-account. Zie Manage-modules in Azure Automation voor meer informatie.

De updaterunbookcode gebruiken als een normaal PowerShell-script

U kunt de runbookcode gebruiken als een gewoon PowerShell-script in plaats van een runbook. Om dit te doen, log je eerst in bij Azure door de Connect-AzAccount-cmdlet te gebruiken en vervolgens door te geven -Login $false aan het script.

Het updaterunbook gebruiken in onafhankelijke clouds

Als u dit runbook wilt gebruiken in onafhankelijke clouds, gebruikt u de AzEnvironment parameter om de juiste omgeving door te geven aan het runbook. Acceptabele waarden zijn AzureCloud (Azure openbare cloud), AzureChinaCloud, AzureGermanCloud en AzureUSGovernment. Je kunt deze waarden ophalen door gebruik te maken van Get-AzEnvironment | select Name. Als u geen waarde doorgeeft aan deze cmdlet, wordt het runbook standaard ingesteld op AzureCloud.

Het updaterunbook gebruiken om een specifieke moduleversie bij te werken

Als u een specifieke Azure PowerShell moduleversie wilt gebruiken in plaats van de meest recente module die beschikbaar is op de PowerShell Gallery, geeft u deze versies door aan de optionele parameter ModuleVersionOverrides van het runbook Update-AutomationAzureModulesForAccount. Zie het runbook Update-AutomationAzureModulesForAccount.ps1 voor voorbeelden. Azure PowerShell modules die niet worden vermeld in de parameter ModuleVersionOverrides, worden bijgewerkt met de nieuwste moduleversies op de PowerShell Gallery. Als u niets doorgeeft aan de parameter ModuleVersionOverrides, worden alle modules bijgewerkt met de nieuwste moduleversies op de PowerShell Gallery. Dit gedrag is hetzelfde voor de knop Update Azure Modules in de Azure-portal.

Volgende stappen