Erstellen und Testen eines Beispiel-Runbook

Im folgenden Artikel wird beschrieben, wie Sie ein Beispiel-Runbook erstellen und testen. Der Zweck dieses Runbooks besteht darin, zu erkennen, wann eine Textdatei einem bestimmten Ordner hinzugefügt wird, diese Datei in einen anderen Ordner zu kopieren, den Inhalt der Datei zu lesen, eine Zeile aus der kopierten Datei an eine andere Datei anzufügen und dann die ursprüngliche Datei zu löschen.

Das Runbook beginnt mit einer Aktivität Datei überwachen, bis die Textdatei erstellt wird. Anschließend werden die Aktivitäten Datei kopieren, Zeile lesen, Zeile anfügen und Datei löschen verwendet, um die anderen Funktionen auszuführen. Eine Aktivität Knotenpunkt wird verwendet, um die Aktivitäten zu koordinieren, sodass die Aktivitäten Datei kopieren und Zeile anfügen beide abgeschlossen werden, bevor die Quelldatei gelöscht wird.

Erstellen des Runbooks

Verwenden Sie die folgenden Verfahren, um das Runbook mithilfe der erforderlichen Aktivitäten zu erstellen.

1. Wählen Sie "Start" aus, zeigen Sie auf "Alle Programme", wählen Sie "Microsoft System Center 2025" aus, wählen Sie "Orchestrator" und dann "Runbook-Designer" aus.

2. Klicken Sie im Bereich Verbindungen mit der rechten Maustaste auf Runbooks, Neu und wählen Sie dann Runbook.

   Am oberen Rand des Runbook-Designer-Designarbeitsbereichs erscheint die Reegisterkarte Neues Runbookmit dem Namen Neues Runbook.

3. Klicken Sie mit der rechten Maustaste auf die Registerkarte Neues Runbook und wählen Sie Umbenennen.

   Wählen Sie im Dialogfeld Bestätigen die Option Ja.

4. Geben Sie Workflow anfügen und kopieren in das Eingabefeld ein und drücken Sie dann die Eingabetaste.

Sie haben ein neues Runbook erstellt und können mit dem Hinzufügen und Konfigurieren von Aktivitäten beginnen.

Aktivität "Datei überwachen" hinzufügen und konfigurieren

Führen Sie die folgenden Schritte aus, um eine Aktivität "Datei überwachen" hinzuzufügen und zu konfigurieren:

1. Wenn das neu erstellte Runbook Workflow anfügen und kopieren geöffnet ist, erweitern Sie im Bereich Aktivitäten die Kategorie Dateiverwaltung.

2. Wählen Sie die Aktivität Datei überwachen aus und ziehen Sie sie in den Designarbeitsbereich von Runbook Designer.

3. Doppelklicken Sie auf die Aktivität Datei überwachen, um das Dialogfeld Eigenschaften zu öffnen.

4. Geben Sie im Ordnerfeld C:\Drop ein.

5. Wählen Sie im Abschnitt Filter die Schaltfläche Hinzufügen.

6. Wählen Sie im Dialogfeld Filtereinstellungen in der Liste Name die Option Dateiname aus.

7. Wählen Sie in der Liste Beziehung die Option Übereinstimmungsmuster.

8. Geben Sie im Feld Wert *.txt eein.

9. Wählen Sie OK aus.

10. Wählen Sie die Registerkarte Trigger aus.

11. Aktivieren Sie im Abschnitt Trigger, wenn eine der Dateien, das Kontrollkästchen Erstellt und dann Fertig stellen.

Die Aktivität Datei überwachen wird erstellt und so konfiguriert, dass sie alle neuen Textdateien überwacht, die im Ordner C:\Drop erstellt werden.

Zusätzliche Aktivitäten zum Runbook hinzufügen

Gehen Sie folgendermaßen vor, um dem Runbook zusätzliche Aktivitäten hinzuzufügen:

1. Erweitern Sie im Bereich Aktivitäten die Kategorie Dateiverwaltung.

2. Wählen Sie die Aktivität Datei kopieren aus und ziehen Sie sie in den Runbook Designer Design-Arbeitsbereich.

3. Erweitern Sie die Kategorie Textdateiverwaltung.

4. Wählen Sie die Aktivität Zeile lesen aus und ziehen Sie sie in den Runbook Designer Design-Arbeitsbereich.

5. Um eine Verknüpfung zwischen der Aktivität Datei überwachen und der Aktivität Datei kopieren zu erstellen, markieren Sie den rechten Pfeil der Aktivität Datei überwachen und ziehen Sie ihn auf die Aktivität Datei kopieren.

6. Um eine Verknüpfung zwischen der Aktivität Datei überwachen und der Aktivität Zeile lesen zu erstellen, markieren Sie den rechten Pfeil der Aktivität Datei überwachen und ziehen Sie ihn auf die Aktivität Zeile lesen.

Indem Sie sowohl die Aktivität Zeile lesen als auch die Aktivität Datei kopieren hinzufügen, haben Sie einen Workflow erstellt.

Konfigurieren Sie die Aktivität Datei kopieren

Gehen Sie folgendermaßen vor, um die Aktivität Datei kopieren zu konfigurieren:

1. Klicken Sie im Runbook Workflow anhängen und kopieren mit der rechten Maustaste auf die Aktivität Datei kopieren und wählen Sie Eigenschaften.

2. Klicken Sie auf der Registerkarte Details mit der rechten Maustaste auf das Feld Datei, um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

   Die Aktivität Datei überwachen wird oben im Dialogfeld Veröffentlichte Daten aufgelistet, da dies die Aktivität unmittelbar vor der ausgewählten Aktivität ist.

3. Wählen Sie in der Spalte Name den Namen und den Pfad der Datei und dann OK aus. Dadurch wird die Eigenschaft Datei der Aktivität Datei kopieren mit dem Namen und Pfad der Datei aus der Aktivität Datei überwachen gefüllt.

4. Geben Sie in das Feld Ordner C:\Copy ein.

5. Wählen Sie Fertig stellen aus.

Die Aktivität Datei kopieren ist nun so konfiguriert, dass Dateien aus dem Quellordner in den Zielordner kopiert werden.

Konfigurieren der Aktivität „Zeile lesen“

Führen Sie folgende Schritte aus, um die Aktivität „Zeile lesen“ zu konfigurieren.

1. Klicken Sie im Runbook Workflow anfügen und kopieren mit der rechten Maustaste auf die Aktivität Zeile lesen, um Eigenschaften auszuwählen.

2. Klicken Sie auf der Registerkarte Details mit der rechten Maustaste auf das Feld Datei, um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

3. Wählen Sie in der Liste Aktivitäten die Option Datei überwachen aus.

4. Wählen Sie in der Spalte Name den Namen und den Pfad der Datei und dann OK aus.

5. Wählen Sie die Schaltfläche mit den Auslassungszeichen (...) rechts neben dem Feld Dateicodierung aus, und wählen Sie dann Auto aus.

6. Geben Sie im Feld Zeilennummern 1-ENDE ein, und wählen Sie dann OK aus.

7. Wählen Sie Fertig stellen aus.

Die Aktivität „Zeile lesen“ ist jetzt konfiguriert.

Hinzufügen einer Aktivität „Zeile anfügen“

Führen Sie die folgenden Schritte aus, um eine Aktivität „Zeile anfügen“ hinzuzufügen:

1. Erweitern Sie im Bereich Aktivitäten die Kategorie Textdateiverwaltung.

2. Wählen Sie die Aktivität Zeile anfügen aus und ziehen Sie sie rechts neben der Aktivität Zeile lesen in den Designarbeitsbereich von Runbook Designer.

3. Wenn Sie einen Link von der Aktivität Zeile lesen zur Aktivität Zeile anfügen erstellen möchten, wählen Sie die rechte Pfeiltaste der Aktivität Zeile lesen aus und ziehen Sie sie auf die Aktivität Zeile anfügen.

4. Klicken Sie mit der rechten Maustaste auf die Aktivität Zeile anfügen, um Eigenschaften auszuwählen.

5. Geben Sie auf der Registerkarte Details im Feld Datei C:\Copy\Masterlog.txt ein.

6. Wählen Sie die Schaltfläche mit den Auslassungszeichen (...) rechts neben dem Feld Dateicodierung aus, und wählen Sie dann Auto aus.

7. Klicken Sie mit der rechten Maustaste auf das Feld Text, um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

8. Wählen Sie in der Spalte Name für die Aktivität Zeile lesen die Option Zeilentext aus und wählen Sie dann OK aus.

9. Wählen Sie Fertig stellen aus.

Die Aktivität Datei anfügen ist jetzt so konfiguriert, dass Dateien an die Datei Masterlog.txt angefügt werden.

Synchronisieren von Verzweigungen eines Runbook

Führen Sie die folgenden Schritte aus, um die Verzweigungen eines Runbook zu synchronisieren:

1. Erweitern Sie im Bereich Aktivitäten die Kategorie Runbook-Steuerelement.

2. Wählen Sie das Symbol Verknüpfung aus, und ziehen Sie es in den Designarbeitsbereich des Runbook-Designers.

3. Wenn Sie einen Link von der Aktivität Zeile anfügen zur Aktivität Verbindung erstellen möchten, wählen Sie die NACH-RECHTS-TASTE der Aktivität Zeile anfügen aus, und ziehen Sie ihn zur Aktivität Verbindung.

4. Wenn Sie einen Link von der Aktivität Datei kopieren zur Aktivität Verbindung erstellen möchten, wählen Sie die NACH-RECHTS-TASTE der Aktivität Datei kopieren aus und ziehen Sie ihn zur Aktivität Verbindung.

5. Klicken Sie mit der rechten Maustaste auf die Aktivität Verbindung, um Eigenschaften auszuwählen.

6. Wählen Sie die Schaltfläche mit den Auslassungspunkten (...) neben dem Feld Daten zurückgeben aus, und wählen Sie dann Datei kopieren aus. Wählen Sie OK aus. Mit dieser Aktion wird die Aktivität so konfiguriert, dass dieselben veröffentlichten Daten zurückgegeben werden wie bei der Aktivität Datei kopieren.

7. Wählen Sie Fertig stellen aus.

Die Aktivität Verbindung ist so konfiguriert, dass der Workflow koordiniert wird, sodass keine weiteren Aktivitäten ausgeführt werden, bis die Aktivität Datei kopieren und die Aktivität Zeile anfügen abgeschlossen sind.

Hinzufügen und Konfigurieren der Aktivität „Datei löschen“

Führen Sie die folgenden Schritte aus, um die Aktivität „Datei löschen“ hinzuzufügen und zu konfigurieren

1. Erweitern Sie im Bereich Aktivitäten die Kategorie Dateiverwaltung.

2. Wählen Sie das Symbol Datei löschen aus, und ziehen Sie es in den Designarbeitsbereich des Runbook-Designers.

3. Wenn Sie einen Link von der Aktivität Verbindung zur Aktivität Datei löschen erstellen möchten, wählen Sie die NACH-RECHTS-TASTE der Aktivität Verbindung und ziehen Sie ihn zur Aktivität Datei löschen.

4. Klicken Sie mit der rechten Maustaste auf die Aktivität Datei löschen, um Eigenschaften auszuwählen.

5. Klicken Sie mit der rechten Maustaste auf das Feld Pfad, um Abonnieren auszuwählen, und wählen Sie dann Veröffentlichte Daten aus, um das Dialogfeld Veröffentlichte Daten zu öffnen.

   Wählen Sie in der Aktivitätsliste Datei kopieren aus.

6. Wählen Sie in der Spalte Name Name und Pfad der ursprünglichen Datei und dann OK aus.

7. Wählen Sie Fertig stellen aus.

Das Runbook Anfügen und Kopieren von Workflows ist jetzt abgeschlossen. Es sollte ähnlich der folgenden Abbildung aussehen:

Testen des Runbooks

Sie können das Runbook mit dem Runbook Tester testen. Mit diesem Tool können Sie das gesamte Runbook ausführen und den Abschlussstatus und die Ausgabe jeder Aktivität überprüfen. Der Runbook-Tester führt die Aktivitäten aus, sodass Sie zuerst die für das Runbook angegebenen Ordner erstellen müssen.

Gehen Sie folgendermaßen vor, um das Runbook zu testen:

1. Erstellen Sie auf dem Runbook-Server einen Ordner mit dem Namen C:\Drop.

2. Erstellen Sie auf dem Runbook-Server einen Ordner namens C:\Copy.

3. Wenn das Runbook Workflow anhängen und kopieren im Runbook Designer ausgewählt ist, wählen Sie in der Symbolleiste Runbook Tester.

4. Wählen Sie Bis zum Haltepunkt ausführen. Die Aktivität Datei überwachen wird geladen und wartet darauf, dass eine Textdatei im Ordner C:\Drop erstellt wird.

5. Öffnen Sie Notepad und geben Sie ein paar Zeilen Text ein. Speichern Sie die Datei unter C:\Drop\File1.txt.

6. Warten Sie einige Augenblicke, bis die anderen Aktivitäten ausgeführt werden. Stellen Sie sicher, dass jede der Aktivitäten erfolgreich abgeschlossen ist.

7. Um die veröffentlichten Daten und andere Details zu einer Aktivität anzuzeigen, wählen Sie Details anzeigen für die Aktivität aus.

8. Öffnen Sie den Ordner C:\Drop und vergewissern Sie sich, dass die Datei entfernt worden ist.

9. Öffnen Sie den Ordner C:\Copy und stellen Sie sicher, dass die Datei kopiert wurde. Stellen Sie außerdem sicher, dass die MasterLog.txt Datei den Inhalt der ursprünglichen Datei aufweist.

Nächste Schritte

Siehe Beispiel-Runbook : Überwachen eines Ordners mit einem Runbook.