Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Öffnen Sie im Azure-Portal Ihr Automatisierungskonto.
Wählen Sie das Blatt Runbooks unter Prozessautomatisierung aus.
Klicken Sie auf der Seite Runbooks auf Runbook importieren.
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.
Wählen Sie die Datei aus.
Geben Sie den Namen, die Runtimeversion und die Beschreibung ein.
Klicken Sie auf Importieren.
Wählen Sie alternativ auf der Seite Runbooks die Option Katalog durchsuchen aus, um die verfügbaren Runbooks zu durchsuchen.
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.
Klicken Sie auf Auswählen, um ein Runbook Ihrer Wahl auszuwählen.
Geben Sie auf der Seite Runbook importieren den Namen ein und wählen Sie die Runtime-Versionen aus.
Der Runbooktyp und die Beschreibung werden automatisch ausgefüllt.
Klicken Sie auf Importieren.
Das Runbook wird auf der Registerkarte Runbooks des Automation-Kontos angezeigt.
Runbooks im PowerShell-Katalog
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.
Module in der 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 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.
Allgemeine Szenarien, die im PowerShell-Katalog verfügbar sind
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.
- Update-ModulesInAutomationToLatestVersion – Importiert die neueste Version aller Module in einem Automatisierungskonto aus PowerShell-Katalog.
- Enable-AzureDiagnostics – Konfiguriert Azure-Diagnose und Log Analytics, um Azure Automation Protokolle mit Auftragsstatus und Auftragsdatenströmen zu empfangen.
- Copy-ItemFromAzureVM – Kopiert eine Remotedatei von einem Windows Azure virtuellen Computer.
- Copy-ItemToAzureVM – Kopiert eine lokale Datei auf einen Azure virtuellen Computer.
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.
Hinzufügen eines Runbooks zur GitHub Runbook-Galerie
Sie können dem Runbook-Katalog mit diesem GitHub Workflow neue PowerShell- oder Python Runbooks hinzufügen.
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.).
Fügen Sie das Thema
azureautomationrunbookgalleryhinzu, um sicherzustellen, dass das Repository von unserem Dienst ermittelt werden kann, und damit es im Automation Runbookkatalog angezeigt werden kann.Wenn das von Ihnen erstellte Runbook ein PowerShell-Workflow ist, fügen Sie das Thema
PowerShellWorkflowhinzu. Wenn es sich um ein Python 3 Runbook handelt, fügen SiePython3hinzu. 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 AutomationoderLinux 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.
Ein PowerShell-Runbook zur PowerShell-Galerie hinzufügen
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.
Importieren eines Moduls aus dem Modulkatalog im Azure Portal
Öffnen Sie im Azure-Portal Ihr Automatisierungskonto.
Wählen Sie unter Freigegebene Ressourcen die Option Module aus.
Wählen Sie auf der Seite Module die Option Katalog durchsuchen aus, um die Liste der Module zu öffnen.
Auf der Seite „Galerie durchsuchen“ können Sie in den folgenden Feldern suchen:
- Modulname
- Schlagwörter
- Autor
- Cmdlet-/DSC-Ressourcenname
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.
Um das Modul direkt in Azure Automation zu installieren, klicken Sie auf Import.
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.
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.
Sie erhalten jeweils eine Benachrichtigung, wenn das Modul bereitgestellt wird und wenn der Vorgang abgeschlossen ist.
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
Nächste Schritte
- Informationen zu den ersten Schritten mit PowerShell-Runbooks finden Sie unter Tutorial: Erstellen eines PowerShell-Runbooks.
- Informationen zum Arbeiten mit Runbooks finden Sie unter Manage runbooks in Azure Automation.
- Weitere Informationen zum PowerShell-Skripting finden Sie in den PowerShell-Dokumenten.
- Eine Referenz zu den PowerShell-Cmdlets finden Sie unter Az.Automation.
- Informationen zur Problembehandlung bei der Verwendung von Runbooks und freigegebenen Ressourcen wie dem Runbook-Katalog oder PowerShell-Katalog in Azure Automation finden Sie unter Problembehandlung bei Azure Automation-Problemen mit freigegebenen Ressourcen.
- Informationen zur Problembehandlung bei der Verwendung vorhandener Runbooks in Azure Automation finden Sie unter Problembehebung bei Runbook-Problemen.