Beispiel-Runbook: Überwachen eines Ordners mit einem Runbook
In diesem Artikel erfahren Sie, wie Sie ein einfaches Runbook erstellen, das einen Ordner für neue Textdateien überwacht. Wenn eine Datei erkannt wird, sendet das Runbook eine Ereignisprotokollmeldung und startet dann ein weiteres Runbook.
Erstellen und Testen eines Überwachungs-Runbook
Die Verfahren zum Erstellen, Konfigurieren und Testen eines einfachen Runbook, das einen Ordner überwacht, werden unten beschrieben.
Erstellen des Workflows
Gehen Sie zum Erstellen eines Workflows wie folgt vor:
Klicken Sie im Runbook Designer-Bereich „Verbindungen“ mit der rechten Maustaste auf den Ordner „Runbooks“, um „Neu“ auszuwählen, und wählen Sie dann „Runbook“ aus.
Klicken Sie mit der rechten Maustaste auf die Registerkarte „Neues Runbook“, um dann „Umbenennen“ auszuwählen.
Wählen Sie im Dialogfeld „Check-out bestätigen“ die Option „Ja“ aus.
Geben Sie einen Namen für das Runbook ein, z. B. „Überwachungs-Runbook“, und drücken Sie dann die Eingabetaste.
Wählen Sie im Bereich „Aktivitäten“ die Option „Dateiverwaltung“ aus, um die Kategorie zu erweitern, und ziehen Sie dann die Aktivität „Ordner überwachen“ in den Designarbeitsbereich „Runbook Designer“.
Wählen Sie im Bereich Aktivitäten die Option Benachrichtigung aus, um die Kategorie zu erweitern, und ziehen Sie dann die Aktivität Ereignisprotokollmeldung senden in den Designarbeitsbereich Runbook Designer rechts neben die Aktivität „Monitor Folder.
Führen Sie im Runbook Designer-Designarbeitsbereich den Mauszeiger über die rechte Seite der Aktivität „Ordner überwachen“, um den Smart Link-Pfeil anzuzeigen.
Wählen Sie den Smart Link-Pfeil aus und ziehen Sie ihn dann auf die Aktivität Send Event Log Message.
Wählen Sie im Bereich Aktivitäten die Option Runbook-Steuerelement aus, um die Kategorie zu erweitern, und ziehen Sie dann die Aktivität „Invoke Runbook in den Designarbeitsbereich von Runbook Designer rechts neben die Aktivität „Send Event Log Message.
Führen Sie im Designarbeitsbereich von Runbook Designer den Mauszeiger über die rechte Seite der Aktivität Send Event Log Message, um den Smart Link-Pfeil anzuzeigen.
Wählen Sie den Smartlink-Pfeil aus und ziehen Sie ihn dann auf die Aktivität „Runbook aufrufen“.
Workflows konfigurieren
Folgen Sie diesen Schritten, um den Workflow zu konfigurieren:
Doppelklicken Sie im Runbook Designer-Designarbeitsbereich auf die Aktivität „Ordner überwachen“.
Wählen Sie im Dialogfeld „Ordnereigenschaften überwachen“ die Registerkarte „Allgemein“ aus.
Ändern Sie im Feld „Name“ den Namen der Aktivität in einen aussagekräftigen Namen. Beispiel: Monitor C:\Monitor Folder.
Wählen Sie die Registerkarte Details aus.
Geben Sie auf der Registerkarte „Details“ im Feld „Pfad“ den Pfad des Ordners ein, den Sie überwachen möchten. Beispiel: C:\Monitor.
Wählen Sie unter der Liste „Dateifilter“ die Option „Hinzufügen“ aus.
Nehmen Sie im Dialogfeld „Filtereinstellungen“ folgende Einstellungen vor:
Wählen Sie im Listenfeld „Name“ die Option „Dateiname“ aus.
Wählen Sie im Listenfeld „Beziehung“ die Option „Entspricht dem Muster“ aus.
Geben Sie im Feld „Wert“ „*.txt“ ein.
Diese Einstellung weist den Monitor an, nach Dateien mit der Dateiendung „txt“ zu suchen. Dieses Feld akzeptiert die Syntax regulärer Ausdrücke.
Wählen Sie OK aus.
Wählen Sie die Registerkarte Trigger aus.
Wählen Sie die Option „Anzahl der Dateien ist“ aus, setzen Sie den Wert in der Liste auf „größer als“ und geben Sie dann „0“ in das Bearbeitungsfeld ein.
Wählen Sie Fertig stellen aus.
Doppelklicken Sie im Runbook Designer-Designarbeitsbereich auf „Ereignisprotokollmeldung senden“.
Im Dialogfeld „Eigenschaften der Ereignisprotokollmeldung senden“ auf der Registerkarte „Details“ im Abschnitt „Eigenschaften“ legen Sie Folgendes fest:
Geben Sie im Feld „Computer“ den Namen des Computers ein, der die Ereignismeldung erhalten soll.
Dies ist in der Regel der Computer, auf dem Sie Runbook Designer ausführen.
Geben Sie in das Feld „Nachricht“ die Nachricht ein, die im Ereignisprotokoll angezeigt werden soll. Beispiel: „Datei erkannt“.
Belassen Sie die „Schweregrad“-Ebene auf „Information“.
Klicken Sie auf Fertigstellen.
Hinweis
In dieser Stichprobe ist die Aktivität „Runbook aufrufen“ nicht konfiguriert.
Ändern von Runbookeinstellungen
Zum Ändern der Runbookeinstellungen führen Sie folgende Schritte aus:
Klicken Sie mit der rechten Maustaste auf die Registerkarte „Runbook überwachen“ über dem Runbook Designer-Designarbeitsbereich, um „Eigenschaften“ auszuwählen.
Wählen Sie im Dialogfeld „Runbookeigenschaften überwachen“ die Registerkarte „Protokollierung“ und dann sowohl „Aktivitätsspezifische zurückgegebene Daten speichern“ als auch „Gemeinsame zurückgegebene Daten speichern“ aus.
Wählen Sie Fertig stellen aus.
Klicken Sie mit der rechten Maustaste auf die Registerkarte „Runbook überwachen“, um „Einchecken“ auszuwählen.
Testen des Runbooks
Mit dem Runbook Tester können Sie Runbooks in einer simulierten Laufzeit- und Debugging-Umgebung testen. Sie können ein vollständiges Runbook ausführen, es Schritt für Schritt durchgehen oder Haltepunkte hinzufügen, um die Simulation bei jeder beliebigen Aktivität anzuhalten.
Führen Sie die folgenden Schritte aus, um Ihr Runbook im Runbook Tester zu testen.
Vorbereiten Ihres Computers
Führen Sie die folgenden Schritte aus, um Ihren Computer vorzubereiten:
Klicken Sie mit der rechten Maustaste auf „Start“, um „Windows Explorer öffnen“ auszuwählen.
Erstellen Sie auf Ihrem Computer den folgenden Ordner: „C:\Monitor“.
Erstellen Sie den folgenden Ordner auf Ihrem Computer: „C:\Source“.
Erstellen Sie im Ordner „C:\Source“ eine Datei mit der Dateiendung „txt“. Beispiel: „text.txt“.
Testen des Runbooks
Gehen Sie folgendermaßen vor, um das Runbook zu testen:
Wählen Sie im Runbook Designer-Designarbeitsbereich die Registerkarte „Runbook überwachen“ aus.
Wählen Sie in der Symbolleiste über dem Runbook Designer-Designarbeitsbereich die Option „Runbook Tester“ aus.
Wählen Sie im Dialogfeld „Check-out bestätigen“ die Option „Ja“ aus.
Wählen Sie in Runbook Tester in der Symbolleiste „Schritt über“ aus, um das Runbook schrittweise durchzugehen.
Tipp
Um den Bereich „Protokoll“ zu vergrößern, entfernen Sie den Bereich „Ressourcen-Browser“, indem Sie im Menü „Ansicht“ auswählen und dann die Option „Ressourcen-Browser“ deaktivieren.
Navigieren Sie im Windows-Explorer zum Ordner „C:\Source“.
Kopieren Sie „test.txt“ in „C:\Monitor“.
Schließen Sie Windows-Explorer.
Wählen Sie in der Symbolleiste des Runbook-Testers die Option „Weiter“ aus.
Nach einigen Augenblicken wird der Eintrag im Bereich „Protokoll“ aktualisiert und zeigt ein Ereignis für die Aktivität „Ordner überwachen“ an.
Wählen Sie im Bereich „Protokoll“ die Verknüpfung „Details anzeigen“ aus, um den Inhalt des Datenbusses für dieses Runbook anzuzeigen.
Scrollen Sie in der Liste der Eigenschaften nach unten. Wenn der Aktivitätsstatus „Erfolgreich“ lautet, bedeutet dies, dass die Aktivität „Ordner überwachen“ die Änderung im Ordner erkannt hat.
Wählen Sie in der Symbolleiste des Runbook-Testers die Option „Weiter“ aus.
Beachten Sie, dass sich der Bereich „Protokoll“ ändert und ein Ereignis für die Aktivität „Ereignisprotokollmeldung senden“ anzeigt.
Wählen Sie die Verknüpfung „Details anzeigen“ aus. Wenn der Aktivitätsstatus „Erfolgreich“ lautet, bedeutet dies, dass die Aktivität „Ereignisprotokollmeldung senden“ die Änderung im Ordner erkannt hat.
Schließen Sie Runbook Tester.
Wählen Sie in der Symbolleiste des Runbook Designer die Option „Einchecken“ aus.
Nächste Schritte
- Lesen Sie „Runbooks designen und erstellen“, um mehr über die Erstellung von Runbooks zu erfahren und bewährte Methoden für das Design von Runbooks zu erhalten.
- Lesen Sie „Runbookaktivitäten steuern“, um mehr über die Optionen zur Steuerung der Runbook-Ausführung zu erfahren.