Hantera Runbooks i Azure AutomationManage runbooks in Azure Automation

Du kan lägga till en Runbook i Azure Automation genom att antingen skapa en ny eller genom att importera en befintlig Runbook från en fil eller Runbook-galleriet.You can add a runbook to Azure Automation by either creating a new one or by importing an existing runbook from a file or the Runbook Gallery. Den här artikeln innehåller information om hur du skapar och importerar Runbooks från en fil.This article provides information on creating and importing runbooks from a file. Du kan få all information om hur du kommer åt community-Runbooks och moduler i Runbook-och modul gallerier för Azure Automation.You can get all of the details on accessing community runbooks and modules in Runbook and module galleries for Azure Automation.

Skapa en runbookCreate a runbook

Du kan skapa en ny Runbook i Azure Automation med någon av Azure-portalerna eller Windows PowerShell.You can create a new runbook in Azure Automation using one of the Azure portals or Windows PowerShell. När runbook har skapats kan du redigera den med hjälp av information i Learning PowerShell-arbetsflöde och grafisk redigering i Azure Automation.Once the runbook has been created, you can edit it using information in Learning PowerShell Workflow and Graphical authoring in Azure Automation.

Skapa en Runbook i Azure PortalCreate a runbook in the Azure portal

  1. Öppna ditt Automation-konto på Azure Portal.In the Azure portal, open your Automation account.
  2. Öppna listan över runbooks genom att välja Runbooks från hubben.From the Hub, select Runbooks to open the list of runbooks.
  3. Klicka på knappen Lägg till en Runbook och skapa sedan en ny Runbook.Click on the Add a runbook button and then Create a new runbook.
  4. Ange ett namn för runbooken och välj dess typ.Type a Name for the runbook and select its Type. Runbook-namn måste börja med en bokstav och kan ha bokstäver, siffror, understreck och bindestreck.The runbook name must start with a letter and can have letters, numbers, underscores, and dashes.
  5. Klicka på skapa för att skapa runbooken och öppna redigeraren.Click Create to create the runbook and open the editor.

Skapa en Runbook med PowerShellCreate a runbook with PowerShell

Du kan använda cmdleten New-AzureRmAutomationRunbook för att skapa en tom PowerShell Workflow-Runbook.You can use the New-AzureRmAutomationRunbook cmdlet to create an empty PowerShell Workflow runbook. Använd typ parametern för att ange någon av de fyra typerna av Runbook.Use the Type parameter to specify one of the four runbook types.

Följande exempel kommandon visar hur du skapar en ny tom Runbook.The following sample commands show how to create a new empty runbook.

New-AzureRmAutomationRunbook -AutomationAccountName MyAccount `
-Name NewRunbook -ResourceGroupName MyResourceGroup -Type PowerShell

Importera en RunbookImport a runbook

Du kan skapa en ny Runbook i Azure Automation genom att importera ett PowerShell-skript eller ett PowerShell-arbetsflöde (. ps1-tillägg), en exporterad grafisk Runbook-fil (. graphrunbook) eller ett python 2-skript (. py-tillägg).You can create a new runbook in Azure Automation by importing a PowerShell script or PowerShell Workflow (.ps1 extension), an exported graphical runbook (.graphrunbook), or a Python 2 script (.py extension). Du måste ange vilken typ av Runbook som skapas under importen, med hänsyn till följande överväganden.You must specify the type of runbook that is created during import, taking into account the following considerations.

  • En .graphrunbook fil kan bara importeras till en ny grafisk Runbookoch grafiska runbooks kan bara skapas från en .graphrunbook fil.A .graphrunbook file may only be imported into a new graphical runbook, and graphical runbooks can only be created from a .graphrunbook file.
  • En .ps1 fil som innehåller ett PowerShell-arbetsflöde kan bara importeras till en PowerShell Workflow-Runbook.A .ps1 file containing a PowerShell Workflow can only be imported into a PowerShell Workflow runbook. Om filen innehåller flera PowerShell-arbetsflöden går det inte att importera.If the file contains multiple PowerShell Workflows, then the import will fail. Du måste spara varje arbets flöde till en egen fil och importera varje separat.You must save each workflow to its own file and import each separately.
  • En .ps1 fil som innehåller ett PowerShell-arbetsflöde ska inte importeras till en PowerShell-Runbookeftersom den inte kan identifieras av PowerShell-skriptet.A .ps1 file containing a PowerShell Workflow should not be imported into a PowerShell runbook, as it cannot be recognized by the PowerShell Script engine.
  • En .ps1 fil som inte innehåller ett arbets flöde kan importeras till antingen en PowerShell-Runbook eller en PowerShell Workflow-Runbook.A .ps1 file that doesn't contain a workflow can be imported into either a PowerShell runbook or a PowerShell Workflow runbook. Om den importeras till en PowerShell Workflow-Runbook, konverteras den till ett arbets flöde, och kommentarer ingår i den Runbook som anger de ändringar som har gjorts.If it is imported into a PowerShell Workflow runbook, then it is converted to a workflow, and comments are included in the runbook specifying the changes that were made.

Så här importerar du en Runbook från en fil med Azure PortalTo import a runbook from a file with the Azure portal

Du kan använda följande procedur för att importera en skript fil till Azure Automation.You can use the following procedure to import a script file into Azure Automation.

Anteckning

Observera att du bara kan importera en. ps1-fil till en PowerShell Workflow-Runbook med hjälp av portalen.Note that you can only import a .ps1 file into a PowerShell Workflow runbook using the portal.

  1. Öppna ditt Automation-konto på Azure Portal.In the Azure portal, open your Automation account.
  2. Öppna listan över runbooks genom att välja Runbooks från hubben.From the Hub, select Runbooks to open the list of runbooks.
  3. Klicka på knappen Lägg till en Runbook och sedan på Importera.Click on the Add a runbook button and then Import.
  4. Klicka på Runbook-fil för att välja den fil som ska importerasClick Runbook file to select the file to import
  5. Om fältet namn är aktiverat har du möjlighet att ändra det.If the Name field is enabled, then you have the option to change it. Runbook-namn måste börja med en bokstav och kan ha bokstäver, siffror, understreck och bindestreck.The runbook name must start with a letter and can have letters, numbers, underscores, and dashes.
  6. Runbook-typen väljs automatiskt, men du kan ändra typen efter att ha vidtagit tillämpliga begränsningar i kontot.The runbook type is automatically selected, but you can change the type after taking the applicable restrictions into account.
  7. Den nya runbooken visas i listan över Runbooks för Automation-kontot.The new runbook appears in the list of runbooks for the Automation Account.
  8. Du måste publicera runbooken innan du kan köra den.You must publish the runbook before you can run it.

Anteckning

När du har importerat en grafisk Runbook eller en grafisk PowerShell-arbetsflöde, har du möjlighet att konvertera till den andra typen om det önskas.After you import a graphical runbook or a graphical PowerShell workflow runbook, you have the option to convert to the other type if wanted. Det går inte att konvertera till en text-Runbook.You can’t convert to a textual runbook.

Så här importerar du en Runbook från en skript fil med Windows PowerShellTo import a runbook from a script file with Windows PowerShell

Du kan använda cmdleten import-AzureRMAutomationRunbook för att importera en skript fil som ett utkast till en PowerShell-Runbook för arbets flöde.You can use the Import-AzureRMAutomationRunbook cmdlet to import a script file as a draft PowerShell Workflow runbook. Om det redan finns en Runbook Miss lyckas importen om du inte använder parametern -Force .If the runbook already exists, the import fails unless you use the -Force parameter.

Följande exempel kommandon visar hur du importerar en skript fil till en Runbook.The following sample commands show how to import a script file into a runbook.

$automationAccountName =  "AutomationAccount"
$runbookName = "Sample_TestRunbook"
$scriptPath = "C:\Runbooks\Sample_TestRunbook.ps1"
$RGName = "ResourceGroup"

Import-AzureRMAutomationRunbook -Name $runbookName -Path $scriptPath `
-ResourceGroupName $RGName -AutomationAccountName $automationAccountName `
-Type PowerShellWorkflow

Testa en RunbookTest a runbook

När du testar en runbook körs utkast versionen och alla åtgärder som den utför slutförs.When you test a runbook, the Draft version is executed and any actions that it performs are completed. Ingen jobb historik skapas, men data strömmarna för utdata och fel visas i fönstret Testa utdata.No job history is created, but the Output and Warning and Error streams are displayed in the Test output Pane. Meddelanden till utförlig data ström visas endast i fönstret utdata om variabeln $VerbosePreference är inställd på Fortsätt.Messages to the Verbose Stream are displayed in the Output Pane only if the $VerbosePreference variable is set to Continue.

Även om utkastet körs körs inte runbooken normalt och utför alla åtgärder mot resurser i miljön.Even though the draft version is being run, the runbook still executes normally and performs any actions against resources in the environment. Därför bör du bara testa Runbooks på icke-produktions resurser.For this reason, you should only test runbooks on non-production resources.

Proceduren för att testa varje typ av Runbook är densamma och det finns ingen skillnad i testningen mellan text redigeraren och den grafiska redigeraren i Azure Portal.The procedure to test each type of runbook is the same, and there's no difference in testing between the textual editor and the graphical editor in the Azure portal.

  1. Öppna utkast versionen av runbooken i text redigeraren eller i en grafisk redigerare.Open the Draft version of the runbook in either the textual editor or graphical editor.
  2. Öppna test sidan genom att klicka på knappen testa .Click the Test button to open the Test page.
  3. Om runbooken har parametrar visas de i den vänstra rutan där du kan ange värden som ska användas för testet.If the runbook has parameters, they'll be listed in the left pane where you can provide values to be used for the test.
  4. Om du vill köra testet på en hybrid Runbook Workerändrar du inställningarna för körning till hybrid Worker och väljer namnet på mål gruppen.If you want to run the test on a Hybrid Runbook Worker, then change Run Settings to Hybrid Worker and select the name of the target group. Annars behåller du standard Azure att köra testet i molnet.Otherwise, keep the default Azure to run the test in the cloud.
  5. Starta testet genom att klicka på knappen Starta .Click the Start button to start the test.
  6. Om Runbook är ett PowerShell-arbetsflöde eller grafisktkan du stoppa eller inaktivera det medan det testas med knapparna under fönstret utdata.If the runbook is PowerShell Workflow or Graphical, then you can stop or suspend it while it's being tested with the buttons underneath the Output Pane. När du pausar runbooken slutförs den aktuella aktiviteten innan den pausas.When you suspend the runbook, it completes the current activity before being suspended. När runbooken har pausats kan du stoppa den eller starta om den.Once the runbook is suspended, you can stop it or restart it.
  7. Granska utdata från runbooken i fönstret utdata.Inspect the output from the runbook in the output pane.

Publicera en runbookPublish a runbook

När du skapar eller importerar en ny Runbook måste du publicera den innan du kan köra den.When you create or import a new runbook, you must publish it before you can run it. Varje Runbook i Automation har ett utkast och en publicerad version.Each runbook in Automation has a Draft and a Published version. Bara den publicerade versionen är tillgängligt och kan köras och bara utkastet som kan redigeras.Only the Published version is available to be run, and only the Draft version can be edited. Den publicerade versionen påverkas inte av ändringar i utkastet.The Published version is unaffected by any changes to the Draft version. När utkast versionen ska göras tillgänglig publicerar du den, vilket skriver över den publicerade versionen med utkastet.When the Draft version should be made available, then you publish it, which overwrites the Published version with the Draft version.

Azure PortalAzure portal

  1. Öppna runbooken i Azure Portal.Open the runbook in the Azure portal.
  2. Klicka på knappen Redigera .Click the Edit button.
  3. Klicka på knappen publicera och sedan på Ja till verifierings meddelandet.Click the Publish button and then Yes to the verification message.

PowerShellPowerShell

Du kan använda cmdleten Publish-AzureRmAutomationRunbook för att publicera en Runbook med Windows PowerShell.You can use the Publish-AzureRmAutomationRunbook cmdlet to publish a runbook with Windows PowerShell. Följande exempel kommandon visar hur du publicerar en exempel-Runbook.The following sample commands show how to publish a sample runbook.

$automationAccountName =  "AutomationAccount"
$runbookName = "Sample_TestRunbook"
$RGName = "ResourceGroup"

Publish-AzureRmAutomationRunbook -AutomationAccountName $automationAccountName `
-Name $runbookName -ResourceGroupName $RGName

Nästa stegNext steps