Skapa grafiska runbooks i Azure Automation

Viktigt!

Azure Automation Kör som-konton, inklusive klassiska Kör som-konton, har dragits tillbaka den 30 september 2023 och ersatts med hanterade identiteter. Du skulle inte längre kunna skapa eller förnya Kör som-konton via Azure-portalen. Mer information finns i Migrera från ett befintligt Kör som-konto till hanterad identitet.

Alla runbooks i Azure Automation är Windows PowerShell-arbetsflöden. Grafiska runbooks och grafiska PowerShell-arbetsflödesrunbooks genererar PowerShell-kod som Automation-arbetarna kör men som du inte kan visa eller ändra. Du kan konvertera en grafisk runbook till en grafisk PowerShell Workflow-runbook och vice versa. Du kan dock inte konvertera dessa runbooks till en text runbook. Dessutom kan den grafiska Automation-redigeraren inte importera en text runbook.

Med grafisk redigering kan du skapa runbooks för Azure Automation utan komplexiteten i den underliggande Windows PowerShell- eller PowerShell-arbetsflödeskoden. Du kan lägga till aktiviteter på arbetsytan från ett bibliotek med cmdletar och runbooks, länka ihop dem och konfigurera dem så att de bildar ett arbetsflöde. Om du någonsin har arbetat med System Center Orchestrator eller Service Management Automation (SMA) bör grafisk redigering se bekant ut. Den här artikeln ger en introduktion till de begrepp du behöver för att komma igång med att skapa en grafisk runbook.

Kommentar

Du kan inte lägga till en digital signatur i en grafisk runbook. Den här funktionen stöds inte i Azure Automation.

Översikt över grafisk redigerare

Du kan öppna den grafiska redigeraren i Azure-portalen genom att skapa eller redigera en grafisk runbook.

Graphical workspace

I följande avsnitt beskrivs kontrollerna i den grafiska redigeraren.

Arbetsytekontroll

Med kontrollen Arbetsyta kan du utforma din runbook. Du kan lägga till aktiviteter från noderna i bibliotekskontrollen till runbooken och ansluta dem med länkar för att definiera runbook-logik. Längst ned på arbetsytan finns kontroller som gör att du kan zooma in och ut.

Bibliotekskontroll

Med bibliotekskontrollen kan du välja aktiviteter som ska läggas till i din runbook. Du lägger till dem på arbetsytan, där du kan ansluta dem till andra aktiviteter. Bibliotekskontrollen innehåller de avsnitt som definierats i följande tabell.

Avsnitt Description
Cmdletar Alla cmdletar som kan användas i din runbook. Cmdletar ordnas efter modul. Alla moduler som du har installerat i ditt Automation-konto är tillgängliga.
Runbooks Runbooks i ditt Automation-konto. Du kan lägga till dessa runbooks på arbetsytan som ska användas som underordnade runbooks. Endast runbooks av samma kärntyp som den runbook som redigeras visas. För grafiska runbooks visas endast PowerShell-baserade runbooks. För grafiska PowerShell-arbetsflödesrunbooks visas endast PowerShell-arbetsflödesbaserade runbooks.
Tillgångar Automation-tillgångarna i ditt Automation-konto som du kan använda i din runbook. Om du lägger till en tillgång i en runbook läggs en arbetsflödesaktivitet till som hämtar den valda tillgången. När det gäller variabeltillgångar kan du välja om du vill lägga till en aktivitet för att hämta variabeln eller ange variabeln.
Runbook Control Kontrollera aktiviteter som kan användas i din aktuella runbook. En junction-aktivitet tar flera indata och väntar tills alla har slutförts innan arbetsflödet fortsätter. En kodaktivitet kör en eller flera rader med PowerShell- eller PowerShell-arbetsflödeskod, beroende på den grafiska runbook-typen. Du kan använda den här aktiviteten för anpassad kod eller för funktioner som är svåra att uppnå med andra aktiviteter.

Konfigurationskontroll

Med konfigurationskontrollen kan du ange information om ett objekt som har valts på arbetsytan. Vilka egenskaper som är tillgängliga i den här kontrollen beror på vilken typ av objekt som valts. När du väljer ett alternativ i konfigurationskontrollen öppnas ytterligare blad för att ge mer information.

Testkontroll

Testkontrollen visas inte när den grafiska redigeraren startas. Den öppnas när du interaktivt testar en grafisk runbook.

Använda aktiviteter

Aktiviteter är byggstenarna i en runbook. En aktivitet kan vara en PowerShell-cmdlet, en underordnad runbook eller ett arbetsflöde. Du kan lägga till en aktivitet i runbooken genom att högerklicka på den i bibliotekskontrollen och välja Lägg till på arbetsytan. Du kan sedan klicka och dra aktiviteten för att placera den var som helst på arbetsytan som du vill. Platsen för aktiviteten på arbetsytan påverkar inte körningen av runbooken. Du kan lägga ut din runbook på det sätt som passar bäst för att visualisera dess drift.

Add to canvas

Välj en aktivitet på arbetsytan för att konfigurera dess egenskaper och parametrar på bladet Konfiguration. Du kan ändra aktivitetens etikett till ett namn som du tycker är beskrivande. Runbooken kör fortfarande den ursprungliga cmdleten. Du ändrar bara visningsnamnet som den grafiska redigeraren använder. Observera att etiketten måste vara unik i runbooken.

Parameteruppsättningar

En parameteruppsättning definierar obligatoriska och valfria parametrar som accepterar värden för en viss cmdlet. Alla cmdletar har minst en parameteruppsättning och vissa har flera uppsättningar. Om en cmdlet har flera parameteruppsättningar måste du välja den som ska användas innan du kan konfigurera parametrar. Du kan ändra parameteruppsättningen som används av en aktivitet genom att välja Parameteruppsättning och välja en annan uppsättning. I det här fallet går alla parametervärden som du redan har konfigurerat förlorade.

I följande exempel har Get-AzVM-cmdleten tre parameteruppsättningar. I exemplet används en uppsättning med namnet ListLocationVirtualMachinesParamSet, med en enda valfri parameter, för att returnera platsen för de virtuella datorer som ska visas. I exemplet används också parameteruppsättningen GetVirtualMachineInResourceGroupParamSet för att ange vilken virtuell dator som ska returneras. Den här uppsättningen har två obligatoriska parametrar och en valfri parameter.

Parameter set

Parametervärden

När du anger ett värde för en parameter väljer du en datakälla för att avgöra hur värdet anges. Vilka datakällor som är tillgängliga för en viss parameter beror på de giltiga värdena för parametern. Null är till exempel inte ett tillgängligt alternativ för en parameter som inte tillåter null-värden.

Datakälla Description
Konstant värde Ange ett värde för parametern. Den här datakällan är endast tillgänglig för följande datatyper: Int32, Int64, String, Boolean, DateTime, Switch.
Aktivitetsutdata Använd utdata från en aktivitet som föregår den aktuella aktiviteten i arbetsflödet. Alla giltiga aktiviteter visas. För parametervärdet använder du bara den aktivitet som genererar utdata. Om aktiviteten matar ut ett objekt med flera egenskaper kan du skriva in namnet på en specifik egenskap när du har valt aktiviteten.
Runbook-indata Välj en runbook-indata som indata för aktivitetsparametern.
Variabeltillgång Välj en Automation-variabel som indata.
Tillgång för autentiseringsuppgifter Välj en Automation-autentiseringsuppgift som indata.
Certifikattillgång Välj ett Automation-certifikat som indata.
Anslut ionstillgång Välj en Automation-anslutning som indata.
PowerShell-uttryck Ange ett enkelt PowerShell-uttryck. Uttrycket utvärderas innan aktiviteten och resultatet används för parametervärdet. Du kan använda variabler för att referera till utdata från en aktivitet eller en runbook-indataparameter.
Inte konfigurerat Rensa alla värden som tidigare har konfigurerats.

Valfria ytterligare parametrar

Alla cmdletar har möjlighet att ange ytterligare parametrar. Det här är PowerShell-vanliga parametrar eller andra anpassade parametrar. Den grafiska redigeraren visar en textruta där du kan ange parametrar med hjälp av PowerShell-syntax. Om du till exempel vill använda den Verbose gemensamma parametern bör du ange -Verbose:$True.

Återförsöksaktivitet

Återförsöksfunktioner för en aktivitet gör att den kan köras flera gånger tills ett visst villkor uppfylls, ungefär som en loop. Du kan använda den här funktionen för aktiviteter som ska köras flera gånger, som är felbenägna, som kan behöva mer än ett försök att lyckas eller testa utdatainformationen för aktiviteten för giltiga data.

När du aktiverar återförsök för en aktivitet kan du ange en fördröjning och ett villkor. Fördröjningen är den tid (mätt i sekunder eller minuter) som runbooken väntar innan den kör aktiviteten igen. Om du inte anger någon fördröjning körs aktiviteten igen omedelbart när den har slutförts.

Screenshot of the Enable retry feature settings.

Återförsöksvillkoret är ett PowerShell-uttryck som utvärderas efter varje gång aktiviteten körs. Om uttrycket matchas till Sant körs aktiviteten igen. Om uttrycket matchas till False körs aktiviteten inte igen och runbooken går vidare till nästa aktivitet.

Screenshot showing the Retry until this condition is true field and examples of PowerShell expressions that can be used in the retry condition.

Återförsöksvillkoret kan använda en variabel med namnet RetryData som ger åtkomst till information om aktivitetsförsöken. Den här variabeln har egenskaperna i följande tabell:

Property Beskrivning
NumberOfAttempts Antal gånger som aktiviteten har körts.
Output Utdata från den senaste körningen av aktiviteten.
TotalDuration Tidsåtgången har förflutit sedan aktiviteten startades första gången.
StartedAt Tid (i UTC-format) när aktiviteten först startades.

Följande är exempel på villkor för återförsök av aktiviteter.

# Run the activity exactly 10 times.
$RetryData.NumberOfAttempts -ge 10
# Run the activity repeatedly until it produces any output.
$RetryData.Output.Count -ge 1
# Run the activity repeatedly until 2 minutes has elapsed.
$RetryData.TotalDuration.TotalMinutes -ge 2

När du har konfigurerat ett återförsöksvillkor för en aktivitet innehåller aktiviteten två visuella tips som påminner dig. Den ena visas i aktiviteten och den andra visas när du granskar aktivitetens konfiguration.

Activity Retry Visual Indicators

Skriptkontroll för arbetsflöde

En skriptkontroll för arbetsflöden är en särskild aktivitet som accepterar PowerShell- eller PowerShell-arbetsflödesskript, beroende på vilken typ av grafisk runbook som skapas. Den här kontrollen innehåller funktioner som kanske inte är tillgängliga på annat sätt. Den kan inte acceptera parametrar, men den kan använda variabler för aktivitetsutdata och runbook-indataparametrar. Alla utdata från aktiviteten läggs till i databussen. Ett undantag är utdata utan utgående länk, i vilket fall utdata läggs till i runbookens utdata.

Följande kod utför till exempel datumberäkningar med hjälp av en runbook-indatavariabel med namnet NumberOfDays. Sedan skickas ett beräknat DateTime-värde som utdata som ska användas av efterföljande aktiviteter i runbooken.

$DateTimeNow = (Get-Date).ToUniversalTime()
$DateTimeStart = ($DateTimeNow).AddDays(-$NumberOfDays)}
$DateTimeStart

En länk i en grafisk runbook ansluter två aktiviteter. Den visas på arbetsytan som en pil som pekar från källaktiviteten till målaktiviteten. Aktiviteterna körs i pilens riktning och målaktiviteten startar när källaktiviteten har slutförts.

Du kan skapa en länk mellan två aktiviteter genom att välja källaktiviteten och klicka på cirkeln längst ned i formen. Dra pilen till målaktiviteten och släppet.

Create a link

Välj länken för att konfigurera dess egenskaper på bladet Konfiguration. Egenskaperna inkluderar länktypen, som beskrivs i följande tabell.

Länktyp Description
Pipeline Målaktiviteten körs en gång för varje objekt som utdata från källaktiviteten. Målaktiviteten körs inte om källaktiviteten inte resulterar i några utdata. Utdata från källaktiviteten är tillgängliga som ett objekt.
Sequence Målaktiviteten körs bara en gång när den tar emot utdata från källaktiviteten. Utdata från källaktiviteten är tillgängliga som en matris med objekt.

Starta runbook-aktivitet

En grafisk runbook börjar med aktiviteter som inte har någon inkommande länk. Det finns ofta bara en aktivitet som fungerar som startaktivitet för runbooken. Om flera aktiviteter inte har någon inkommande länk börjar runbooken genom att köra dem parallellt. Den följer länkarna för att köra andra aktiviteter när var och en slutförs.

När du anger ett villkor på en länk körs målaktiviteten endast om villkoret matchar True. Du använder vanligtvis en ActivityOutput variabel i ett villkor för att hämta utdata från källaktiviteten.

För en pipelinelänk måste du ange ett villkor för ett enskilt objekt. Runbooken utvärderar villkoret för varje objekt som matas ut av källaktiviteten. Den kör sedan målaktiviteten för varje objekt som uppfyller villkoret. Med en källaktivitet på Get-AzVMkan du till exempel använda följande syntax för en länk för villkorsstyrd pipeline för att hämta endast virtuella datorer i resursgruppen med namnet Grupp1.

$ActivityOutput['Get Azure VMs'].Name -match "Group1"

För en sekvenslänk utvärderar runbooken bara villkoret en gång, eftersom en enskild matris som innehåller alla objekt från källaktiviteten returneras. Därför kan runbooken inte använda en sekvenslänk för filtrering, som den kan med en pipelinelänk. Sekvenslänken kan helt enkelt avgöra om nästa aktivitet körs eller inte.

Ta till exempel följande uppsättning aktiviteter i vår Runbook för starta virtuell dator :

Conditional Link with Sequences

Runbooken använder tre olika sekvenslänkar som verifierar värdena för indataparametrarna VMName och ResourceGroupName för att fastställa vilken åtgärd som ska vidtas. Möjliga åtgärder är att starta en enskild virtuell dator, starta alla virtuella datorer i resursgruppen eller starta alla virtuella datorer i en prenumeration. För sekvenslänken mellan Connect to Azure och Get single VMär här villkorslogik:

<#
Both VMName and ResourceGroupName runbook input parameters have values
#>
(
(($VMName -ne $null) -and ($VMName.Length -gt 0))
) -and (
(($ResourceGroupName -ne $null) -and ($ResourceGroupName.Length -gt 0))
)

När du använder en villkorsstyrd länk filtreras de data som är tillgängliga från källaktiviteten till andra aktiviteter i den grenen efter villkoret. Om en aktivitet är källan till flera länkar beror de data som är tillgängliga för aktiviteter i varje gren på villkoret i länken som ansluter till den grenen.

Aktiviteten i runbooken nedan startar till exempel Start-AzVM alla virtuella datorer. Den har två villkorsstyrda länkar. Den första villkorsstyrda länken använder uttrycket $ActivityOutput['Start-AzVM'].IsSuccessStatusCode -eq $true för att filtrera om Start-AzVM aktiviteten har slutförts. Den andra villkorsstyrda länken använder uttrycket $ActivityOutput['Start-AzVM'].IsSuccessStatusCode -ne $true för att filtrera om Start-AzVm aktiviteten inte startar den virtuella datorn.

Conditional link example

Alla aktiviteter som följer den första länken och som använder aktivitetsutdata från Get-AzureVM hämtar bara de virtuella datorer som startades när Get-AzureVM den kördes. Alla aktiviteter som följer den andra länken hämtar bara de virtuella datorer som stoppades vid den tidpunkt då Get-AzureVM den kördes. Alla aktiviteter som följer den tredje länken hämtar alla virtuella datorer oavsett deras körningstillstånd.

Använda korsningar

En korsning är en särskild aktivitet som väntar tills alla inkommande grenar har slutförts. Detta gör att runbooken kan köra flera aktiviteter parallellt och se till att alla har slutförts innan du går vidare.

En korsning kan ha ett obegränsat antal inkommande länkar, men endast en av dessa länkar kan vara en pipeline. Antalet inkommande sekvenslänkar är inte begränsat. Du kan skapa korsningen med flera inkommande pipelinelänkar och spara runbooken, men den misslyckas när den körs.

Exemplet nedan är en del av en runbook som startar en uppsättning virtuella datorer samtidigt som korrigeringar som ska tillämpas på dessa datorer laddas ned samtidigt. Den använder en korsning för att säkerställa att båda processerna slutförs innan runbooken fortsätter.

Junction

Arbeta med cykler

En cykel skapas när en målaktivitet länkar tillbaka till källaktiviteten eller till en annan aktivitet som så småningom länkar tillbaka till källan. Grafisk redigering stöder för närvarande inte cykler. Om runbooken har en cykel sparas den korrekt men får ett fel när den körs.

Cycle

Dela data mellan aktiviteter

Alla data som en aktivitet matar ut med en utgående länk skrivs till databussen för runbooken. Alla aktiviteter i runbooken kan använda data i databussen för att fylla i parametervärden eller inkludera i skriptkod. En aktivitet kan komma åt utdata från en tidigare aktivitet i arbetsflödet.

Hur data skrivs till databussen beror på typen av länk för aktiviteten. För en pipelinelänk matas data ut som flera objekt. För en sekvenslänk matas data ut som en matris. Om det bara finns ett värde utdata som en matris med ett element.

Din runbook har två sätt att komma åt data på databussen:

  • Använd en datakälla för aktivitetsutdata.
  • Använd en PowerShell-uttrycksdatakälla.

Den första mekanismen använder en datakälla för aktivitetsutdata för att fylla i en parameter för en annan aktivitet. Om utdata är ett objekt kan runbooken ange en enda egenskap.

activity output

Den andra dataåtkomstmekanismen hämtar utdata från en aktivitet i en PowerShell-uttrycksdatakälla eller en arbetsflödesskriptaktivitet med en ActivityOutput variabel med hjälp av syntaxen som visas nedan. Om utdata är ett objekt kan din runbook ange en enda egenskap.

$ActivityOutput['Activity Label']
$ActivityOutput['Activity Label'].PropertyName

Använda kontrollpunkter

Du kan ange kontrollpunkter i en grafisk PowerShell Workflow-runbook genom att välja Kontrollpunkts-runbook för alla aktiviteter. Detta gör att en kontrollpunkt anges efter att aktiviteten har körts.

Checkpoint

Kontrollpunkter är endast aktiverade i grafiska PowerShell-arbetsflödesrunbooks och är inte tillgängliga i grafiska runbooks. Om runbooken använder Azure-cmdletar bör den följa alla kontrollpunktsaktiviteter med en Connect-AzAccount aktivitet. Anslutningsåtgärden används om runbooken pausas och måste startas om från den här kontrollpunkten på en annan arbetare.

Hantera runbook-indata

En runbook kräver indata antingen från en användare som startar runbooken via Azure-portalen eller från en annan runbook, om den aktuella används som underordnad. För en runbook som till exempel skapar en virtuell dator kan användaren behöva ange sådan information som namnet på den virtuella datorn och andra egenskaper varje gång runbooken startas.

Runbooken accepterar indata genom att definiera en eller flera indataparametrar. Användaren tillhandahåller värden för dessa parametrar varje gång runbooken startas. När användaren startar runbooken med hjälp av Azure-portalen uppmanas användaren att ange värden för varje indataparameter som stöds av runbooken.

När du redigerar din runbook kan du komma åt dess indataparametrar genom att klicka på Indata och utdata i runbook-verktygsfältet. Då öppnas in- och utdatakontrollen där du kan redigera en befintlig indataparameter eller skapa en ny genom att klicka på Lägg till indata.

Add input

Varje indataparameter definieras av egenskaperna i följande tabell:

Property Beskrivning
Namn Obligatoriska. Namnet på parametern. Namnet måste vara unikt i runbooken. Den måste börja med en bokstav och får endast innehålla bokstäver, siffror och understreck. Namnet får inte innehålla ett blanksteg.
Description Valfritt. Beskrivning av syftet med indataparametern.
Type Valfritt. Datatypen förväntas för parametervärdet. Azure-portalen tillhandahåller en lämplig kontroll för datatypen för varje parameter när du frågar efter indata. Parametertyper som stöds är String, Int32, Int64, Decimal, Boolean, DateTime och Object. Om en datatyp inte är markerad är den standardinställningen Sträng.
Obligatorisk Valfritt. Inställning som anger om ett värde måste anges för parametern. Om du väljer yesmåste ett värde anges när runbooken startas. Om du väljer nokrävs inget värde när runbooken startas och ett standardvärde kan användas. Det går inte att starta runbooken om du inte anger ett värde för varje obligatorisk parameter som inte har något definierat standardvärde.
Standardvärde Valfritt. Värdet som används för en parameter om en inte skickas när runbooken startas. Om du vill ange ett standardvärde väljer du Custom. Välj None om du inte vill ange något standardvärde.

Hantera runbook-utdata

Grafisk redigering sparar data som skapats av aktiviteter som inte har någon utgående länk till runbookens utdata. Utdata sparas med runbook-jobbet och är tillgängligt för en överordnad runbook när runbooken används som underordnad.

Arbeta med PowerShell-uttryck

En av fördelarna med grafisk redigering är att du kan skapa en runbook med minimal kunskap om PowerShell. För närvarande behöver du dock känna till lite PowerShell för att fylla i vissa parametervärden och för att ange länkvillkor. Det här avsnittet innehåller en snabb introduktion till PowerShell-uttryck. Fullständig information om PowerShell finns på Skript med Windows PowerShell.

Använda ett PowerShell-uttryck som datakälla

Du kan använda ett PowerShell-uttryck som datakälla för att fylla i värdet för en aktivitetsparameter med resultatet av PowerShell-kod. Uttrycket kan vara en enda kodrad som utför en enkel funktion eller flera rader som utför viss komplex logik. Alla utdata från ett kommando som inte har tilldelats till en variabel matas ut till parametervärdet.

Följande kommando matar till exempel ut det aktuella datumet.

Get-Date

Nästa kodfragment skapar en sträng från det aktuella datumet och tilldelar den till en variabel. Koden skickar innehållet i variabeln till utdata.

$string = "The current date is " + (Get-Date)
$string

Följande kommandon utvärderar det aktuella datumet och returnerar en sträng som anger om den aktuella dagen är en helg eller en veckodag.

$date = Get-Date
if (($date.DayOfWeek = "Saturday") -or ($date.DayOfWeek = "Sunday")) { "Weekend" }
else { "Weekday" }

Använda aktivitetsutdata

Om du vill använda utdata från en tidigare aktivitet i din runbook använder du variabeln ActivityOutput med följande syntax.

$ActivityOutput['Activity Label'].PropertyName

Du kan till exempel ha en aktivitet med en egenskap som kräver namnet på en virtuell dator. I det här fallet kan din runbook använda följande uttryck.

$ActivityOutput['Get-AzureVM'].Name

Om egenskapen kräver objektet för den virtuella datorn i stället för bara ett namn returnerar runbooken hela objektet med hjälp av följande syntax.

$ActivityOutput['Get-AzureVM']

Runbooken kan använda utdata från en aktivitet i ett mer komplext uttryck, till exempel följande. Det här uttrycket sammanfogar text till namnet på den virtuella datorn.

"The computer name is " + $ActivityOutput['Get-AzureVM'].Name

Jämför värden

Använd jämförelseoperatorer för att jämföra värden eller avgöra om ett värde matchar ett angivet mönster. En jämförelse returnerar värdet True eller False.

Följande villkor avgör till exempel om den virtuella datorn från en aktivitet med namnet Get-AzureVM för närvarande stoppas.

$ActivityOutput["Get-AzureVM"].PowerState -eq "Stopped"

Följande villkor avgör om samma virtuella dator är i något annat tillstånd än stoppad.

$ActivityOutput["Get-AzureVM"].PowerState -ne "Stopped"

Du kan ansluta flera villkor i din runbook med hjälp av en logisk operator, till exempel -and eller -or. Följande villkor kontrollerar till exempel om den virtuella datorn i föregående exempel är i tillståndet Stoppad eller Stoppad.

($ActivityOutput["Get-AzureVM"].PowerState -eq "Stopped") -or ($ActivityOutput["Get-AzureVM"].PowerState -eq "Stopping")

Använda hashtables

Hashtables är namn/värde-par som är användbara för att returnera en uppsättning värden. Du kan också se en hashtable som kallas en ordlista. Egenskaper för vissa aktiviteter förväntar sig en hashtable i stället för ett enkelt värde.

Skapa en hashtable med hjälp av följande syntax. Den kan innehålla valfritt antal poster, men var och en definieras av ett namn och värde.

@{ <name> = <value>; [<name> = <value> ] ...}

Följande uttryck skapar till exempel en hashtable som ska användas som datakälla för en aktivitetsparameter som förväntar sig en hashtabell med värden för en internetsökning.

$query = "Azure Automation"
$count = 10
$h = @{'q'=$query; 'lr'='lang_ja';  'count'=$Count}
$h

I följande exempel används utdata från en aktivitet som anropas Get Twitter Connection för att fylla i en hashtable.

@{'ApiKey'=$ActivityOutput['Get Twitter Connection'].ConsumerAPIKey;
    'ApiSecret'=$ActivityOutput['Get Twitter Connection'].ConsumerAPISecret;
    'AccessToken'=$ActivityOutput['Get Twitter Connection'].AccessToken;
    'AccessTokenSecret'=$ActivityOutput['Get Twitter Connection'].AccessTokenSecret}

Autentisera till Azure-resurser

Runbooks i Azure Automation som hanterar Azure-resurser kräver autentisering till Azure. Hanterade identiteter är standardmekanismen som en Automation-runbook använder för att komma åt Azure Resource Manager-resurser i din prenumeration. Du kan lägga till den här funktionen i en grafisk runbook genom att importera följande runbook till automationskontot, som utnyttjar den systemtilldelade hanterade identiteten för automationskontot för att autentisera och komma åt Azure-resurser.

wget https://raw.githubusercontent.com/azureautomation/runbooks/master/Utility/AzMI/AzureAutomationTutorialWithIdentityGraphical.graphrunbook -outfile AzureAutomationTutorialWithIdentityGraphical.graphrunbook

Exportera en grafisk runbook

Du kan bara exportera den publicerade versionen av en grafisk runbook. Om runbooken ännu inte har publicerats inaktiveras knappen Exportera . När du klickar på knappen Exportera laddas runbooken ned till den lokala datorn. Namnet på filen matchar namnet på runbooken med ett .graphrunbook-tillägg .

Importera en grafisk runbook

Du kan importera en grafisk eller grafisk Runbook-fil för PowerShell-arbetsflöde genom att välja alternativet Importera när du lägger till en runbook. När du väljer den fil som ska importeras kan du behålla samma namn eller ange ett nytt. Fältet Runbook Type visar typen av runbook när den utvärderar den valda filen. Om du försöker välja en annan typ som inte är korrekt, visar den grafiska redigeraren ett meddelande som anger att det finns potentiella konflikter och att det kan finnas syntaxfel under konverteringen.

Import runbook

Testa en grafisk runbook

Varje grafisk runbook i Azure Automation har en utkastversion och en publicerad version. Du kan bara köra den publicerade versionen, medan du bara kan redigera utkastversionen. Den publicerade versionen påverkas inte av ändringar i utkastversionen. När utkastversionen är klar för användning publicerar du den, vilket skriver över den aktuella publicerade versionen med din utkastversion.

Du kan testa utkastversionen av en runbook i Azure-portalen och lämna den publicerade versionen oförändrad. Du kan också testa en ny runbook innan den har publicerats så att du kan kontrollera att runbooken fungerar korrekt innan någon version ersätts. Testning av en runbook kör utkastversionen och ser till att alla åtgärder som den utför slutförs. Ingen jobbhistorik skapas, men i fönstret Testutdata visas utdata.

Öppna testkontrollen för den grafiska runbooken genom att öppna runbooken för redigering och klicka sedan på testfönstret. Testkontrollen frågar efter indataparametrar och du kan starta runbooken genom att klicka på Start.

Publicera en grafisk runbook

Publicera en grafisk runbook genom att öppna runbooken för redigering och klicka sedan på Publicera. Möjliga statusar för runbooken är:

  • Ny – runbooken har inte publicerats ännu.
  • Publicerad – runbooken har publicerats.
  • Vid redigering har runbooken redigerats när den har publicerats och utkast- och publicerade versioner skiljer sig åt.

Runbook statuses

Du har möjlighet att återgå till den publicerade versionen av en runbook. Den här åtgärden genererar ändringar som gjorts sedan runbooken senast publicerades. Den ersätter utkastversionen av runbooken med den publicerade versionen.

Nästa steg