Creación de tareas de monitor de Azure Automation para realizar un seguimiento de los cambios de archivo en un equipo localCreate an Azure Automation watcher tasks to track file changes on a local machine

Azure Automation usa tareas de monitor para inspeccionar los eventos y desencadenar acciones con runbooks de PowerShell.Azure Automation uses watcher tasks to watch for events and trigger actions with PowerShell runbooks. Este tutorial lo guía en la creación de una tarea de monitor para supervisar cuándo se agrega un nuevo archivo a un directorio.This tutorial walks you through creating a watcher task to monitor when a new file is added to a directory.

En este tutorial, aprenderá a:In this tutorial, you learn how to:

  • Importar un runbook de monitorImport a watcher runbook
  • Creación de una variable de AutomationCreate an Automation variable
  • Crear un runbook de acciónCreate an action runbook
  • Crear una tarea de monitorCreate a watcher task
  • Desencadenar un monitorTrigger a watcher
  • Inspeccionar la salidaInspect the output

Requisitos previosPrerequisites

Los siguientes requisitos son necesarios para completar este tutorial:To complete this tutorial, the following are required:

Nota

No se admiten tareas de monitor en Azure China.Watcher tasks are not supported in Azure China.

Importar un runbook de monitorImport a watcher runbook

Este tutorial usa un runbook de monitor denominado Watch-NewFile para buscar nuevos archivos en un directorio.This tutorial uses a watcher runbook called Watch-NewFile to look for new files in a directory. El runbook de monitor recupera la última hora de escritura conocida en los archivos de una carpeta y examina los archivos más recientes que esa marca de agua.The watcher runbook retrieves the last known write time to the files in a folder and looks at any files newer than that watermark.

Este proceso de importación se puede realizar a través de la Galería de PowerShell.This import process can be done through the PowerShell Gallery.

  1. Vaya a la página de la galería para Watch-NewFile.ps1.Navigate to the gallery page for Watch-NewFile.ps1.
  2. En la pestaña Azure Automation, haga clic en Implementar en Azure Automation.Under the Azure Automation tab, click Deploy to Azure Automation.

También puede importar este runbook a su cuenta de Automation desde el portal mediante los pasos siguientes.You can also import this runbook into your automation account from the portal using the following steps.

  1. Abra la cuenta de Automation y haga clic en la página Runbooks.Open your Automation account, and click on the Runbooks page.
  2. Haga clic en el botón Examinar galería.Click on the Browse gallery button.
  3. Busque "Runbook de monitor", seleccione Watcher runbook that looks for new files in a directory (Runbook de monitor que busca archivos nuevos en un directorio) y seleccione Importar.Search for "Watcher runbook", select Watcher runbook that looks for new files in a directory and select Import. Importación de un runbook de Automation desde la interfaz de usuarioImport automation runbook from UI
  4. Asigne al runbook un nombre y una descripción y seleccione Aceptar para importar el runbook en su cuenta de Automation.Give the runbook a name and description and select OK to import the runbook into your Automation account.
  5. Seleccione Editar y luego haga clic en Publicar.Select Edit and then click Publish. Cuando se le pida, seleccione para publicar el runbook.When prompted select Yes to publish the runbook.

Creación de una variable de AutomationCreate an Automation variable

Se usa una variable de Automation para almacenar las marcas de tiempo que el runbook anterior lee y almacena de cada archivo.An automation variable is used to store the timestamps that the preceding runbook reads and stores from each file.

  1. Seleccione Variables en RECURSOS COMPARTIDOS y seleccione + Agregar una variable.Select Variables under SHARED RESOURCES and select + Add a variable.
  2. Escriba "Watch-NewFileTimestamp" para el nombre.Enter "Watch-NewFileTimestamp" for the name
  3. Seleccione DateTime para el tipo.Select DateTime for Type.
  4. Haga clic en el botón Crear.Click on the Create button. Se crea la variable de Automation.This creates the automation variable.

Crear un runbook de acciónCreate an action runbook

Un runbook de acción se usa en una tarea de monitor para actuar sobre los datos transferidos a él desde un runbook de monitor.An action runbook is used in a watcher task to act on the data passed to it from a watcher runbook. Los runbooks de flujo de trabajo de PowerShell no son compatibles con las tareas de monitor, debe usar runbooks de PowerShell.PowerShell Workflow runbooks are not supported by watcher tasks, you must use PowerShell runbooks. Debe importar un runbook de acción predefinido denominado Process-NewFile.You must import a pre-defined action runbook called Process-NewFile.

Este proceso de importación se puede realizar a través de la Galería de PowerShell.This import process can be done through the PowerShell Gallery.

  1. Vaya a la página de la galería para Process-NewFile.ps1.Navigate to the gallery page for Process-NewFile.ps1.
  2. En la pestaña Azure Automation, haga clic en Implementar en Azure Automation.Under the Azure Automation tab, click Deploy to Azure Automation.

También puede importar este runbook a su cuenta de Automation desde el portal mediante los pasos siguientes.You can also import this runbook into your automation account from the portal using the following steps.

  1. Vaya a la cuenta de Automation y seleccione Runbooks en la categoría AUTOMATIZACIÓN DE PROCESOS.Navigate to your automation account and select Runbooks under the PROCESS AUTOMATION category.
  2. Haga clic en el botón Examinar galería.Click on the Browse gallery button.
  3. Busque "Acción de monitor", seleccione Watcher action that processes events triggered by a watcher runbook (Acción de monitor que procesa eventos desencadenados por un runbook de monitor) y después seleccione Importar.Search for "Watcher action" and select Watcher action that processes events triggered by a watcher runbook and select Import. Importación de un runbook de acción desde la interfaz de usuarioImport action runbook from UI
  4. Asigne al runbook un nombre y una descripción y seleccione Aceptar para importar el runbook en su cuenta de Automation.Give the runbook a name and description and select OK to import the runbook into your Automation account.
  5. Seleccione Editar y luego haga clic en Publicar.Select Edit and then click Publish. Cuando se le pida, seleccione para publicar el runbook.When prompted select Yes to publish the runbook.

Crear una tarea de monitorCreate a watcher task

La tarea de monitor consta de dos partes.The watcher task contains two parts. El monitor y la acción.The watcher and the action. El monitor se ejecuta en un intervalo definido en la tarea de monitor.The watcher runs at an interval defined in the watcher task. Los datos del runbook de monitor se pasan al runbook de acción.Data from the watcher runbook is passed onto the action runbook. En este paso, va a configurar la tarea de monitor que hace referencia a los runbooks de monitor y acción definidos en los pasos anteriores.In this step, you configure the watcher task referencing the watcher and action runbooks defined in the preceding steps.

  1. Vaya a la cuenta de Automation y seleccione Tareas de monitor en la categoría AUTOMATIZACIÓN DE PROCESOS.Navigate to your automation account and select Watcher tasks under the PROCESS AUTOMATION category.

  2. Seleccione la página de tareas de monitor y haga clic en el botón + Agregar una tarea de monitor.Select the Watcher tasks page and click on + Add a watcher task button.

  3. Escriba "WatchMyFolder" en el nombre.Enter "WatchMyFolder" as the name.

  4. Seleccione Configurar monitor y seleccione el runbook Watch-NewFile.Select Configure watcher and select the Watch-NewFile runbook.

  5. Escriba los siguientes valores para los parámetros:Enter the following values for the parameters:

    • FOLDERPATH: carpeta de Hybrid Worker donde se crean archivos.FOLDERPATH - A folder on the hybrid worker where new files get created. d:\examplefilesd:\examplefiles
    • EXTENSION: deje este parámetro en blanco para procesar todas las extensiones de archivo.EXTENSION - Leave blank to process all file extensions.
    • RECURSE: deje este valor como el predeterminado.RECURSE - Leave this value as the default.
    • RUN SETTINGS: seleccione Hybrid Worker.RUN SETTINGS - Pick the hybrid worker.
  6. Haga clic en Aceptar y, después, seleccione esta opción para volver a la página de monitor.Click OK, and then Select to return to the watcher page.

  7. Seleccione Configurar acción y el runbook "Process-NewFile".Select Configure action and select "Process-NewFile" runbook.

  8. Escriba los siguientes valores para los parámetros:Enter the following values for parameters:

    • EVENTDATA: deje este valor en blanco.EVENTDATA - Leave blank. Los datos se pasan desde el runbook de monitor.Data is passed in from the watcher runbook.
    • Run Settings: déjelo como Azure porque este runbook se ejecuta en el servicio Automation.Run Settings - Leave as Azure as this runbook runs in the Automation service.
  9. Haga clic en Aceptar y, después, seleccione esta opción para volver a la página de monitor.Click OK, and then Select to return to the watcher page.

  10. Haga clic en Aceptar para crear la tarea de monitor.Click OK to create the watcher task.

Configurar acción de monitor desde la interfaz de usuario

Desencadenar un monitorTrigger a watcher

Para probar si el monitor función según lo previsto, debe crear un archivo de prueba.To test the watcher is working as expected, you need to create a test file.

Remoto en Hybrid Worker.Remote into the hybrid worker. Abra PowerShell y cree un archivo de prueba en la carpeta.Open PowerShell and create a test file in the folder.

New-Item -Name ExampleFile1.txt

En el siguiente ejemplo se muestra la salida esperada.The following example shows the expected output.

    Directory: D:\examplefiles


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

Inspeccionar la salidaInspect the output

  1. Vaya a la cuenta de Automation y seleccione Tareas de monitor en la categoría AUTOMATIZACIÓN DE PROCESOS.Navigate to your automation account and select Watcher tasks under the PROCESS AUTOMATION category.

  2. Seleccione la tarea de monitor "WatchMyFolder".Select the watcher task "WatchMyFolder".

  3. Haga clic en Ver secuencias de monitor en Secuencias para ver si el monitor encontró el archivo nuevo e inició el runbook de acción.Click on View watcher streams under Streams to see that the watcher found the new file and started the action runbook.

  4. Haga clic en Ver trabajos de acción de monitor para ver los trabajos del runbook de acción.To see the action runbook jobs, click on the View watcher action jobs. Cada trabajo puede seleccionarse en la vista de detalles del trabajo.Each job can be selected the view the details of the job.

    Trabajos de acción de monitor desde la interfaz de usuario

La salida esperada cuando se encuentra el archivo nuevo puede verse en el ejemplo siguiente: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}

Pasos siguientesNext steps

En este tutorial aprendió lo siguiente:In this tutorial, you learned how to:

  • Importar un runbook de monitorImport a watcher runbook
  • Creación de una variable de AutomationCreate an Automation variable
  • Crear un runbook de acciónCreate an action runbook
  • Crear una tarea de monitorCreate a watcher task
  • Desencadenar un monitorTrigger a watcher
  • Inspeccionar la salidaInspect the output

Siga este vínculo para más información sobre la creación de runbooks propios.Follow this link to learn more about authoring your own runbook.