Verwenden vorhandener Runbooks und Module

Statt eigene Runbooks und Module in Azure Automation zu erstellen, können Sie Szenarien nutzen, die bereits von Microsoft und der Community entwickelt wurden. Aus dem Runbookkatalog im Azure-Portal können Sie Azure-bezogene PowerShell- und Python-Runbooks abrufen und aus dem PowerShell-Katalog Module und Runbooks (die teilweise Azure-spezifisch sein können). Sie können auch etwas zur Community beitragen, indem Sie von Ihnen entwickelte Szenarien zur Verfügung stellen.

Importieren von Runbooks aus GitHub über das Azure-Portal

1. Öffnen Sie im Azure-Portal Ihr Automation-Konto.

2. Wählen Sie das Blatt Runbooks unter Prozessautomatisierung aus.

3. Klicken Sie auf der Seite Runbooks auf Runbook importieren.

   

4. Auf der Seite Runbook importieren können Sie entweder eine Datei, die auf Ihrem lokalen Computer gespeichert ist, oder eine Datei von GitHub importieren, indem Sie Nach Datei suchen oder Aus Katalog durchsuchen verwenden.

5. Wählen Sie die Datei aus.

6. Geben Sie den Namen, die Runtimeversion und die Beschreibung ein.

7. Klicken Sie auf Importieren.

   

8. Wählen Sie alternativ auf der Seite Runbooks die Option Katalog durchsuchen aus, um die verfügbaren Runbooks zu durchsuchen.

   

9. Sie können die Filter über der Liste verwenden, um die Anzeige nach Herausgeber, Typ und Sortierung einzuschränken. Suchen Sie das gewünschte Katalogelement, und wählen Sie es zum Anzeigen der Details aus.

   

10. Klicken Sie auf Auswählen, um ein gewähltes Runbook auszuwählen.

11. Geben Sie auf der Seite Runbook importieren den Namen ein, und wählen Sie die Runtimeversionen aus.

12. Der Runbooktyp und die Beschreibung werden automatisch ausgefüllt.

13. Klicken Sie auf Importieren.

    

14. Das Runbook wird auf der Registerkarte Runbooks des Automation-Kontos angezeigt.

Runbooks im PowerShell-Katalog

Der PowerShell-Katalog bietet verschiedene Runbooks von Microsoft und der Community, die Sie in Azure Automation importieren können. Um eins zu verwenden, können Sie ein Runbook aus dem Katalog herunterladen, oder Sie können Runbooks direkt aus dem Katalog oder aus Ihrem Automation-Konto im Azure-Portal importieren.

Das direkte Importieren aus dem PowerShell-Katalog ist nur über das Azure-Portal möglich. Diese Funktion kann nicht mithilfe von PowerShell ausgeführt werden. Das Verfahren ist identisch mit dem unter Importieren von Runbooks aus GitHub mit dem Azure-Portal gezeigten Verfahren, mit der Ausnahme, dass die Quelle der PowerShell-Katalog ist.

Module im PowerShell-Katalog

PowerShell-Module enthalten Cmdlets, die Sie in Ihren Runbooks verwenden können. Vorhandene Module, die Sie in Azure Automation installieren können, sind im PowerShell-Katalog verfügbar. Sie starten diesen Katalog über das Azure-Portal und installieren die Module direkt in Azure Automation. Sie können sie auch manuell herunterladen und installieren.

Sie finden auch Module, die Sie im Azure-Portal importieren können. Diese finden Sie für Ihr Automation-Konto in den Modulen unter Freigegebene Ressourcen.

Allgemeine im PowerShell-Katalog verfügbare Szenarios

Die nachstehende Liste enthält einige Runbooks, die gängige Szenarien unterstützen. Eine vollständige Liste der vom Azure Automation-Team erstellten Runbooks finden Sie im AzureAutomationTeam-Profil.

• Update-ModulesInAutomationToLatestVersion: importiert die neueste Version aller Module aus dem PowerShell-Katalog in ein Automation-Konto.
• Enable-AzureDiagnostics: konfiguriert Azure-Diagnose und Log Analytics, sodass Azure Automation-Protokolle mit Auftragsstatus- und Auftragsdatenströmen empfangen werden.
• Copy-ItemFromAzureVM: kopiert eine Remotedatei von einem virtuellen Microsoft Azure-Computer.
• Copy-ItemToAzureVM: kopiert eine lokale Datei auf einen virtuellen Azure-Computer.

Mitwirken in der Community

Es wird jedem empfohlen, sich in der Azure Automation-Community zu beteiligen, damit diese noch größer wird. Teilen Sie die beeindruckenden Runbooks, die Sie für die Community erstellt haben. Ihre Beiträge werden sehr geschätzt.

Hinzufügen eines Runbooks zum Runbookkatalog von GitHub

Mit diesem GitHub-Workflow können Sie dem Runbookkatalog neue PowerShell- oder Python-Runbooks hinzufügen.

1. Erstellen Sie ein öffentliches Repository auf GitHub, und fügen Sie das Runbook und alle anderen erforderlichen Dateien hinzu (z. B. „readme.md“, Beschreibung usw.).

2. Fügen Sie das Thema azureautomationrunbookgallery hinzu, um sicherzustellen, dass das Repository von unserem Dienst ermittelt werden kann, und damit es im Automation Runbookkatalog angezeigt werden kann.

3. Wenn das von Ihnen erstellte Runbook ein PowerShell-Workflow ist, fügen Sie das Thema PowerShellWorkflow hinzu. Wenn es sich um ein Python 3-Runbook handelt, fügen Sie Python3 hinzu. Für Azure-Runbooks sind keine weiteren spezifischen Themen erforderlich. Wir empfehlen Ihnen jedoch, weitere Themen hinzuzufügen, die für die Kategorisierung und Suche im Runbookkatalog verwendet werden können.

   Hinweis

   Sehen Sie sich vorhandene Runbooks im Katalog an, um Informationen zur Formatierung, zu Headern und vorhandenen Tags zu erhalten, die Sie möglicherweise verwenden (z. B. Azure Automation oder Linux Azure Virtual Machines).

Wenn Sie Änderungen an einem vorhandenen Runbook vorschlagen möchten, reichen Sie einen Pull Request dafür ein.

Wenn Sie ein vorhandenes Runbook klonen und bearbeiten möchten, sollten Sie ihm einen anderen Namen geben. Wenn Sie den alten Namen erneut verwenden, wird er zweimal in der Runbookkatalogauflistung angezeigt.

Hinzufügen eines PowerShell-Runbooks zum PowerShell-Katalog

Microsoft empfiehlt, Runbooks aus dem PowerShell-Katalog hinzuzufügen, die für andere Kunden nützlich sein könnten. Der PowerShell-Katalog akzeptiert PowerShell-Module und PowerShell-Skripts. Sie können ein Runbook hinzufügen, indem Sie es in den PowerShell-Katalog hochladen.

Importieren eines Moduls aus dem Modulkatalog im Azure-Portal

1. Öffnen Sie im Azure-Portal Ihr Automation-Konto.

2. Wählen Sie unter Freigegebene Ressourcen die Option Module aus.

3. Wählen Sie auf der Seite Module die Option Katalog durchsuchen aus, um die Liste der Module zu öffnen.

   

4. Auf der Seite „Katalog durchsuchen“ können Sie anhand der folgenden Felder suchen:

   • Modulname
   • Tags
   • Autor
   • Cmdlet-/DSC-Ressourcenname

5. Suchen Sie das gewünschte Modul, und wählen Sie es aus, um seine Details anzuzeigen.

   Wenn Sie einen Drilldown in einem bestimmten Modul ausführen, können Sie weitere Informationen anzeigen. Diese Informationen umfassen einen Link zurück zum PowerShell-Katalog, alle erforderlichen Abhängigkeiten und alle Cmdlets oder DSC-Ressourcen, die das Modul enthält.

   

6. Um das Modul direkt in Azure Automation zu installieren, klicken Sie auf Importieren.

7. Im Bereich „Importieren“ sehen Sie den Namen des zu importierenden Moduls. Wenn alle Abhängigkeiten installiert sind, ist die Schaltfläche OK aktiv. Falls Abhängigkeiten fehlen, müssen diese Abhängigkeiten importiert werden, bevor dieses Modul importiert werden kann.

8. Klicken Sie im Bereich „Importieren“ auf OK, um das Modul zu importieren. Wenn Azure Automation ein Modul in Ihr Konto importiert, werden Metadaten zum Modul und den Cmdlets extrahiert. Dieser Vorgang kann einige Minuten dauern, da jede Aktivität extrahiert werden muss.

9. Sie erhalten jeweils eine Benachrichtigung, wenn das Modul bereitgestellt wird und wenn der Vorgang abgeschlossen ist.

10. Nachdem das Modul importiert wurde, können Sie die verfügbaren Aktivitäten anzeigen. Sie können Modulressourcen in Ihren Runbooks und DSC-Ressourcen verwenden.

Anfordern eines Runbooks oder Moduls

Sie können Anforderungen an User Voicesenden. Wenn Sie Hilfe beim Schreiben eines Runbooks benötigen oder eine Frage zu PowerShell haben, stellen Sie eine Frage auf der Frageseite von Microsoft Q&A (Fragen und Antworten).

Nächste Schritte

• Informationen zu den ersten Schritten mit PowerShell-Runbooks finden Sie unter Tutorial: Erstellen eines PowerShell-Runbooks.
• Informationen zur Arbeit mit Runbooks finden Sie unter Verwalten eines Runbooks in Azure Automation.
• Weitere Informationen zur PowerShell-Skripterstellung finden Sie in der PowerShell-Dokumentation.
• Eine Referenz zu den PowerShell-Cmdlets finden Sie unter Az.Automation.