Share via

Tekstrunbooks bewerken in Azure Automation

  • Artikel

U kunt de teksteditor in Azure Automation gebruiken om PowerShell-runbooks en PowerShell Workflow-runbooks te bewerken. Deze editor heeft de typische functies van andere code-editors, zoals IntelliSense. Het gebruikt ook kleurcodering met extra speciale functies om u te helpen bij het openen van resources die gebruikelijk zijn voor runbooks.

De teksteditor bevat een functie voor het invoegen van code voor cmdlets, assets en onderliggende runbooks in een runbook. In plaats van zelf in de code te typen, kunt u kiezen uit een lijst met beschikbare resources en de editor voegt de juiste code in het runbook in.

Elk runbook in Azure Automation heeft twee versies, Concept en Gepubliceerd. U bewerkt de conceptversie van het runbook en publiceert deze zodat het kan worden uitgevoerd. De gepubliceerde versie kan niet worden bewerkt. Zie Een runbook publiceren voor meer informatie.

Dit artikel bevat gedetailleerde stappen voor het uitvoeren van verschillende functies met deze editor. Deze zijn niet van toepassing op grafische runbooks. Zie Grafische creatie in Azure Automation om met deze runbooks te werken.

Belangrijk

Neem het trefwoord 'AzureRm' niet op in een script dat is ontworpen om te worden uitgevoerd met de Az-module. Het opnemen van het trefwoord, zelfs in een opmerking, kan ertoe leiden dat AzureRm wordt geladen en vervolgens conflicteren met de Az-module.

Een runbook bewerken met Azure Portal

  1. Selecteer uw Automation-account in Azure Portal.
  2. Selecteer runbooks onder PROCESAUTOMATISERING om de lijst met runbooks te openen.
  3. Kies het runbook dat u wilt bewerken en klik vervolgens op Bewerken.
  4. Bewerk het runbook.
  5. Klik op Opslaan wanneer de bewerkingen zijn voltooid.
  6. Klik op Publiceren als u de nieuwste conceptversie van het runbook wilt publiceren.

Een cmdlet invoegen in een runbook

  1. Plaats de cursor op het canvas van de teksteditor op de positie waar u de cmdlet wilt plaatsen.
  2. Vouw het knooppunt Cmdlets uit in het besturingselement Bibliotheek.
  3. Vouw de module met de cmdlet uit die u wilt gebruiken.
  4. Klik met de rechtermuisknop op de naam van de cmdlet die u wilt invoegen en selecteer Toevoegen aan canvas. Als de cmdlet meer dan één parameterset heeft, wordt de standaardset door de editor toegevoegd. U kunt de cmdlet ook uitvouwen om een andere parameterset te selecteren.
  5. Houd er rekening mee dat de code voor de cmdlet wordt ingevoegd met de volledige lijst met parameters.
  6. Geef een geschikte waarde op in plaats van de waarde tussen punthaken (<>) voor de vereiste parameters. Verwijder alle parameters die u niet nodig hebt.

Code voor een onderliggend runbook invoegen in een runbook

  1. Plaats op het canvas van de teksteditor de cursor op de positie waar u de code voor het onderliggende runbook wilt plaatsen.
  2. Vouw het runbooks-knooppunt in het besturingselement Bibliotheek uit.
  3. Klik met de rechtermuisknop op het runbook om in te voegen en selecteer Toevoegen aan canvas.
  4. De code voor het onderliggende runbook wordt ingevoegd met tijdelijke aanduidingen voor runbookparameters.
  5. Vervang de tijdelijke aanduidingen door de juiste waarden voor elke parameter.

Een asset invoegen in een runbook

  1. Plaats in het besturingselement Canvas van de teksteditor de cursor op de positie waar u de code voor het onderliggende runbook wilt plaatsen.
  2. Vouw het knooppunt Activa uit in het besturingselement Bibliotheek.
  3. Vouw het knooppunt voor het gewenste assettype uit.
  4. Klik met de rechtermuisknop op de naam van de asset die u wilt invoegen en selecteer Toevoegen aan canvas. Voor variabele assets selecteert u 'Variabele ophalen' toevoegen aan canvas of 'Variabele instellen' toevoegen aan canvas, afhankelijk van of u de variabele wilt ophalen of instellen.
  5. Houd er rekening mee dat de code voor de asset wordt ingevoegd in het runbook.

Een Azure Automation-runbook bewerken met Windows PowerShell

Als u een runbook wilt bewerken met Windows PowerShell, gebruikt u de editor van uw keuze en slaat u het runbook op in een PS1-bestand . U kunt de cmdlet Export-AzAutomationRunbook gebruiken om de inhoud van het runbook op te halen. U kunt de cmdlet Import-AzAutomationRunbook gebruiken om het bestaande conceptrunbook te vervangen door het gewijzigde runbook.

De inhoud van een runbook ophalen met Windows PowerShell

De volgende voorbeeldopdrachten laten zien hoe u het script voor een runbook ophaalt en opslaat in een scriptbestand. In dit voorbeeld wordt de conceptversie opgehaald. Het is ook mogelijk om de gepubliceerde versie van het runbook op te halen, hoewel deze versie niet kan worden gewijzigd.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

De inhoud van een runbook wijzigen met Windows PowerShell

De volgende voorbeeldopdrachten laten zien hoe u de bestaande inhoud van een runbook vervangt door de inhoud van een scriptbestand.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Volgende stappen