Verwenden Sie die vorhandenen Runbooks und Module

Anstatt eigene Runbooks und Module in Azure Automation zu erstellen, können Sie auf Szenarien zugreifen, die bereits von Microsoft und der Community erstellt 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.

Hinweis

Das TechNet Script Center wird eingestellt. Alle Runbooks aus dem Script Center in der Runbook-Galerie wurden in unsere Automation GitHub Organisation verschoben. Weitere Informationen finden Sie unter Azure Automation Runbooks werden auf GitHub verschoben.

Importieren von Runbooks aus GitHub mit dem Azure-Portal

Hinweis

  • Die Option Katalog im Azure Portal bietet eine verbesserte Benutzeroberfläche.
  • Auf der Registerkarte Prozessautomatisierung>Runbook können Sie Runbooks entweder über die Möglichkeit Runbook importieren oder Katalog durchsuchen importieren. Auf der Seite Runbooks werden zwei neue Spalten angezeigt: Runtime-Version und Runbook-Typ.
  1. Öffnen Sie im Azure-Portal Ihr Automatisierungskonto.

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

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

    Screenshot: Auswahl eines Runbooks über die Option „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.

    Screenshot: Auswählen eines Runbooks aus einer Datei oder einem Katalog

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

    Screenshot: Auswahl der „Galerie durchsuchen“-Option im „Runbook“-Bereich

  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.

    Runbook-Galerie durchsuchen

  10. Klicken Sie auf Auswählen, um ein Runbook Ihrer Wahl auszuwählen.

  11. Geben Sie auf der Seite Runbook importieren den Namen ein und wählen Sie die Runtime-Versionen aus.

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

  13. Klicken Sie auf Importieren.

    Importieren eines Katalogelements

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

Wichtig

Sie sollten den Inhalt aller Runbooks überprüfen, die Sie von der PowerShell-Katalog erhalten. Gehen Sie äußerst vorsichtig vor, wenn Sie die Inhalte in einer Produktionsumgebung installieren und ausführen.

Die PowerShell-Katalog bietet verschiedene Runbooks aus Microsoft und der Community, die Sie in Azure Automation importieren können. Um ein Runbook aus dem Katalog zu verwenden, laden Sie ein Runbook aus dem Katalog herunter, oder Sie können Runbooks direkt aus dem Katalog oder aus Ihrem Automatisierungskonto im Azure-Portal importieren.

Hinweis

Grafische Runbooks werden in PowerShell-Katalog nicht unterstützt.

Sie können nur direkt aus der PowerShell-Katalog mithilfe des Azure-Portals importieren. Sie können diese Funktion nicht mithilfe von PowerShell ausführen. Die Prozedur ist identisch mit Importieren von Runbooks aus GitHub mit dem Azure Portal außer dass die SourcePowerShell-Katalog ist.

Anzeigen der Quellenauswahl der Runbook-Galerie

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 können diesen Katalog über das Azure Portal starten und die Module direkt in Azure Automation installieren, oder Sie können sie manuell herunterladen und installieren.

Sie finden auch Module, die im Azure Portal importiert werden sollen. Diese finden Sie für Ihr Automation-Konto in den Modulen unter Freigegebene Ressourcen.

Wichtig

Fügen Sie das Schlüsselwort "AzureRm" nicht in ein Skript ein, das mit dem Az-Modul ausgeführt werden soll. Die Einbeziehung des Schlüsselworts, auch in einen Kommentar, kann dazu führen, dass AzureRM geladen wird und einen Konflikt mit dem Az-Modul verursacht.

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 unter AzureAutomationTeam-Profil.

Mitwirken in der Community

Wir empfehlen Ihnen dringend, einen Beitrag zu leisten und das Wachstum der Azure Automation Community zu unterstützen. Teilen Sie die beeindruckenden Runbooks, die Sie erstellt haben, mit der Community. Ihre Beiträge werden sehr geschätzt.

Sie können dem Runbook-Katalog mit diesem GitHub Workflow 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 anderen spezifischen Themen erforderlich. Wir empfehlen wir jedoch, weitere Themen hinzuzufügen, die zur Kategorisierung und Suche in der Runbook-Galerie verwendet werden können.

    Hinweis

    Sehen Sie sich verfügbare Runbooks im Katalog an, um Dinge wie Formatierung, Kopfzeilen und vorhandene Tags zu finden, die Sie möglicherweise verwenden könnten (wie 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 Runbook-Galerieauflistung angezeigt.

Hinweis

Bitte erlauben Sie mindestens 12 Stunden für die Synchronisierung zwischen GitHub und der Automation Runbook Gallery sowohl für aktualisierte als auch für neue Runbooks.

Microsoft ermutigt Sie, Runbooks zur PowerShell-Katalog hinzuzufügen, die Ihrer Meinung nach für andere Kunden nützlich sind. Die PowerShell-Katalog akzeptiert PowerShell-Module und PowerShell-Skripts. Sie können ein Runbook hinzufügen, indem Sie es in die PowerShell-Katalog hochladen.

  1. Öffnen Sie im Azure-Portal Ihr Automatisierungskonto.

  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.

    Ansicht des Modulkatalogs.

  4. Auf der Seite „Galerie durchsuchen“ können Sie in den folgenden Feldern suchen:

    • Modulname
    • Schlagwörter
    • Autor
    • Cmdlet-/DSC-Ressourcenname
  5. Suchen Sie das gewünschte Modul, und wählen Sie es aus, um seine Details anzuzeigen.

    Wenn Sie in ein bestimmtes Modul eintauchen, können Sie weitere Informationen anzeigen. Diese Informationen enthalten einen Link zurück zum PowerShell-Katalog, alle erforderlichen Abhängigkeiten und alle Cmdlets oder DSC-Ressourcen, die das Modul enthält.

    Detaillierte Ansicht eines Moduls aus dem Katalog.

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

  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. Während Azure Automation ein Modul in Ihr Konto importiert, extrahiert es Metadaten über das Modul und die Cmdlets. 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.

Hinweis

Module, die nur PowerShell-Kern unterstützen, werden in Azure Automation nicht unterstützt und können nicht im Azure-Portal importiert oder direkt aus dem PowerShell-Katalog bereitgestellt werden.

Anfordern eines Runbooks oder Moduls

Sie können Anforderungen an User Voicesenden. Wenn Sie Hilfe beim Erstellen eines Runbooks benötigen oder eine Frage zu PowerShell haben, stellen Sie eine Frage auf unserer Microsoft Fragen & Antwort-Seite.

Nächste Schritte