Skapa en Azure Automation bevakare-aktiviteter för att spåra fil ändringar på en lokal datorCreate an Azure Automation watcher tasks to track file changes on a local machine

Azure Automation använder övervaknings uppgifter för att övervaka händelser och utlösa åtgärder med PowerShell-Runbooks.Azure Automation uses watcher tasks to watch for events and trigger actions with PowerShell runbooks. Den här självstudien vägleder dig genom att skapa en bevakare-uppgift som ska övervakas när en ny fil läggs till i en katalog.This tutorial walks you through creating a watcher task to monitor when a new file is added to a directory.

I den här guiden får du lära dig att:In this tutorial, you learn how to:

  • Importera en övervakare RunbookImport a watcher runbook
  • Skapa en Automation-variabelCreate an Automation variable
  • Skapa en åtgärds-RunbookCreate an action runbook
  • Skapa en bevakare-uppgiftCreate a watcher task
  • Utlös en övervakareTrigger a watcher
  • Granska utdataInspect the output

FörutsättningarPrerequisites

Följande krävs för att genomföra kursen:To complete this tutorial, the following are required:

Anteckning

Övervaknings uppgifter stöds inte i Azure Kina.Watcher tasks are not supported in Azure China.

Importera en övervakare RunbookImport a watcher runbook

I den här självstudien används en bevakad Runbook som kallas Watch-NewFile för att leta efter nya filer i en katalog.This tutorial uses a watcher runbook called Watch-NewFile to look for new files in a directory. Övervakarens Runbook hämtar den senast kända Skriv tiden till filerna i en mapp och tittar på filer som är nyare än den vattenstämpeln.The watcher runbook retrieves the last known write time to the files in a folder and looks at any files newer than that watermark.

Den här import processen kan göras via PowerShell-galleriet.This import process can be done through the PowerShell Gallery.

  1. Gå till Galleri sidan för Watch-NewFile. ps1.Navigate to the gallery page for Watch-NewFile.ps1.
  2. Klicka på distribuera i Azure Automationpå fliken Azure Automation .Under the Azure Automation tab, click Deploy to Azure Automation.

Du kan också importera denna Runbook till ditt Automation-konto från portalen med hjälp av följande steg.You can also import this runbook into your automation account from the portal using the following steps.

  1. Öppna ditt Automation-konto och klicka på sidan Runbooks .Open your Automation account, and click on the Runbooks page.
  2. Klicka på knappen Bläddra i galleriet.Click on the Browse gallery button.
  3. Sök efter "övervakare Runbook", Välj övervakare Runbook som söker efter nya filer i en katalog och välj Importera.Search for "Watcher runbook", select Watcher runbook that looks for new files in a directory and select Import. Importera Automation-Runbook från UIImport automation runbook from UI
  4. Ge runbooken ett namn och en beskrivning och välj OK för att importera runbooken till ditt Automation-konto.Give the runbook a name and description and select OK to import the runbook into your Automation account.
  5. Välj Redigera och klicka sedan på publicera.Select Edit and then click Publish. När du tillfrågas väljer du Ja för att publicera runbooken.When prompted select Yes to publish the runbook.

Skapa en Automation-variabelCreate an Automation variable

En Automation-variabel används för att lagra tidsstämplar som föregående Runbook läser och lagrar från varje fil.An automation variable is used to store the timestamps that the preceding runbook reads and stores from each file.

  1. Välj variabler under delade resurser och välj + Lägg till en variabel.Select Variables under SHARED RESOURCES and select + Add a variable.
  2. Ange "Watch-NewFileTimestamp" som namnEnter "Watch-NewFileTimestamp" for the name
  3. Välj DateTime som typ.Select DateTime for Type.
  4. Klicka på knappen skapa .Click on the Create button. Detta skapar Automation-variabeln.This creates the automation variable.

Skapa en åtgärds-RunbookCreate an action runbook

En åtgärds-Runbook används i en bevakare-uppgift för att agera på de data som skickas till den från en bevakad Runbook.An action runbook is used in a watcher task to act on the data passed to it from a watcher runbook. PowerShell Workflow-Runbooks stöds inte av bevakade uppgifter. du måste använda PowerShell-Runbooks.PowerShell Workflow runbooks are not supported by watcher tasks, you must use PowerShell runbooks. Du måste importera en fördefinierad åtgärd Runbook som kallas process-NewFile.You must import a pre-defined action runbook called Process-NewFile.

Den här import processen kan göras via PowerShell-galleriet.This import process can be done through the PowerShell Gallery.

  1. Gå till Galleri sidan för process-NewFile. ps1.Navigate to the gallery page for Process-NewFile.ps1.
  2. Klicka på distribuera i Azure Automationpå fliken Azure Automation .Under the Azure Automation tab, click Deploy to Azure Automation.

Du kan också importera denna Runbook till ditt Automation-konto från portalen med hjälp av följande steg.You can also import this runbook into your automation account from the portal using the following steps.

  1. Navigera till ditt Automation-konto och välj Runbooks under kategorin process automatisering .Navigate to your automation account and select Runbooks under the PROCESS AUTOMATION category.
  2. Klicka på knappen Bläddra i galleriet.Click on the Browse gallery button.
  3. Sök efter "övervaknings åtgärd" och välj bevakare åtgärd som bearbetar händelser som utlöses av en bevakad Runbook och välj Importera.Search for "Watcher action" and select Watcher action that processes events triggered by a watcher runbook and select Import. Importera åtgärds-Runbook från UIImport action runbook from UI
  4. Ge runbooken ett namn och en beskrivning och välj OK för att importera runbooken till ditt Automation-konto.Give the runbook a name and description and select OK to import the runbook into your Automation account.
  5. Välj Redigera och klicka sedan på publicera.Select Edit and then click Publish. När du tillfrågas väljer du Ja för att publicera runbooken.When prompted select Yes to publish the runbook.

Skapa en bevakare-uppgiftCreate a watcher task

Övervaknings aktiviteten innehåller två delar.The watcher task contains two parts. Övervakare och åtgärd.The watcher and the action. Bevakaren körs med ett intervall som definierats i övervaknings aktiviteten.The watcher runs at an interval defined in the watcher task. Data från övervaknings-runbooken skickas till Runbook-åtgärden.Data from the watcher runbook is passed onto the action runbook. I det här steget konfigurerar du aktiviteten Övervakare som refererar till övervakare och åtgärds-Runbooks som definierats i föregående steg.In this step, you configure the watcher task referencing the watcher and action runbooks defined in the preceding steps.

  1. Navigera till ditt Automation-konto och välj övervaknings uppgifter under kategorin process automatisering .Navigate to your automation account and select Watcher tasks under the PROCESS AUTOMATION category.

  2. Välj sidan övervakare och klicka på + Lägg till en bevakare-aktivitets knapp.Select the Watcher tasks page and click on + Add a watcher task button.

  3. Ange "WatchMyFolder" som namn.Enter "WatchMyFolder" as the name.

  4. Välj Konfigurera övervakare och välj NewFile- runbooken.Select Configure watcher and select the Watch-NewFile runbook.

  5. Ange följande värden för parametrarna:Enter the following values for the parameters:

    • FOLDERPATH – en mapp på Hybrid Worker där nya filer skapas.FOLDERPATH - A folder on the hybrid worker where new files get created. d:\examplefilesd:\examplefiles
    • Tillägg – lämna tomt om du vill bearbeta alla fil namns tillägg.EXTENSION - Leave blank to process all file extensions.
    • Rekursivt – lämna det här värdet som standard.RECURSE - Leave this value as the default.
    • Kör inställningar – Välj hybrid Worker.RUN SETTINGS - Pick the hybrid worker.
  6. Klicka på OK och välj sedan för att återgå till sidan övervakare.Click OK, and then Select to return to the watcher page.

  7. Välj Konfigurera åtgärd och välj "bearbeta-NewFile"-Runbook.Select Configure action and select "Process-NewFile" runbook.

  8. Ange följande värden för parametrar:Enter the following values for parameters:

    • EVENTDATA – lämna tomt.EVENTDATA - Leave blank. Data skickas från övervaknings-runbooken.Data is passed in from the watcher runbook.
    • Kör inställningar -lämna som Azure eftersom denna Runbook körs i Automation-tjänsten.Run Settings - Leave as Azure as this runbook runs in the Automation service.
  9. Klicka på OKoch välj sedan för att återgå till sidan övervakare.Click OK, and then Select to return to the watcher page.

  10. Klicka på OK för att skapa bevakare-aktiviteten.Click OK to create the watcher task.

Konfigurera övervaknings åtgärd från användar gränssnittet

Utlös en övervakareTrigger a watcher

För att testa bevakaren fungerar som förväntat måste du skapa en test fil.To test the watcher is working as expected, you need to create a test file.

Fjärran slut till hybrid Worker.Remote into the hybrid worker. Öppna PowerShell och skapa en test fil i mappen.Open PowerShell and create a test file in the folder.

New-Item -Name ExampleFile1.txt

I följande exempel visas förväntade utdata.The following example shows the expected output.

    Directory: D:\examplefiles


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

Granska utdataInspect the output

  1. Navigera till ditt Automation-konto och välj övervaknings uppgifter under kategorin process automatisering .Navigate to your automation account and select Watcher tasks under the PROCESS AUTOMATION category.

  2. Välj bevakad uppgift "WatchMyFolder".Select the watcher task "WatchMyFolder".

  3. Klicka på Visa övervakare strömmar under strömmar för att se att bevakaren hittade den nya filen och startade åtgärden Runbook.Click on View watcher streams under Streams to see that the watcher found the new file and started the action runbook.

  4. Klicka på Åtgärds jobben Visa övervakareför att se Runbook-jobb.To see the action runbook jobs, click on the View watcher action jobs. Varje jobb kan väljas Visa information om jobbet.Each job can be selected the view the details of the job.

    Övervaknings åtgärds jobb från användar gränssnittet

Förväntade utdata när den nya filen hittas kan visas i följande exempel:The expected output when the new file is found can be seen in the following example:

Message is Process new file...



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

Nästa stegNext steps

I den här självstudiekursen lärde du dig att:In this tutorial, you learned how to:

  • Importera en övervakare RunbookImport a watcher runbook
  • Skapa en Automation-variabelCreate an Automation variable
  • Skapa en åtgärds-RunbookCreate an action runbook
  • Skapa en bevakare-uppgiftCreate a watcher task
  • Utlös en övervakareTrigger a watcher
  • Granska utdataInspect the output

Följ den här länken om du vill veta mer om hur du redigerar din egen Runbook.Follow this link to learn more about authoring your own runbook.