Verwalten von Runbooks für Service Management Automation
Wichtig
Diese Version von Service Management Automation (SMA) hat das Supportende erreicht. Sie sollten ein Upgrade auf SMA 2019 durchführen.
Als Administrator für Service Management Automation (SMA) müssen Sie Runbooks konfigurieren und ausführen. Ihre Aktivitäten sind beispielsweise das Einrichten der Runbook Worker sowie das Planen und Nachverfolgen von Runbooks. Zusätzlich zu den von Ihnen erstellten Runbooks sind in SMA zwei System-Runbooks enthalten:
- DiscoverAllLocalModules: Wird sofort nach der Installation eines Runbook Workers ausgeführt. Dieses Runbook entdeckt alle nativen Module in dem Windows Server-System, in dem der Runbook Worker installiert ist. Es extrahiert Aktivitäten und Aktivitätsmetadaten für diese Module, damit deren Aktivitäten verwendet werden können, wenn Sie Runbooks in Windows Azure Pack erstellen.
- SetAutomationModuleActivityMetadata: Wird sofort ausgeführt, nachdem Sie ein Modul in SMA importiert haben. Dieses Runbook extrahiert Aktivitäten und die zugehörigen Metadaten aus einem neu importierten Modul, damit dessen Aktivitäten beim Erstellen von Runbooks in Windows Azure Pack verwendet werden können.
Konfigurieren von Runbook Workers
Wenn Sie einen Runbookauftrag in SMA starten, wird er standardmäßig von einem zufälligen Runbook Worker ausgewählt. Vielleicht möchten Sie jedoch einen bestimmten Runbook Worker verwenden. Verwenden Sie dazu die Eigenschaft RunbookWorker. Informieren Sie sich hier über die Runbookausführung.
Legen Sie einen Runbook Worker mit dem PowerShell ISE-Add-On fest.
- Melden Sie sich in der SMA ISE-Add-On-Konfiguration >>mit Ihrem SMA-Konto an. Nach der Anmeldung werden Ihre Runbooks auf der Registerkarte Runbooks angezeigt.
- Wählen Sie auf der Registerkarte Runbooks mindestens ein Runbook aus, das für einen bestimmten Runbook Worker ausgeführt werden soll.
- Klicken Sie auf Konfigurieren, und wählen Sie unter Runbookeigenschaften konfigurieren im Dropdownmenü einen Runbook Worker aus.
- Klicken Sie auf Änderungen vornehmen.
Festlegen eines Runbook Workers über das SMA PowerShell-Modul
Sie können die Eigenschaft für den Runbook Worker auch mithilfe des folgenden Befehlszeilenbefehls festlegen:
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Sample-TestRunbook"
$workerName = "Worker1"
Set-SmaRunbookConfiguration -WebServiceEndpoint $webServer -Port $port -Name $runbookName -RunbookWorker $workerName
Eine Liste aller bereitgestellten Runbook Worker wird wie folgt angezeigt:
$webServer = 'https://MyServer'
$port = 9090
Get-SmaRunbookWorkerDeployment -WebServiceEndpoint $webServer -Port $port
Hinweis
Sie können einen Runbook Worker zurzeit nicht über das Windows Azure Pack-Portal festlegen. Verwenden Sie stattdessen entweder das SMA ISE-Add-On oder PowerShell-Cmdlets.
Planen von Runbooks
Wenn Sie planen möchten, dass ein Runbook zu einem bestimmten Zeitpunkt gestartet wird, verknüpfen Sie es mit einem oder mehreren Zeitplänen. Ein Zeitplan kann so konfiguriert werden, dass er nur einmal ausgeführt wird, oder er kann so festgelegt werden, dass er wiederholt wird. Ein Runbook kann mit mehreren Zeitplänen verknüpft werden, und mit einem Zeitplan können mehrere Runbooks verknüpft sein.
Erstellen eines Zeitplans
Sie können einen Zeitplan im Verwaltungsportal oder mit Windows PowerShell erstellen.
Erstellen eines Zeitplans im Verwaltungsportal
- Wählen Sie im Verwaltungsportal Automation.
- Klicken Sie auf der Registerkarte Assets auf Einstellung hinzufügenZeitplan hinzufügen.
- Geben Sie einen Namen und eine Beschreibung für den neuen Zeitplan ein, und wählen Sie aus, ob er Einmalig oder Täglich ausgeführt werden soll.
- Geben Sie eine Startzeit und die anderen Optionen nach Bedarf an. Die Zeitzone der Startzeit stimmt mit der Zeitzone des lokalen Computers überein.
Erstellen eines Zeitplans mit Windows PowerShell
Sie können mithilfe des Cmdlets Set-SmaSchedule einen Zeitplan erstellen oder einen vorhandenen Zeitplan ändern. Sie müssen die Startzeit für den Zeitplan angeben und festlegen, ob er nur einmal oder wiederholt ausgeführt werden soll.
Im folgenden Beispiel wird ein neuer Zeitplan mit dem Namen Mein täglicher Zeitplan erstellt. Er beginnt am aktuellen Tag und wird ein Jahr lang täglich um 12 Uhr fortgesetzt.
$webServer = 'https://MyServer'
$port = 9090
$scheduleName = 'My Daily Schedule'
$startTime = (Get-Date).Date.AddHours(12)
$expiryTime = $startTime.AddYears(1)
Set-SmaSchedule -WebServiceEndpoint $webServer -Port $port -Name $scheduleName -ScheduleType OneTimeSchedule -StartTime $startTime -ExpiryTime $expiryTime -DayInterval 1
Verknüpfen eines Zeitplans mit einem Runbook
Ein Runbook kann mit mehreren Zeitplänen verknüpft werden, und mit einem Zeitplan können mehrere Runbooks verknüpft sein. Wenn es bei einem Runbook Parameter gibt, können Sie dafür Werte angeben, die beim Start des Runbooks verwendet werden sollen. Sie müssen Werte für alle obligatorischen Parameter angeben.
Verknüpfen eines Zeitplans im Verwaltungsportal
- Wählen Sie im Verwaltungsportal Automation-Runbooksaus.
- Klicken Sie auf den Namen des zu planenden Runbooks und dann auf die Registerkarte Zeitplan.
- Wenn das Runbook zurzeit mit einem Zeitplan verknüpft ist, klicken Sie auf Verknüpfen. Klicken Sie dann auf Mit einem neuen Zeitplan verknüpfen,und erstellen Sie einen neuen Zeitplan, oder klicken Sie auf Mit einem vorhandenen Zeitplan verknüpfen, und wählen Sie einen Zeitplan aus.
- Wenn das Runbook über Parameter verfügt, werden Sie zur Eingabe von Werten für diese Parameter aufgefordert.
Verknüpfen des Zeitplans mit Windows PowerShell
Sie können den Befehl Start-SmaRunbook mit dem Parameter ScheduleName verwenden, um einen Zeitplan mit einem Runbook zu verknüpfen. Sie können Werte mit dem Parameter Parameters angeben. Informieren Sie sich über Parameterwerte.
Die folgenden Beispielbefehle zeigen, wie Sie einen Zeitplan mit einem Runbook verknüpfen können.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scheduleName = "Sample-DailySchedule"
Start-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -ScheduleName $scheduleName -Parameters $params
Nachverfolgen von Runbooks
Beim Starten eines Runbooks in SMA wird ein Auftrag erstellt. Ein Auftrag ist eine einzelne Ausführungsinstanz eines Runbooks. Ein einzelnes Runbook enthält möglicherweise mehrere Aufträge mit jeweils einem eigenen Satz von Werten für die Runbookparameter.
- Wenn die Eigenschaft RunbookWorker des Runbooks aufgefüllt wird, wird der Auftrag von diesem Workerserver ausgeführt.
- Wenn der Workerserver nicht zur Verfügung steht, tritt beim Auftrag ein Fehler auf.
- Wenn die Eigenschaft RunbookWorker nicht aufgefüllt wird, wählt SMA einen verfügbaren Workerserver nach dem Zufallsprinzip aus, um die Anforderung zu bearbeiten.
Das folgende Diagramm zeigt den Lebenszyklus eines Runbookauftrags für PowerShell-Workflow-Runbooks.

Das folgende Diagramm zeigt den Lebenszyklus eines Runbookauftrags für PowerShell-Skript-Runbooks.

Auftragsstatus
Die folgende Tabelle beschreibt die verschiedenen Status, die für einen Auftrag möglich sind.
| Status | BESCHREIBUNG |
|---|---|
| Abgeschlossen | Der Auftrag wurde erfolgreich abgeschlossen. |
| Fehler | Der Auftrag wurde mit einer Ausnahme beendet. |
| In Warteschlange | Der Auftrag wartet darauf, dass Ressourcen für einen Automation-Worker verfügbar werden, damit er gestartet werden kann. |
| Wird gestartet | Der Auftrag wurde einem Worker zugewiesen, und das System ist in Begriff, ihn zu starten. |
| Wird fortgesetzt | Das System ist in Begriff, den Auftrag fortzusetzen, nachdem er angehalten wurde. |
| Wird ausgeführt | Der Auftrag wird ausgeführt. |
| Beendet | Der Auftrag wurde vom Benutzer beendet, bevor er abgeschlossen wurde. |
| Wird beendet | Das System ist in Begriff, den Auftrag zu beenden. |
| Ausgesetzt | Der Auftrag wurde vom Benutzer, vom System oder von einem Befehl im Runbook angehalten. Ein angehaltener Auftrag kann erneut gestartet werden. Er wird ab dem letzten Prüfpunkt oder ab dem Anfang des Runbooks fortgesetzt, wenn keine Prüfpunkte vorhanden sind. Das Runbook wird vom System nur bei einer Ausnahme angehalten, die fortgesetzt werden kann. Standardmäßig ist ErrorActionPreference auf Weiter festgelegt. Dies bedeutet, dass der Auftrag beim Auftreten einer Ausnahme weiterhin ausgeführt wird. Wenn diese Variable auf Beenden festgelegt ist, wird der Auftrag beim Auftreten einer Ausnahme angehalten. |
| Wird angehalten | Das System versucht, den Auftrag auf Anforderung des Benutzers anzuhalten. Das Runbook muss erst seinen nächsten Prüfpunkt erreichen, bevor der Auftrag angehalten werden kann. Wenn der letzte Prüfpunkt bereits passiert wurde, wird der Auftrag abgeschlossen, bevor er angehalten werden kann. |
Anzeigen des Auftragsstatus im Verwaltungsportal
Das Automation-Dashboard zeigt eine Zusammenfassung aller Runbooks in der SMA-Umgebung.
- Das Zusammenfassungsdiagramm zeigt die Gesamtzahl der Aufträge für alle Runbooks, die während einer bestimmten Anzahl von Tagen oder Stunden den jeweiligen Status erreicht haben.
- Sie können in der oberen rechten Ecke des Diagramms einen Zeitraum auswählen.
- Die Zeitachse des Diagramms ändert sich je nach Art des von Ihnen ausgewählten Zeitraums.
- Sie können die Zeitlinie für einen bestimmten Status anzeigen, indem Sie am oberen Bildschirmrand auf den Status klicken.
Zeigen Sie das Dashboard so an:
- Wählen Sie im Verwaltungsportal Automation.
- Wählen Sie die Registerkarte Dashboard aus.
Anzeigen des Dashboards
Das Runbook-Dashboard zeigt eine Zusammenfassung für ein einzelnes Runbook. Das Zusammenfassungsdiagramm zeigt die Gesamtzahl der Aufträge für das Runbook, die während einer bestimmten Anzahl von Tagen oder Stunden den jeweiligen Status erreicht haben. Sie können in der oberen rechten Ecke des Diagramms einen Zeitraum auswählen. Die Zeitachse des Diagramms ändert sich je nach Art des von Ihnen ausgewählten Zeitraums. Sie können die Zeitlinie für einen bestimmten Status anzeigen, indem Sie am oberen Bildschirmrand auf den Status klicken.
Zeigen Sie das Dashboard so an:
- Wählen Sie im Verwaltungsportal Automation.
- Klicken Sie auf den Namen eines Runbooks.
- Wählen Sie die Registerkarte Dashboard aus.
Anzeigen von Auftragsdetails
Sie können eine Liste aller Aufträge, die für ein bestimmtes Runbook erstellt wurden, und deren aktuellsten Status anzeigen.
- Diese Liste können Sie nach Auftragsstatus und dem Datumsbereich für die letzte Änderung am Auftrag filtern.
- Klicken Sie auf den Namen eines Auftrags, um detaillierte Informationen und die Auftragsausgabe anzuzeigen.
- Die Detailansicht des Auftrags enthält die Werte für die Runbookparameter, die für diesen Auftrag bereitgestellt wurden.
- Der Auftragsverlauf umfasst Ausgabe, Warnungen und Fehlermeldungen mit Zeitstempeln mit dem genauen Datum der Erstellung des Datensatzes.
- Informieren Sie sich über Runbookausgabe und Meldungen.
- Die Quelle für einen Auftrag ist der Quellcode des Workflows während der Ausführung des Auftrags. Dies ist mit der aktuellen Version des Runbooks möglicherweise nicht identisch, wenn das Runbook nach Ausführung des Auftrag aktualisiert wurde.
Zeigen Sie die Aufträge für ein Runbook mithilfe der folgenden Schritte an.
- Wählen Sie im Verwaltungsportal Automation.
- Klicken Sie auf den Namen eines Runbooks, und wählen Sie die Registerkarte Aufträge aus.
- Klicken Sie auf die Spalte Auftrag erstellt für einen Auftrag, um dessen Details und Ausgabe anzuzeigen.
- Wählen Sie die die Registerkarte Verlauf , um den Auftragsverlauf anzuzeigen. Wählen Sie ein Verlaufselement, und klicken Sie am unteren Rand des Bildschirms auf Details anzeigen für eine detaillierte Ansicht des Datensatzes.
- Klicken Sie auf der Registerkarte Verlauf auf Quelle anzeigen.
Abrufen des Auftragsstatus mithilfe von Windows PowerShell
Sie können mithilfe des Befehls Get-SmaJob die für ein Runbook erstellten Aufträge und die Details eines bestimmten Auftrags abrufen.
- Wenn Sie ein Runbook mit dem Windows PowerShell-Befehl Start-SmaRunbook starten, wird der dadurch entstehende Auftrag zurückgegeben.
- Mithilfe des Befehls Get-SmaJobOutput erhalten Sie die Ausgabe eines Auftrags.
Die folgenden Beispielbefehle rufen den letzten Auftrag für ein Beispiel-Runbook ab und zeigen dessen Status, die für die Runbookparameter angegebenen Werte und die Ausgabe aus dem Auftrag an.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$job = (Get-SmaJob -WebServiceEndpoint $webServer -Port $port -RunbookName $runbookName | sort LastModifiedDate -desc)[0]
$job.Status
$job.JobParameters
Get-SmaJobOutput -WebServiceEndpoint $webServer -Port $port -Id $job.Id -Stream Output
Konfigurieren von Runbookeinstellungen
Bei jedem Runbook gibt es mehrere Einstellungen. Mithilfe dieser Einstellungen können Sie Runbooks suchen und verwalten. Sie können auch die Runbookprotokollierung ändern, indem Sie diese Einstellungen konfigurieren. Nachfolgend werden die einzelnen Einstellungen beschrieben, und Sie erfahren, wie sie geändert werden können.
Name und Beschreibung
Sie können den Namen eines Runbooks nach dessen Erstellung nicht mehr ändern. Die Beschreibung ist optional und kann bis zu 512 Zeichen lang sein.
`Tags`
Tags ermöglichen es Ihnen, bestimmte Wörter oder Ausdrücke zuzuweisen, um ein Runbook zu identifizieren. Sie können mehrere Tags für ein Runbook angeben, wenn sie diese durch Kommas voneinander trennen.
Protokollierung
Standardmäßig werden keine Verbose- und Progress-Datensätze in den Auftragsverlauf geschrieben. Sie können die Einstellungen für ein bestimmtes Runbook ändern, um diese Datensätze zu protokollieren. Weitere Informationen zu diesen Datensätzen finden Sie unter Runbookausgabe und Meldungen.
Festgelegter Runbook Worker
Standardmäßig wird ein Runbookauftrag einem zufälligen Runbook Worker zugewiesen, der ausgeführt werden soll. Sie können die Einstellungen für ein bestimmtes Runbook ändern, damit es auf einem bestimmten Runbook Worker ausgeführt wird.
Ändern der Runbookeinstellungen im Verwaltungsportal
Sie können die Einstellungen für ein Runbook im Verwaltungsportal auf der Seite Konfigurieren ändern.
Wählen Sie im Verwaltungsportal Automation.
Klicken Sie auf die Registerkarte Runbooks.
Klicken Sie auf den Namen eines Runbooks.
Wählen Sie die Registerkarte Konfigurieren aus.
Ändern der Runbookeinstellungen mit PowerShell
Sie können mithilfe des Cmdlets Set-SmaRunbookConfiguration alle Einstellungen für ein Runbook mit Ausnahme von Tags ändern. Sie können Tags nur für vorhandene Runbooks ändern oder welche hinzufügen, die das Verwaltungsportal verwenden. Sie können Tags für Runbooks mit PowerShell nur dann festlegen, wenn Sie ein Runbook mithilfe von Import-SmaRunbook importieren.
Die folgenden Beispielbefehle zeigen, wie Sie die Eigenschaften für ein Runbook festlegen. In diesem Beispiel wird eine Beschreibung hinzugefügt und angegeben, dass ausführliche Datensätze protokolliert werden sollen:
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Sample-TestRunbook"
Set-SmaRunbookConfiguration -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Description "Sample runbook" -LogVerbose $true
Verschlüsseln der Verbindung zwischen Runbook Worker und SQL Server
Schützen Sie die Verbindung zwischen den Runbook Worker-Prozessen und SQL Server mithilfe von SSL.
Nächste Schritte
- Informieren Sie sich über das Verwalten von globalen Ressourcen.
- Informieren Sie sich über die Rolle von SMA in einer Windows Azure Pack-Implementierung.