Runbookerstellung über VS Code in Azure Automation

  • Artikel

In diesem Artikel wird die Visual Studio-Erweiterung erläutert, die Sie zum Erstellen und Verwalten von Runbooks verwenden können.

Azure Automation bietet eine neue Erweiterung aus VS Code zum Erstellen und Verwalten von Runbooks. Mit dieser Erweiterung können Sie alle Runbook-Verwaltungsvorgänge ausführen, z. B. Erstellen und Bearbeiten von Runbooks, Auslösen eines Auftrags, Nachverfolgen der Ausgabe zuletzt verwendeter Aufträge, Verknüpfen eines Zeitplans, Ressourcenverwaltung und lokales Debuggen.

Voraussetzungen

  • Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
  • Visual Studio Code
  • PowerShell-Module und Python-Pakete, die von Runbook verwendet werden, müssen lokal auf dem Computer installiert sein, um das Runbook lokal auszuführen.

Unterstützte Betriebssysteme

Die Testmatrix enthält die folgenden Betriebssysteme:

  1. Windows Server 2022 mit Windows PowerShell 5.1 und PowerShell Core 7.2.7
  2. Windows Server 2019 mit Windows PowerShell 5.1 und PowerShell Core 7.2.7
  3. macOS 11 mit PowerShell Core 7.2.7
  4. Ubuntu 20.04 mit PowerShell Core 7.2.7

Hinweis

  • Die Erweiterung sollte überall in VS Code funktionieren und unterstützt PowerShell 7.2 oder höher. Für Windows PowerShell wird nur Version 5.1 unterstützt.
  • PowerShell Core 6 ist veraltet und wird nicht mehr unterstützt.

Wichtige Funktionen

  • Vereinfachtes Onboarding – Sie können sich auf einfache und sichere Weise mit einem Azure-Konto anmelden.
  • Mehrere Sprachen – Unterstützt alle Automatisierungs-Laufzeitstapel wie PowerShell 5, PowerShell 7, Python 2 und Python 3 Runbooks.
  • Supportfähigkeit – Unterstützt die Testausführung von Aufträgen, das Veröffentlichen von Automatisierungsaufträgen und Auslösen von Aufträgen in Azure und Hybrid-Mitarbeitern. Sie können Runbooks lokal ausführen.
  • Unterstützt Python-Positionsparameter und PowerShell-Parameter zum Auslösen des Auftrags.
  • Webhooks vereinfacht – Sie können einen Webhook erstellen, einen Auftrag auf einfachere Weise über einen Webhook starten. Unterstützung zum Verknüpfen eines Zeitplans mit einem Runbook.
  • Verwalten von Automatisierungsressourcen – Sie können Vorgänge zum Erstellen, Aktualisieren und Löschen von Objekten ausführen, einschließlich Zertifikaten, Variablen, Anmeldeinformationen und Verbindungen.
  • Eigenschaften anzeigen – Sie können die Eigenschaften anzeigen und die Hybridarbeitsgruppe auswählen, um Hybridaufträge auszuführen und die letzten 10 ausgeführten Aufträge anzuzeigen.
  • Lokal debuggen – Sie können die PowerShell-Skripts lokal debuggen.
  • Runbook-Vergleich – Sie können das lokale Runbook mit der veröffentlichten oder der Entwurfsversion des Runbooks vergleichen.

Schlüsselfunktionen von v1.0.8

  • Lokale Einstellungen für die Konfiguration des Verzeichnisses – Sie können das Arbeitsverzeichnis definieren, das Sie lokal speichern möchten.

    • Verzeichnisbasispfad ändern – Sie verwenden den geänderten Verzeichnispfad, wenn Sie Visual Studio Code IDE erneut öffnen. Um das Verzeichnis mithilfe der Befehlspalette zu ändern, verwenden Sie Strg+Umschalt+P –> wählen Sie „Verzeichnis ändern“ aus. Um den Basispfad in den Konfigurationseinstellungen der Erweiterung zu ändern, wählen Sie das Symbol Verwalten in der Aktivitätsleiste auf der linken Seite und gehen Sie zu Einstellungen > Erweiterungen > Azure Automation > Verzeichnis:Basispfad.
    • Verzeichnis:Ordnerstruktur ändern – Sie können die Struktur des lokalen Verzeichnisordners von vscodeAutomation/accHash zu subscription/resourceGroup/automationAccount ändern. Wählen Sie das Symbol Verwalten in der Aktivitätsleiste auf der linken Seite und gehen Sie zu Einstellungen > Erweiterungen > Azure Automation > Verzeichnis:Ordnerstruktur. Sie können die Standardkonfigurationseinstellung von vscodeAutomation/accHash zum Format subscription/resourceGroupe/automationAccount ändern.

      Hinweis

      Wenn Ihr Automatisierungskonto in die Quellcodeverwaltung integriert ist, können Sie den Runbook-Ordnerpfad Ihres GitHub-Repositorys als Verzeichnispfad angeben. Zum Beispiel: Das Ändern des Verzeichnisses in C:\abc würde Runbooks in C:\abc\vscodeAutomation.. oder C:\abc//subscriptionName///resourceGroupName///automationAccountName///runbookname.ps1 speichern.

  • Runbook-Verwaltungsvorgänge – Sie können Runbook erstellen, Entwurfs-Runbook abrufen, veröffentlichtes Runbook abrufen, lokales Runbook im Editor öffnen, lokales Runbook mit einer veröffentlichten oder Entwurfsausführungskopie vergleichen, als Entwurf hochladen, Runbook veröffentlichen und Runbook aus Ihrem Automatisierungskonto löschen.

  • Runbook-Ausführungsvorgänge – Sie können eine lokale Version von Automatisierungsaufträgen ausführen, z. B. Automatisierungsaufträge starten, Automatisierungstestaufträge starten, Auftragsausgaben anzeigen und die lokale Version des PowerShell-Runbooks im Debugmodus ausführen, indem Sie Breakpoints im Skript hinzufügen.

    Hinweis

    Derzeit unterstützen wir die Verwendung interner Cmdlets wie Get-AutomationVariable nur bei nicht verschlüsselten Ressourcen.

  • Arbeiten mit Zeitplänen, Objekten und Webhooks – Sie können die Eigenschaften eines Zeitplans, eines Löschplans, einen Linkzeitplan anzeigen, um einen Zeitplan mit einem Runbook zu verknüpfen.

  • Hinzufügen von Webhook – Sie können dem Runbook einen Webhook hinzufügen.

  • Aktualisieren von Eigenschaften von Objekten – Sie können Eigenschaften von Objekten wie Zertifikate, Verbindungen, Anmeldeinformationen, Variablen und Löschen von Objekten aus der Erweiterung erstellen, aktualisieren, anzeigen.

Begrenzungen

Die folgenden Funktionen werden nicht unterstützt:

  • Erstellung neuer Zeitpläne.
  • Hinzufügen neuer Zertifikate in „Ressourcen“.
  • Laden Sie Module (PowerShell und Python)-Pakete aus der Erweiterung hoch.
  • Automatische Synchronisierung lokaler Runbooks mit dem Azure Automation-Konto. Sie müssen den Vorgang zum Abrufen oder Veröffentlichen des Runbook ausführen.
  • Verwaltung von Hybridarbeitsgruppen.
  • Grafisches Runbook und Workflows.
  • Für Python stellen wir keine Debugoptionen bereit. Es wird empfohlen, jede Debuggererweiterung in Ihrem Python-Skript zu installieren.
  • Derzeit unterstützen wir nur die unverschlüsselten Objekte in der lokalen Ausführung.

Nächste Schritte