Delen via

  • Artikel

Een runbook bewerken

 

Gepubliceerd: juni 2016

Van toepassing op: Windows Azure Pack for Windows Server

Elk runbook in Automatisering van servicebeheer heeft twee versies: een conceptversie en een gepubliceerde versie. U bewerkt de conceptversie van de werkstroom en publiceert deze zodat deze kan worden uitgevoerd. De gepubliceerde versie kan niet worden bewerkt.

Een runbook bewerken met de beheerportal

De beheerportal bevat een editor die u kunt gebruiken voor het weergeven en bewerken van runbooks. Naast eenvoudige tekstbewerkingsmogelijkheden biedt de editor de mogelijkheid om automatisch code in te voegen voor Globale elementen, Activiteiten en Runbooks.

  1. Selecteer in de beheerportal de optie Automation.

  2. Selecteer het tabblad Runbooks.

  3. Klik op de naam van het runbook dat u wilt bewerken.

  4. Selecteer het tabblad Auteur.

  5. Klik op Concept boven aan het scherm of op de knop Bewerken onder aan het scherm.

  6. Voer de vereiste bewerkingen uit.

  7. Klik op Opslaan wanneer de bewerkingen zijn voltooid.

  8. Klik op Publiceren als u wilt dat de meest recente conceptversie van het runbook wordt gepubliceerd.

Code in een runbook invoegen

De Automation-editor bevat een functie voor het invoegen van code voor activiteiten, instellingen en runbooks in een runbook. In plaats van de code zelf in te typen, kunt u deze selecteren in een lijst met beschikbare elementen waarna de juiste code in het runbook wordt ingevoegd.

Code voor een runbook invoegen in een runbook

  1. Open het runbook in de editor van de beheerportal.

  2. Klik aan de onderkant van het scherm op Invoegen en vervolgens op Runbook.

  3. Selecteer het in te voegen runbook in de middelste kolom en klik op de pijl-rechts.

  4. Als het runbook parameters bevat, worden deze weergegeven.

  5. Klik op de knop met het vinkje.

  6. Code voor het uitvoeren van het geselecteerde runbook wordt ingevoegd in het huidige runbook.

  7. Als het runbook parameters vereist, typt u een geschikte waarde op de plaats van het gegevenstype tussen accolades <>.

Een globaal element in een runbook invoegen

  1. Open het runbook in de editor van de beheerportal.

  2. Klik aan de onderkant van het scherm op Invoegen en vervolgens op Instelling.

  3. In de kolom Instellingsactie selecteert u het type code dat u nodig hebt.

  4. Maak een selectie uit de beschikbare elementen in de middelste kolom.

  5. Klik op de knop met het vinkje.

Een activiteit in een runbook invoegen

  1. Open het runbook in de editor van de beheerportal.

  2. Klik aan de onderkant van het scherm op Invoegen en vervolgens op Activiteit.

  3. In de kolom Integratiemodule selecteert u de module die de activiteit bevat.

  4. In het deelvenster Activiteit selecteert u een activiteit.

  5. In de kolom Beschrijving let u op de beschrijving van de activiteit. Eventueel kunt u op Gedetailleerde help weergeven klikken om help voor de activiteit te starten in de browser.

  6. Klik op de pijl-rechts.

  7. Als de activiteit parameters bevat, worden deze weergegeven.

  8. Klik op de knop met het vinkje.

  9. Code voor het uitvoeren van de activiteit, wordt in het runbook ingevoegd.

  10. Als de activiteit parameters vereist, typt u een geschikte waarde op de plaats van het gegevenstype tussen accolades <>.

Een Automation-runbook bewerken met Windows PowerShell

Als u een runbook wilt bewerken met Windows PowerShell, bewerkt u de werkstroom met behulp van een editor naar keuze en slaat u deze op in een .ps1-bestand. U kunt de cmdlet Get-SMARunbookDefinition gebruiken om de inhoud van het runbook op te halen en vervolgens de cmdlet Edit-SMARunbook om de bestaande conceptwerkstroom te vervangen door de gewijzigde.

Als u een nieuw runbook wilt maken uit de inhoud van een scriptbestand, raadpleegt u d14db796-a3e5-4b1d-a098-e734ceae2e0e#ImportRunbookScriptPS.

De inhoud van een runbook ophalen met Windows PowerShell

De volgende voorbeeldopdrachten laten zien hoe u het script voor een runbook ophaalt en dit 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.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

$runbookDefinition = Get-SMARunbookDefinition –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Type Draft
$runbookContent = $runbookDefinition.Content

Out-File -InputObject $runbookContent -FilePath $scriptPath

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 met een werkstroom.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

Edit-SmaRunbook –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Path $scriptPath -Overwrite
Publish-SmaRunbook –WebServiceEndpoint $webServer –Port $port –Name $runbookName –Path $scriptPath