Spåra uppdaterade filer med en övervakningsuppgift

Azure Automation använder en bevakaruppgift för att leta efter händelser och utlösa åtgärder med PowerShell-runbooks. Watcher-uppgiften innehåller två delar, bevakaren och åtgärden. En watcher-runbook körs med ett intervall som definierats i watcher-aktiviteten och matar ut data till en åtgärdsrunbook.

Den här artikeln beskriver hur du skapar en bevakaruppgift att övervaka när en ny fil läggs till i en katalog. Du lär dig att:

• Importera en watcher-runbook
• Skapa en Automation-variabel
• Skapa en åtgärdsplan-rutinbok
• Skapa en watcher-uppgift
• Utlösa en övervakare
• Granska utdata

Förutsättningar

För att slutföra den här artikeln krävs följande:

• Azure-prenumeration. Om du inte har något ännu kan du aktivera dina MSDN-prenumerantförmåner eller registrera dig för ett kostnadsfritt konto.
• Automation-konto för att lagra watcher- och action-runbooks och Watcher-uppgiften.
• En hybrid runbook worker där watcher-uppgiften körs.
• PowerShell-runbooks. PowerShell-arbetsflödesrunbooks och grafiska runbooks stöds inte av bevakaruppgifter.

Importera en watcher-runbook

Den här artikeln använder en watcher-runbook med namnet Watcher runbook som söker efter nya filer i en katalog för att leta efter nya filer i en katalog. Watcher-runbook hämtar den senaste kända skrivtiden för filerna i en mapp och letar efter filer som är nyare än den tidstämpeln.

Du kan importera den här runbooken till ditt Automation-konto från portalen med hjälp av följande steg.

1. Logga in på Azure-portalen.
2. Sök efter och välj Automation-konton.
3. På sidan Automation-konton väljer du namnet på ditt Automation-konto i listan.
4. I den vänstra rutan väljer du Runbooks-galleriet under ProcessAutomatisering.
5. Kontrollera att GitHub är markerat i listrutan Källa .
6. Sök efter Watcher runbook.
7. Välj Watcher-runbook som söker efter nya filer i en katalog och välj Importera på informationssidan.
8. Ge runbooken ett namn och eventuellt en beskrivning och klicka på OK för att importera runbooken till ditt Automation-konto. Du bör se ett meddelande om att importen lyckades i ett fönster längst upp till höger i fönstret.
9. Den importerade körboken visas i listan under namnet du gav den när du väljer Körböcker i den vänstra rutan.
10. Klicka på runbooken och välj Redigera på sidan Runbook-information och klicka sedan på Publicera. När du uppmanas till det klickar du på Ja för att publicera runbooken.

Du kan också ladda ned runbooken från Azure Automation GitHub-organisationen.

1. Gå till Azure Automation GitHub-organisationssidan för Watch-NewFile.ps1.
2. Om du vill ladda ned runbooken från GitHub väljer du Kod till höger på sidan och väljer sedan Ladda ned ZIP för att ladda ned hela koden i en zip-fil.
3. Extrahera innehållet och importera runbooken.

Skapa en Automation-variabel

En automationsvariabel används för att lagra de tidsstämplar som den föregående runboken läser och lagrar från varje fil.

1. Välj Variabler under Delade resurser och klicka på + Lägg till en variabel.

2. Ange Watch-NewFileTimestamp som namn.

3. Välj DateTime som typ. Det kommer att ställas in som standard till det aktuella datumet och tiden.

   

4. Klicka på Skapa för att skapa Automation-variabeln.

Skapa en åtgärdsplan-rutinbok

En åtgärds-runbook används i en övervakningsuppgift för att bearbeta data som skickas till den från en watcher-runbook. Du måste importera en fördefinierad åtgärdsrunbook, antingen från Azure-portalen eller från Azure Automation GitHub-organisationen.

Du kan importera den här runbooken till ditt konto för Automation via Azure-portalen:

1. Logga in på Azure-portalen.
2. Sök efter och välj Automation-konton.
3. På sidan Automation-konton väljer du namnet på ditt Automation-konto i listan.
4. I den vänstra rutan väljer du Runbooks-galleriet under ProcessAutomatisering.
5. Kontrollera att GitHub är markerat i listrutan Källa .
6. Sök efter Watcher-åtgärd, välj Watcher-åtgärd som bearbetar händelser som utlöses av en watcher-runbook och klicka på Importera.
7. Du kan också ändra namnet på runbooken på importsidan och sedan klicka på OK för att importera runbooken. Du bör se ett meddelande om att importen lyckades i meddelandefönstret längst upp till höger i webbläsaren.
8. Gå till sidan Automation-konto och klicka på Runbooks till vänster. Din nya runbook bör visas under det namn som du gav den i föregående steg. Klicka på runbooken och välj Redigera på sidan Runbook-information och klicka sedan på Publicera. När du uppmanas till det klickar du på Ja för att publicera runbooken.

Så här skapar du en åtgärdsrunbook genom att ladda ned den från Azure Automation GitHub-organisationen:

1. Gå till Azure Automation GitHub-organisationssidan för Process-NewFile.ps1.
2. Om du vill ladda ned runbooken från GitHub väljer du Kod till höger på sidan och väljer sedan Ladda ned ZIP för att ladda ned hela koden i en zip-fil.
3. Extrahera innehållet och importera runbooken.

Skapa en watcher-uppgift

I det här steget konfigurerar du watcher-uppgiften som refererar till watcher- och action-runbooks som definierats i föregående avsnitt.

1. Gå till ditt Automation-konto och välj Watcher-uppgifter under ProcessAutomatisering.

2. Välj sidan Watcher-uppgifter och klicka på + Lägg till en Watcher-uppgift.

3. Ange WatchMyFolder som namn.

4. Välj Konfigurera bevakare och välj sedan runbooken Watch-NewFile.

5. Ange följande värden för parametrarna:

   • FOLDERPATH – en mapp i Hybrid Runbook Worker där nya filer skapas, till exempel d:\examplefiles.
   • EXTENSION – Tillägg för konfigurationen. Lämna tomt för att bearbeta alla filändelser.
   • RECURSE – rekursiv åtgärd. Lämna det här värdet som standard.
   • KÖR INSTÄLLNINGAR – Inställning för att köra runbooken. Välj hybridarbetaren.

6. Klicka på OK och sedan på Välj för att återgå till sidan Bevakare.

7. Välj Konfigurera åtgärd och välj Runbooken Process-NewFile .

8. Ange följande värden för parametrarna:

   • EVENTDATA – Händelsedata. Lämna tomt. Data skickas från watcher-runbooken.
   • Körinställningar: Inställning för att köra runboken. Lämna som Azure eftersom den här runbooken körs i Azure Automation.

9. Klicka på OK och sedan på Välj för att återgå till sidan Bevakare.

10. Klicka på OK för att skapa watcher-uppgiften.

    

Utlösa en övervakare

Du måste köra ett test enligt beskrivningen nedan för att se till att watcher-uppgiften fungerar som förväntat.

1. Fjärranslut till Hybrid Runbook Worker.
2. Öppna PowerShell och skapa en testfil i mappen.

New-Item -Name ExampleFile1.txt

I följande exempel visas förväntade utdata.

    Directory: D:\examplefiles


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       12/11/2017   9:05 PM              0 ExampleFile1.txt

Granska utdata

1. Gå till ditt Automation-konto och välj Watcher-uppgifter under ProcessAutomatisering.

2. Välj watcher-uppgiften WatchMyFolder.

3. Klicka på Visa övervakningsströmmar under Strömmar för att se att övervakaren har hittat den nya filen och startat åtgärdsrunboken.

4. Om du vill se åtgärdsjobben i runbooken klickar du på Visa jobb för bevakarens åtgärder. Varje jobb kan väljas för att visa information om jobbet.

   

Förväntade utdata när den nya filen hittas visas i följande exempel:

Message is Process new file...

Passed in data is @{FileName=D:\examplefiles\ExampleFile1.txt; Length=0}

Nästa steg

Mer information om hur du redigerar en egen runbook finns i Skapa en PowerShell-runbook.