Azure Automation-runbooktypen

De functie Azure Automation Process Automation ondersteunt verschillende typen runbooks, zoals gedefinieerd in de volgende tabel. Zie Runbook-uitvoering in Azure Automation voor meer informatie over de omgeving voor procesautomatisering.

Type	Description
Powershell	Tekstrunbook op basis van Windows PowerShell-scripts. De momenteel ondersteunde versies zijn: PowerShell 7.2 (GA) en PowerShell 5.1 (GA). Omdat PowerShell 7.1 niet meer wordt ondersteund door PowerShell van het bovenliggende product, raden we u aan runbooks te maken in ondersteunde versie PowerShell 7.2 op lange termijn
PowerShell-werkstroom	Tekstrunbook op basis van Windows PowerShell Workflow-scripting.
Python	Tekstueel runbook op basis van Python-scripts. De momenteel ondersteunde versies zijn: Python 3.8 (GA) en Python 3.10 (preview). Omdat Python 2.7 niet meer wordt ondersteund door bovenliggend product Python, raden we u aan runbooks te maken in langlopende ondersteunde versies.
Grafisch	Grafisch runbook op basis van Windows PowerShell en volledig gemaakt en bewerkt in de grafische editor in Azure Portal.
Grafische PowerShell-werkstroom	Grafisch runbook op basis van Windows PowerShell Workflow en volledig gemaakt en bewerkt in de grafische editor in Azure Portal.

Notitie

Azure Automation volgt de ondersteuningslevenscyclus van powerShell- en Python-taalversies in overeenstemming met de tijdlijnen die respectievelijk door bovenliggende producten powershell en Python zijn gepubliceerd. U wordt aangeraden runbooks te gebruiken met ondersteunde taalversies.

Houd rekening met de volgende overwegingen bij het bepalen welk type moet worden gebruikt voor een bepaald runbook.

• U kunt runbooks niet converteren van grafisch naar teksttype of andersom.
• Er gelden beperkingen bij het gebruik van runbooks van verschillende typen als onderliggende runbooks. Zie Onderliggende runbooks in Azure Automation voor meer informatie.

PowerShell Runbooks

PowerShell-runbooks zijn gebaseerd op Windows PowerShell. U bewerkt de code van het runbook rechtstreeks met de teksteditor in de Azure-portal. U kunt ook elke offlineteksteditor gebruiken en het runbook importeren in Azure Automation.

De PowerShell-versie wordt bepaald door de runtimeversie die is opgegeven (versie 7.2, 7.1 (preview) of 5.1.

Dezelfde Azure-sandbox en Hybrid Runbook Worker kunnen meerdere PowerShell-runbooks uitvoeren die gericht zijn op verschillende runtimeversies naast elkaar.

Notitie

• Op dit moment wordt runtimeversie van PowerShell 7.2 ondersteund voor cloud- en hybride taken in alle openbare regio's, behalve centraal India, UAE - centraal, Israël - centraal, Italië - noord, Duitsland - noord en Gov-clouds.
• Wanneer u Runtime-versie als 7.2 selecteert, worden PowerShell-modules die gericht zijn op 7.2 runtime-versie gebruikt en als u Runtime-versie als 5.1 selecteert, worden PowerShell-modules gebruikt die gericht zijn op 5.1-runtimeversie. Dit is van toepassing op PowerShell 7.1-modules (preview) en runbooks.

Zorg ervoor dat u de juiste runtimeversie voor modules selecteert.

Als u bijvoorbeeld een runbook uitvoert voor een SharePoint-automatiseringsscenario in Runtime versie7.1 (preview), importeert u de module in runtimeversie 7.1 (preview); als u een runbook uitvoert voor een SharePoint-automatiseringsscenario in Runtime versie5.1, importeert u de module in Runtime versie5.1. In dit geval ziet u twee vermeldingen voor de module, één voor Runtime-versie7.1 (preview) en andere voor 5.1.

Notitie

Momenteel worden PowerShell 5.1, PowerShell 7.1 (preview) en PowerShell 7.2 ondersteund.

Voordelen

• Implementeer alle complexe logica met PowerShell-code zonder de andere complexiteit van PowerShell Workflow.
• Start sneller dan PowerShell Workflow-runbooks, omdat ze niet hoeven te worden gecompileerd voordat ze worden uitgevoerd.
• Uitvoeren in Azure en op Hybrid Runbook Workers voor zowel Windows als Linux.

Beperkingen en bekende problemen

Hier volgen de huidige beperkingen en bekende problemen met PowerShell-runbooks:

PowerShell 7.2

Beperkingen

Notitie

Op dit moment wordt runtimeversie van PowerShell 7.2 ondersteund voor cloud- en hybride taken in alle openbare regio's, behalve centraal India, UAE - centraal, Israël - centraal, Italië - noord, Duitsland - noord en Gov-clouds.

• Voor de runtimeversie van PowerShell 7.2 worden de moduleactiviteiten niet geëxtraheerd voor de geïmporteerde modules. Gebruik de Azure Automation-extensie voor VS-code om het ontwerpen van runbooks te vereenvoudigen.
• PowerShell 7.x biedt geen ondersteuning voor werkstromen. Zie de PowerShell-werkstroom voor meer informatie.
• PowerShell 7.x biedt momenteel geen ondersteuning voor ondertekende runbooks.
• Integratie van broncodebeheer biedt geen ondersteuning voor PowerShell 7.2. PowerShell 7.2-runbooks in broncodebeheer worden ook gemaakt in het Automation-account als Runtime 5.1.
• Az-module 8.3.0 is standaard geïnstalleerd. De volledige lijst met onderdeelmodules van de geselecteerde Az-moduleversie wordt weergegeven zodra de Az-versie opnieuw is geconfigureerd met behulp van Azure Portal of API.
• De geïmporteerde PowerShell 7.2-module wordt gevalideerd tijdens het uitvoeren van de taak. Zorg ervoor dat alle afhankelijkheden voor de geselecteerde module ook worden geïmporteerd voor een geslaagde taakuitvoering.
• Azure-runbook biedt geen ondersteuning Start-Job voor -credential.
• Azure biedt geen ondersteuning voor alle PowerShell-invoerparameters. Meer informatie.

Bekende problemen

• Runbooks die afhankelijk zijn van interne bestandspaden, zoals C:\modules mogelijk mislukken vanwege wijzigingen in de back-endinfrastructuur van de service. Wijzig runbookcode om ervoor te zorgen dat er geen afhankelijkheden zijn op interne bestandspaden en gebruik Get-ChildItem om de vereiste modulegegevens op te halen.

• Get-AzStorageAccount cmdlet kan mislukken met een fout: de Get-AzStorageAccount opdracht is gevonden in de module Az.Storage, maar de module kan niet worden geladen.

• Het uitvoeren van onderliggende scripts die worden gebruikt .\child-runbook.ps1 , wordt niet ondersteund.
  Tijdelijke oplossing: Gebruik Start-AutomationRunbook (interne cmdlet) of Start-AzAutomationRunbook (vanuit de Az.Automation-module ) om een ander runbook te starten vanuit een bovenliggend runbook.

• Wanneer u exchangeOnlineManagement-moduleversie 3.0.0 of hoger gebruikt, kunt u fouten ondervinden. U kunt het probleem oplossen door ervoor te zorgen dat u PowerShellGet- en PackageManagement-modules expliciet uploadt.

• Wanneer u de New-AzAutomationVariable cmdlet in Az.Automation Module gebruikt om een variabele van het typeobject te uploaden, werkt de bewerking niet zoals verwacht.

  Tijdelijke oplossing: Converteer het object naar een JSON-tekenreeks met behulp van de cmdlet ConvertTo-Json en upload vervolgens de variabele met de JSON-tekenreeks als waarde. Deze tijdelijke oplossing zorgt ervoor dat de variabele in de Azure Automation-omgeving correct wordt verwerkt als een JSON-tekenreeks.

  Voorbeeld : een PowerShell-object maken dat informatie heeft opgeslagen rond Azure-VM's

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

PowerShell 5.1

Beperkingen

• Runbooks kunnen parallelle verwerking niet gebruiken om meerdere acties parallel uit te voeren.
• Runbooks kunnen geen controlepunten gebruiken om het runbook te hervatten als er een fout optreedt.
• U kunt alleen PowerShell-, PowerShell Workflow-runbooks en grafische runbooks als onderliggende runbooks opnemen met behulp van de cmdlet Start-AzAutomationRunbook , waarmee een nieuwe taak wordt gemaakt.
• Runbooks kunnen de PowerShell-instructie #Requires niet gebruiken, dit wordt niet ondersteund in azure-sandbox of in Hybrid Runbook Workers en kan ertoe leiden dat de taak mislukt.
• Azure-runbook biedt geen ondersteuning Start-Job voor -credential.
• Azure biedt geen ondersteuning voor alle PowerShell-invoerparameters. Meer informatie.

Bekende problemen

• Runbooks die afhankelijk zijn van interne bestandspaden, zoals C:\modules mogelijk mislukken vanwege wijzigingen in de back-endinfrastructuur van de service. Wijzig runbookcode om ervoor te zorgen dat er geen afhankelijkheden zijn op interne bestandspaden en gebruik Get-ChildItem om de vereiste modulegegevens op te halen.

  Voorbeeldscript

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccount cmdlet kan mislukken met een fout: de Get-AzStorageAccount opdracht is gevonden in de module Az.Storage, maar de module kan niet worden geladen.

• PowerShell-runbooks kunnen geen niet-versleutelde variabele asset met een null-waarde ophalen.

• PowerShell-runbooks kunnen geen variabele asset met *~* in de naam ophalen.

• Een Get-Process-bewerking in een lus in een PowerShell-runbook kan vastlopen na ongeveer 80 iteraties.

• Een PowerShell-runbook kan mislukken als er tegelijkertijd een grote hoeveelheid gegevens naar de uitvoerstroom wordt geschreven. U kunt dit probleem meestal omzeilen door het runbook alleen de informatie te laten uitvoeren die nodig is om met grote objecten te werken. In plaats van bijvoorbeeld zonder beperkingen te gebruiken Get-Process , kunt u de cmdlet alleen de vereiste parameters laten uitvoeren zoals in Get-Process | Select ProcessName, CPU.

• Wanneer u exchangeOnlineManagement-moduleversie 3.0.0 of hoger gebruikt, kunnen er fouten optreden. U kunt het probleem oplossen door ervoor te zorgen dat u ook expliciet PowerShellGet- en PackageManagement-modules uploadt.

• Als u module Az.Accounts importeert met versie 2.12.3 of hoger, moet u ervoor zorgen dat u de Newtonsoft.Json v10-module expliciet importeert als PowerShell 5.1-runbooks afhankelijk zijn van deze versie van de module. De tijdelijke oplossing voor dit probleem is het gebruik van PowerShell 7.2-runbooks.

• Wanneer u de New-AzAutomationVariable cmdlet in Az.Automation Module gebruikt om een variabele van het typeobject te uploaden, werkt de bewerking niet zoals verwacht.

  Tijdelijke oplossing: Converteer het object naar een JSON-tekenreeks met behulp van de cmdlet ConvertTo-Json en upload vervolgens de variabele met de JSON-tekenreeks als waarde. Deze tijdelijke oplossing zorgt ervoor dat de variabele in de Azure Automation-omgeving correct wordt verwerkt als een JSON-tekenreeks.

  Voorbeeld : een PowerShell-object maken dat informatie heeft opgeslagen rond Azure-VM's

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

PowerShell 7.1

Beperkingen

• PowerShell 7.1 wordt niet meer ondersteund door PowerShell van het bovenliggende product. U wordt aangeraden nieuwe runbooks te maken in PowerShell 7.2 voor een langetermijnondersteuning en het bijwerken van verouderde runbooks.
• De interne PowerShell-cmdlets van Azure Automation worden niet ondersteund op een Linux Hybrid Runbook Worker. U moet de module automationassets aan het begin van uw PowerShell-runbook importeren om toegang te krijgen tot de functies voor gedeelde resources (assets) van het Automation-account.
• Voor de runtimeversie van PowerShell 7 worden de moduleactiviteiten niet geëxtraheerd voor de geïmporteerde modules.
• Het parametertype PSCredential-runbook wordt niet ondersteund in de runtimeversie van PowerShell 7.
• PowerShell 7.x biedt geen ondersteuning voor werkstromen. Zie PowerShell Workflow voor meer informatie.
• PowerShell 7.x biedt momenteel geen ondersteuning voor ondertekende runbooks.
• Integratie van broncodebeheer biedt geen ondersteuning voor PowerShell 7.1 (preview) Ook worden PowerShell 7.1-runbooks (preview) in broncodebeheer gemaakt in het Automation-account als Runtime 5.1.
• PowerShell 7.1-modulebeheer wordt niet ondersteund via Get-AzAutomationModule-cmdlets.
• Runbook mislukt zonder logboektracering als de invoerwaarde het teken bevat.'
• Azure-runbook biedt geen ondersteuning Start-Job voor -credential.
• Azure biedt geen ondersteuning voor alle PowerShell-invoerparameters. Meer informatie.

Bekende problemen

• Runbooks die afhankelijk zijn van interne bestandspaden, zoals C:\modules mogelijk mislukken vanwege wijzigingen in de back-endinfrastructuur van de service. Wijzig runbookcode om ervoor te zorgen dat er geen afhankelijkheden zijn op interne bestandspaden en gebruik Get-ChildItem om de vereiste modulegegevens op te halen.

  Voorbeeldscript

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccount cmdlet kan mislukken met een fout: de Get-AzStorageAccount opdracht is gevonden in de module Az.Storage, maar de module kan niet worden geladen.

• Het uitvoeren van onderliggende scripts die worden gebruikt .\child-runbook.ps1 , wordt niet ondersteund in deze preview. Tijdelijke oplossing: gebruik Start-AutomationRunbook (interne cmdlet) of Start-AzAutomationRunbook (van Az.Automation module) om een ander runbook te starten vanuit het bovenliggende runbook.

• Runbookeigenschappen die logboekvoorkeur definiëren, worden niet ondersteund in PowerShell 7-runtime. Tijdelijke oplossing: Stel de voorkeur expliciet in aan het begin van het runbook als volgt:

      $VerbosePreference = "Continue"
  
      $ProgressPreference = "Continue"
  

• Vermijd het importeren van Az.Accounts module naar versie 2.4.0 voor PowerShell 7 runtime, omdat er onverwacht gedrag kan optreden met behulp van deze versie in Azure Automation.

• Mogelijk ondervindt u opmaakproblemen met foutuitvoerstromen voor de taak die wordt uitgevoerd in PowerShell 7 Runtime.

• Wanneer u een PowerShell 7.1-module importeert die afhankelijk is van andere modules, is de importknop mogelijk grijs, zelfs wanneer PowerShell 7.1-versie van de afhankelijke module is geïnstalleerd. Bijvoorbeeld de Az PowerShell-module. Compute-versie 4.20.0 heeft een afhankelijkheid van Az.Accounts die = 2.6.0 zijn >. Dit probleem treedt op wanneer een equivalente afhankelijke module in PowerShell 5.1 niet voldoet aan de versievereisten. Bijvoorbeeld: versie 5.1 van Az.Accounts was < 2.6.0.

• Wanneer u PowerShell 7-runbook start met behulp van de webhook, wordt de invoerparameter van de webhook automatisch geconverteerd naar een ongeldige JSON.

• U wordt aangeraden exchangeOnlineManagement-moduleversie 3.0.0 of lager te gebruiken, omdat versie 3.0.0 of hoger kan leiden tot taakfouten.

• Als u module Az.Accounts importeert met versie 2.12.3 of hoger, moet u ervoor zorgen dat u de Newtonsoft.Json v10-module expliciet importeert als PowerShell 7.1-runbooks afhankelijk zijn van deze versie van de module. De tijdelijke oplossing voor dit probleem is het gebruik van PowerShell 7.2-runbooks.

• Wanneer u de New-AzAutomationVariable cmdlet in Az.Automation Module gebruikt om een variabele van het typeobject te uploaden, werkt de bewerking niet zoals verwacht.

  Tijdelijke oplossing: Converteer het object naar een JSON-tekenreeks met behulp van de cmdlet ConvertTo-Json en upload vervolgens de variabele met de JSON-tekenreeks als waarde. Deze tijdelijke oplossing zorgt ervoor dat de variabele in de Azure Automation-omgeving correct wordt verwerkt als een JSON-tekenreeks.

  Voorbeeld : een PowerShell-object maken dat informatie heeft opgeslagen rond Azure-VM's

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

PowerShell Workflow-runbooks

PowerShell Workflow-runbooks zijn tekstrunbooks op basis van Windows PowerShell Workflow. U bewerkt de code van het runbook rechtstreeks met de teksteditor in de Azure-portal. U kunt ook elke offlineteksteditor gebruiken en het runbook importeren in Azure Automation.

Notitie

PowerShell 7.1 (preview) en PowerShell 7.2 bieden geen ondersteuning voor Workflow-runbooks.

Voordelen

• Implementeer alle complexe logica met PowerShell Workflow-code.
• Gebruik controlepunten om de bewerking te hervatten als er een fout optreedt.
• Gebruik parallelle verwerking om meerdere acties parallel uit te voeren.
• Kan andere grafische runbooks en PowerShell Workflow-runbooks als onderliggende runbooks bevatten om werkstromen op hoog niveau te maken.

Beperkingen

• PowerShell-werkstroom wordt niet ondersteund in PowerShell 7+ versies. Daarom kunnen de verouderde runbooks niet worden bijgewerkt.
• Inefficiënte verwerking van parallelle uitvoering vergeleken met nieuwere PowerShell 7+ versies.
• PowerShell Workflow werkt intern met behulp van meerdere processen. Daarom zijn modules die beschikbaar zijn in het ene proces mogelijk niet beschikbaar in een ander proces en kunnen uitzonderingen zoals de opdracht niet worden gevonden.
• Runbooks moeten omgaan met de extra complexiteit van PowerShell Workflow, zoals gedeserialiseerde objecten.
• Het starten van runbooks duurt langer dan PowerShell-runbooks, omdat ze moeten worden gecompileerd voordat ze worden uitgevoerd.
• U kunt PowerShell-runbooks alleen opnemen als onderliggende runbooks met behulp van de Start-AzAutomationRunbook cmdlet.
• Runbooks kunnen niet worden uitgevoerd op een Hybrid Runbook Worker voor Linux.

Python-runbooks

Python-runbooks worden gecompileerd onder Python 2.7(GA), Python 3.8 (GA) en Python 3.10 (preview). U kunt de code van het runbook rechtstreeks bewerken met de teksteditor in de Azure-portal. U kunt ook een offline teksteditor gebruiken en het runbook importeren in Azure Automation.

Momenteel wordt runtimeversie van Python 3.10 (preview) ondersteund voor zowel cloud- als hybride taken in alle openbare regio's, met uitzondering van Australië - centraal2, Korea - zuid, Zweden - zuid, Jio India - centraal, Brazilië - zuid, India - centraal, India - west, UAE - centraal en Gov-clouds.

Voordelen

Notitie

Het importeren van een Python-pakket kan enkele minuten duren.

• Maakt gebruik van de robuuste Python-bibliotheken.
• Kan worden uitgevoerd in Azure of op Hybrid Runbook Workers.
• Voor Python 2.7 worden Windows Hybrid Runbook Workers ondersteund met Python 2.7 geïnstalleerd.
• Voor Python 3.8-cloudtaken wordt python 3.8-versie ondersteund. Scripts en pakketten van elke 3.x-versie werken mogelijk als de code compatibel is in verschillende versies.
• Voor Hybride Python 3.8-taken op Windows-computers kunt u ervoor kiezen om elke 3.x-versie te installeren die u mogelijk wilt gebruiken.
• Voor Hybride Python 3.8-taken op Linux-machines zijn we afhankelijk van de Python 3-versie die op de computer is geïnstalleerd om DSC OMSConfig en de Linux Hybrid Worker uit te voeren. Verschillende versies moeten werken als er geen belangrijke wijzigingen zijn in methodehandtekeningen of contracten tussen versies van Python 3.

Beperkingen

Hieronder volgen de beperkingen van Python-runbooks

Python 3.10 (preview)

• Voor Python 3.10-modules (preview) worden momenteel alleen de wielbestanden ondersteund die gericht zijn op cp310 Linux OS. Meer informatie
• Integratie van broncodebeheer wordt niet ondersteund.
• Aangepaste pakketten voor Python 3.10 (preview) worden alleen gevalideerd tijdens de taakruntime. De taak mislukt naar verwachting als het pakket niet compatibel is in de runtime of als vereiste afhankelijkheden van pakketten niet in het Automation-account worden geïmporteerd.
• Momenteel worden Python 3.10-runbooks (preview) alleen ondersteund vanuit De Azure-portal. Rest API en PowerShell worden niet ondersteund.

Python 3.8 (GA)

• U moet bekend zijn met Python-scripts.
• Integratie van broncodebeheer wordt niet ondersteund.
• Gebruik voor Python 3.8-modules wielbestanden die gericht zijn op cp38-amd64.
• Als u bibliotheken van derden wilt gebruiken, moet u de pakketten importeren in het Automation-account.
• Het gebruik van de Cmdlet Start-AutomationRunbook in PowerShell/PowerShell Workflow om een Python 3.8-runbook te starten, werkt niet. U kunt de cmdlet Start-AzAutomationRunbook gebruiken vanuit de Az.Automation-module of de cmdlet Start-AzureRmAutomationRunbook vanuit de AzureRm.Automation-module om deze beperking te omzeilen. 
• Azure Automation biedt geen ondersteuning voor sys.stderr.
• Het Python AutomationAssets-pakket is niet beschikbaar op pypi.org, dus het is niet beschikbaar voor importeren op een Windows-computer.

Python 2.7

• Python 2.7 wordt niet meer ondersteund door het bovenliggende product Python. U wordt aangeraden nieuwe runbooks te maken in de ondersteunde versies en de verouderde runbooks bij te werken.
• U moet bekend zijn met Python-scripts.
• Gebruik voor Python 2.7.12-modules wheel files cp27-amd6.
• Als u bibliotheken van derden wilt gebruiken, moet u de pakketten importeren in het Automation-account.
• Azure Automation biedt geen ondersteuning voor sys.stderr.
• Het Python AutomationAssets-pakket is niet beschikbaar op pypi.org, dus het is niet beschikbaar voor importeren op een Windows-computer.

Meerdere Python-versies

Dit is van toepassing op Hybride Windows-werkrollen. Voor een Windows Runbook Worker wordt bij het uitvoeren van een Python 2-runbook eerst gezocht naar de omgevingsvariabele PYTHON_2_PATH en wordt gecontroleerd of deze verwijst naar een geldig uitvoerbaar bestand. Als de installatiemap zich bijvoorbeeld bevindt C:\Python2, wordt gecontroleerd of C:\Python2\python.exe het een geldig pad is. Als deze niet wordt gevonden, zoekt deze naar de PATH omgevingsvariabele om een vergelijkbare controle uit te voeren.

Voor Python 3 zoekt het eerst naar de PYTHON_3_PATH env-variabele en vervolgens terug naar de PATH omgevingsvariabele.

Wanneer u slechts één versie van Python gebruikt, kunt u het installatiepad toevoegen aan de PATH variabele. Als u beide versies in Runbook Worker wilt gebruiken, stelt PYTHON_2_PATH u deze in en PYTHON_3_PATH op de locatie van de module voor die versies.

Bekende problemen

Voor cloudtaken mislukken Python 3.8-taken soms met een uitzonderingsbericht invalid interpreter executable path. Deze uitzondering kan worden weergegeven als de taak is vertraagd, meer dan 10 minuten wordt gestart of als u Start-AutomationRunbook gebruikt om Python 3.8-runbooks te starten. Als de taak is vertraagd, moet het opnieuw opstarten van het runbook voldoende zijn.

Grafische runbooks

U kunt grafische PowerShell Werkstroom-runbooks maken en bewerken met behulp van de grafische editor in Azure Portal. U kunt dit type runbook echter niet maken of bewerken met een ander hulpprogramma. Belangrijkste functies van grafische runbooks:

• Geëxporteerd naar bestanden in uw Automation-account en vervolgens geïmporteerd in een ander Automation-account.
• PowerShell-code genereren.
• Geconverteerd naar of van grafische PowerShell Workflow-runbooks tijdens het importeren.

Voordelen

• Visual insert-link-configure ontwerpmodel gebruiken.
• Richt u op de wijze waarop gegevens door het proces stromen.
• Beheerprocessen visueel vertegenwoordigen.
• Voeg andere runbooks toe als onderliggende runbooks om werkstromen op hoog niveau te maken.
• Moedig modulair programmeren aan.

Beperkingen

• Kan niet buiten Azure Portal maken of bewerken.
• Mogelijk is een codeactiviteit met PowerShell-code vereist om complexe logica uit te voeren.
• Kan niet converteren naar een van de tekstindelingen en u kunt ook geen tekstrunbook converteren naar grafische indeling.
• PowerShell-code die door de grafische werkstroom wordt gemaakt, kan niet rechtstreeks worden weergegeven of bewerkt. U kunt de code bekijken die u in alle codeactiviteiten maakt.
• Runbooks kunnen niet worden uitgevoerd op een Linux Hybrid Runbook Worker. Zie Resources automatiseren in uw datacenter of cloud met behulp van Hybrid Runbook Worker.
• Grafische runbooks kunnen niet digitaal worden ondertekend.

Volgende stappen

• Zie Zelfstudie: Een PowerShell-runbook maken voor meer informatie over PowerShell-runbooks.
• Zie zelfstudie: Een PowerShell Workflow-runbook maken voor meer informatie over PowerShell Workflow-runbooks.
• Zie Zelfstudie: Een grafisch runbook maken voor meer informatie over grafische runbooks.
• Zie Zelfstudie: Een Python-runbook maken voor meer informatie over Python-runbooks.