Redigera textrunbooks i Azure Automation

  • Artikel

Du kan använda textredigeraren i Azure Automation för att redigera PowerShell-runbooks och PowerShell Workflow-runbooks. Den här redigeraren har typiska funktioner i andra kodredigerare, till exempel IntelliSense. Den använder också färgkodning med ytterligare specialfunktioner som hjälper dig att komma åt resurser som är gemensamma för runbooks.

Textredigeraren innehåller en funktion för att infoga kod för cmdletar, tillgångar och underordnade runbooks i en runbook. I stället för att skriva in koden själv kan du välja från en lista över tillgängliga resurser och redigeraren infogar lämplig kod i runbooken.

Varje runbook i Azure Automation har två versioner, Draft och Published. Du redigerar utkastversionen av runbooken och publicerar den så att den kan köras. Det går inte att redigera den publicerade versionen. Mer information finns i Publicera en runbook.

Den här artikeln innehåller detaljerade steg för att utföra olika funktioner med den här redigeraren. Dessa gäller inte för grafiska runbooks. Information om hur du arbetar med dessa runbooks finns i Grafisk redigering i Azure Automation.

Viktigt!

Inkludera inte nyckelordet "AzureRm" i något skript som är utformat för att köras med Az-modulen. Inkludering av nyckelordet, även i en kommentar, kan leda till att AzureRm läses in och sedan är i konflikt med Az-modulen.

Redigera en runbook med Azure-portalen

  1. I Azure-portalen väljer du ditt Automation-konto.
  2. Under PROCESSAUTOMATISERING väljer du Runbooks för att öppna listan över runbooks.
  3. Välj den runbook som ska redigeras och klicka sedan på Redigera.
  4. Redigera runbooken.
  5. Klicka på Spara när dina redigeringar har slutförts.
  6. Klicka på Publicera om du vill publicera den senaste utkastversionen av runbooken.

Infoga en cmdlet i en runbook

  1. Placera markören på arbetsytan i textredigeraren där du vill placera cmdleten.
  2. Expandera noden Cmdlets i bibliotekskontrollen.
  3. Expandera modulen som innehåller cmdleten som ska användas.
  4. Högerklicka på cmdletens namn för att infoga och välj Lägg till på arbetsytan. Om cmdleten har fler än en parameteruppsättning lägger redigeraren till standarduppsättningen. Du kan också expandera cmdleten för att välja en annan parameteruppsättning.
  5. Observera att koden för cmdleten infogas med hela listan med parametrar.
  6. Ange ett lämpligt värde i stället för värdet omgivet av vinkelparenteser (<>) för alla obligatoriska parametrar. Ta bort eventuella parametrar som du inte behöver.

Infoga kod för en underordnad runbook i en runbook

  1. Placera markören på arbetsytan i textredigeraren där du vill placera koden för den underordnade runbooken.
  2. Expandera noden Runbooks i bibliotekskontrollen.
  3. Högerklicka på runbooken för att infoga och välj Lägg till på arbetsytan.
  4. Koden för den underordnade runbooken infogas med platshållare för alla runbook-parametrar.
  5. Ersätt platshållarna med lämpliga värden för varje parameter.

Infoga en tillgång i en runbook

  1. Placera markören där du vill placera koden för den underordnade runbooken i arbetsytans kontroll i textredigeraren.
  2. Expandera noden Tillgångar i bibliotekskontrollen.
  3. Expandera noden för önskad tillgångstyp.
  4. Högerklicka på tillgångsnamnet för att infoga och välj Lägg till på arbetsytan. För variabeltillgångar väljer du antingen Lägg till "Hämta variabel" på arbetsytan eller Lägg till "Ange variabel" på arbetsytan, beroende på om du vill hämta eller ange variabeln.
  5. Observera att koden för tillgången infogas i runbooken.

Redigera en Azure Automation-runbook med Hjälp av Windows PowerShell

Om du vill redigera en runbook med Windows PowerShell använder du valfri redigerare och sparar runbooken i en .ps1-fil . Du kan använda cmdleten Export-AzAutomationRunbook för att hämta innehållet i runbooken. Du kan använda cmdleten Import-AzAutomationRunbook för att ersätta den befintliga utkast-runbooken med den ändrade.

Hämta innehållet i en runbook med Hjälp av Windows PowerShell

Följande exempelkommandon visar hur du hämtar skriptet för en runbook och sparar det i en skriptfil. I det här exemplet hämtas utkastversionen. Det går också att hämta den publicerade versionen av runbooken, även om den här versionen inte kan ändras.

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

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

Ändra innehållet i en runbook med Windows PowerShell

Följande exempelkommandon visar hur du ersätter det befintliga innehållet i en runbook med innehållet i en skriptfil.

$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

Nästa steg