Nachverfolgen aktualisierter Dateien mit einer Überwachungsaufgabe

Azure Automation verwendet eine Watcher-Aufgabe, um nach Ereignissen zu suchen und Aktionen mit PowerShell-Runbooks auszulösen. Die Überwachungsaufgabe besteht aus zwei Teilen: dem Überwacher und der Aktion. Ein Watcherrunbook wird in einem Intervall ausgeführt, das im Watchertask definiert ist, und gibt Daten in ein Aktionsrunbook aus.

Dieser Artikel führt Sie durch das Erstellen einer Überwachungsaufgabe zum Überwachen, wenn eine neue Datei zu einem Verzeichnis hinzugefügt wird. Hier erfahren Sie, wie Sie:

• Importiere ein Watcher Runbook
• Erstellen einer Automatisierungsvariable
• Erstellen eines Aktionsleitfadens
• Erstellen einer Überwachungsaufgabe
• Einen Watcher auslösen
• Prüfen Sie die Ausgabe

Voraussetzungen

Um diesen Artikel abzuschließen, sind die folgenden Schritte erforderlich:

• Azure-Abonnement. Wenn Sie noch keine haben, können Sie Ihre MSDN-Abonnentenvorteile aktivieren oder sich für ein kostenloses Konto registrieren.
• Automation-Konto, um die Watcher- und Aktionsrunbooks und den Watchertask aufzunehmen.
• Hybrid Runbook Worker, in dem der Watchertask ausgeführt wird.
• PowerShell-Runbooks. PowerShell-Workflow-Runbooks und grafische Runbooks werden nicht von Überwachungsaufgaben unterstützt.

Importiere ein Watcher Runbook

In diesem Artikel wird ein Watcher-Runbook namens Watcher runbook verwendet, das nach neuen Dateien in einem Verzeichnis sucht , um nach neuen Dateien in einem Verzeichnis zu suchen. Das Watcher-Runbook ruft die letzte bekannte Schreibzeit für die Dateien in einem Ordner ab und untersucht alle Dateien neuer als dieses Wasserzeichen.

Sie können dieses Runbook mithilfe der folgenden Schritte über das Portal in Ihr Automation-Konto importieren:

1. Melden Sie sich beim Azure-Portal an.
2. Suchen Sie nach Automatisierungskonten und wählen Sie diese aus.
3. Wählen Sie auf der Seite "Automatisierungskonten " den Namen Ihres Automatisierungskontos aus der Liste aus.
4. Wählen Sie im linken Bereich den Runbooks-Katalog unter "Prozessautomatisierung" aus.
5. Stellen Sie sicher, dass GitHub in der Dropdownliste " Quelle " ausgewählt ist.
6. Suchen Sie nach Watcher Runbook.
7. Wählen Sie das Watcher-Runbook aus, das nach neuen Dateien in einem Verzeichnis sucht, und wählen Sie auf der Detailseite "Importieren" aus.
8. Geben Sie dem Runbook einen Namen und optional eine Beschreibung, und klicken Sie auf "OK ", um das Runbook in Ihr Automatisierungskonto zu importieren. In einem Bereich oben rechts im Fenster sollte eine Meldung " Import erfolgreich" angezeigt werden.
9. Das importierte Runbook wird in der Liste unter dem Namen angezeigt, den Sie angegeben haben, wenn Sie Runbooks im linken Bereich auswählen.
10. Klicken Sie auf das Runbook, und wählen Sie auf der Runbook-Detailseite "Bearbeiten" aus, und klicken Sie dann auf "Veröffentlichen". Wenn Sie dazu aufgefordert werden, klicken Sie auf "Ja ", um das Runbook zu veröffentlichen.

Sie können das Runbook auch aus der Azure Automation GitHub-Organisation herunterladen.

1. Navigieren Sie zur Azure Automation GitHub-Organisationsseite für Watch-NewFile.ps1.
2. Um das Runbook von GitHub herunterzuladen, wählen Sie "Code " auf der rechten Seite der Seite aus, und wählen Sie dann "ZIP herunterladen" aus, um den gesamten Code in einer ZIP-Datei herunterzuladen.
3. Extrahieren Sie den Inhalt, und importieren Sie das Runbook.

Erstellen einer Automatisierungsvariable

Eine Automatisierungsvariable wird verwendet, um die Zeitstempel zu speichern, die das vorherige Runbook aus jeder Datei liest und speichert.

1. Wählen Sie "Variablen " unter "Freigegebene Ressourcen " aus, und klicken Sie auf +Variable hinzufügen.

2. Geben Sie Watch-NewFileTimestamp für den Namen ein.

3. Wählen Sie "DateTime" für den Typ aus. Standardmäßig wird er auf das aktuelle Datum und die aktuelle Uhrzeit festgelegt.

   

4. Klicken Sie auf "Erstellen ", um die Automatisierungsvariable zu erstellen.

Erstellen eines Aktionsleitfadens

Ein Aktionsrunbook wird in einem Watchertask verwendet, um Aktionen für die von einem Watcherrunbook übergebenen Daten auszuführen. Sie müssen ein vordefiniertes Aktions-Runbook importieren, entweder aus dem Azure-Portal oder von der Azure Automation GitHub-Organisation.

Sie können dieses Runbook aus dem Azure-Portal in Ihr Automatisierungskonto importieren:

1. Melden Sie sich beim Azure-Portal an.
2. Suchen Sie nach Automatisierungskonten und wählen Sie diese aus.
3. Wählen Sie auf der Seite "Automatisierungskonten " den Namen Ihres Automatisierungskontos aus der Liste aus.
4. Wählen Sie im linken Bereich den Runbooks-Katalog unter "Prozessautomatisierung" aus.
5. Stellen Sie sicher, dass GitHub in der Dropdownliste " Quelle " ausgewählt ist.
6. Suchen Sie nach Watcher-Aktion, wählen Sie "Watcher"-Aktion aus, die Ereignisse verarbeitet, die von einem Watcher-Runbook ausgelöst werden, und klicken Sie auf "Importieren".
7. Ändern Sie optional den Namen des Runbook auf der Importseite, und klicken Sie dann auf 'OK ', um das Runbook zu importieren. Im Infobereich sollte oben rechts im Browser eine Meldung " Import erfolgreich" angezeigt werden.
8. Wechseln Sie zur Seite "Automatisierungskonto", und klicken Sie links auf "Runbooks ". Ihr neues Runbook sollte unter dem Namen aufgeführt werden, den Sie ihm im vorherigen Schritt gegeben haben. Klicken Sie auf das Runbook, und wählen Sie auf der Runbook-Detailseite "Bearbeiten" aus, und klicken Sie dann auf "Veröffentlichen". Wenn Sie dazu aufgefordert werden, klicken Sie auf "Ja ", um das Runbook zu veröffentlichen.

So erstellen Sie ein Aktionsrunbook, indem Sie es aus der Azure Automation GitHub-Organisation herunterladen:

1. Navigieren Sie zur Azure Automation GitHub-Organisationsseite für Process-NewFile.ps1.
2. Um das Runbook von GitHub herunterzuladen, wählen Sie "Code " auf der rechten Seite der Seite aus, und wählen Sie dann "ZIP herunterladen" aus, um den gesamten Code in einer ZIP-Datei herunterzuladen.
3. Extrahieren Sie den Inhalt, und importieren Sie das Runbook.

Erstellen einer Überwachungsaufgabe

In diesem Schritt konfigurieren Sie die Überwachungsaufgabe, die auf die in den vorherigen Abschnitten definierten Überwachungs- und Aktions-Runbooks verweist.

1. Navigieren Sie zu Ihrem Automatisierungskonto, und wählen Sie "Überwachungsaufgaben" unter "Prozessautomatisierung" aus.

2. Wählen Sie die Seite "Überwachungsaufgaben" aus und klicken Sie auf + Überwachungsaufgabe hinzufügen.

3. Geben Sie WatchMyFolder als Namen ein.

4. Wählen Sie Watcher konfigurieren und dann das Runbook Watch-NewFile aus.

5. Geben Sie die folgenden Werte für die Parameter ein:

   • FOLDERPATH – Ein Ordner im Hybrid Runbook Worker, in dem neue Dateien erstellt werden, z. B. d:\examplefiles.
   • EXTENSION – Erweiterung für die Konfiguration. Lassen Sie es leer, um alle Dateierweiterungen zu verarbeiten.
   • RECURSE - Rekursive Operation. Lassen Sie diesen Wert als Standard.
   • RUN SETTINGS - Einstellungen zum Ausführen des Runbooks. Wählen Sie den Hybrid-Mitarbeiter aus.

6. Klicken Sie auf "OK", und wählen Sie dann "Auswählen ", um zur Watcher-Seite zurückzukehren.

7. Wählen Sie "Aktion konfigurieren" und dann das Runbook "Process-NewFile " aus.

8. Geben Sie die folgenden Werte für die Parameter ein:

   • EVENTDATA – Ereignisdaten. Lassen Sie dieses Feld leer. Die Daten werden vom Watcherrunbook übergeben.
   • Run Settings - Einstellung zum Ausführen des Runbooks. Übernehmen Sie hier „Azure“, da dieses Runbook in Azure Automation ausgeführt wird.

9. Klicken Sie auf "OK", und wählen Sie dann "Auswählen ", um zur Watcher-Seite zurückzukehren.

10. Klicken Sie auf "OK ", um die Überwachungsaufgabe zu erstellen.

    

Einen Watcher auslösen

Sie müssen einen Test ausführen, wie unten beschrieben, um sicherzustellen, dass die Watcher-Aufgabe erwartungsgemäß funktioniert.

1. Stellen Sie eine Remoteverbindung mit dem Hybrid Runbook Worker her.
2. Öffnen Sie PowerShell , und erstellen Sie eine Testdatei im Ordner.

New-Item -Name ExampleFile1.txt

Das folgende Beispiel zeigt die erwartete Ausgabe.

    Directory: D:\examplefiles


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

Prüfen Sie die Ausgabe

1. Navigieren Sie zu Ihrem Automatisierungskonto, und wählen Sie "Überwachungsaufgaben" unter "Prozessautomatisierung" aus.

2. Wählen Sie die Überwachungsaufgabe WatchMyFolder aus.

3. Klicken Sie auf "Watcher-Streams anzeigen " unter "Streams ", um zu sehen, dass der Watcher die neue Datei gefunden und das Aktions-Runbook gestartet hat.

4. Klicken Sie auf Watcheraktionsaufträge anzeigen, um den Aktionsrunbookauftrag anzuzeigen. Jeder Auftrag kann ausgewählt werden, um die Details des Auftrags anzuzeigen.

   

Die erwartete Ausgabe, wenn die neue Datei gefunden wird, finden Sie im folgenden Beispiel:

Message is Process new file...

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

Nächste Schritte

Weitere Informationen zum Erstellen Ihres eigenen Runbook finden Sie unter Erstellen eines PowerShell-Runbook.