Verwalten der Laufzeitumgebung und verknüpfter Runbooks

Dieser Artikel enthält Informationen zum Erstellen einer Laufzeitumgebung und zum Ausführen verschiedener Vorgänge über das Azure-Portal und die REST-API.

Voraussetzungen

Ein Azure Automation-Konto in der unterstützten öffentlichen Region (außer „Indien, Mitte“, „Deutschland, Norden“, Italien, Norden“, „Israel, Mitte“, „Polen, Mitte“, „VAE, Mitte“ und Government-Clouds).

Wechseln zwischen der Laufzeitumgebung und der alten Erfahrung

Laufzeitumgebungserfahrung

1. Wählen Sie Übersicht und dann Laufzeitumgebungserfahrung ausprobieren aus.

   

2. Unter Prozessautomatisierung sehen Sie die Option Laufzeitumgebungen (Vorschau), und die Optionen Module und Python-Pakete unter Freigegebene Ressourcen werden entfernt, da die Laufzeitumgebung die Verwaltung von Paketen ermöglicht, die während der Ausführung von Runbooks erforderlich sind.

   

3. Wenn Sie zur alten Erfahrung für die Verwaltung von Modulen und Paketen zurückkehren möchten, wählen Sie im linken Bereich Übersicht und dann Zur alten Erfahrung wechseln aus.

   

Alte Erfahrung

1. Wechseln Sie zu Ihrem Azure Automation-Konto. Unter Prozessautomatisierung ist die Option Laufzeitumgebungen (Vorschau) entfernt, und unter Freigegebene Ressourcen werden die Optionen Module und Python-Pakete angezeigt.

   

Hinweis

Runbook-Updates bleiben zwischen der neuen Runtime-Umgebung und der alten Umgebung erhalten. Alle Änderungen, die in der mit einem Runbook verknüpften Laufzeitumgebung vorgenommen wurden, würden während der Ausführung des Runbooks in der alten Erfahrung bestehen bleiben.

Laufzeitumgebung verwalten

Laufzeitumgebung erstellen

Azure portal

1. Melden Sie sich beim Azure-Portal an, und wählen Sie Ihr Azure Automation-Konto aus.

2. Wählen Sie unter Prozessautomatisierung die Option Laufzeitumgebungen (Vorschau)und dann Erstellen aus.

3. Geben Sie unter Grundlagen die folgenden Details an:

   1. Name für die Laufzeitumgebung. Er muss mit einem Buchstaben beginnen und darf nur Buchstaben, Zahlen, Unterstriche und Bindestriche enthalten.

   2. Wählen Sie in der Dropdownliste Sprache aus, und wählen Sie die Skriptsprache für die Laufzeitumgebung aus.

      • Wählen Sie PowerShell für die PowerShell-Skriptsprache oder Python für Python-Skriptsprache aus.

   3. Wählen Sie die Laufzeitversion für die Skriptsprache aus.

      • Für PowerShell – wählen Sie 5.1, 7.2
      • Für Python – wählen Sie 3.8, 3.10 (Vorschau)

   4. Geben Sie eine entsprechende Beschreibung an.

      

4. Wählen Sie Weiter aus, und laden Sie auf der Registerkarte Pakete die während der Ausführung des Runbooks erforderlichen Pakete hoch. Das Az PowerShell-Paket wird standardmäßig für alle PowerShell-Laufzeitumgebungen hochgeladen und enthält alle Cmdlets zum Verwalten von Azure-Ressourcen. Sie können die Version des Az-Pakets aus der Dropdownliste auswählen. Wählen Sie Keine aus, wenn das Paket während der Ausführung des Runbooks nicht hochgeladen werden soll.

   

   Hinweis

   Azure CLI-Befehle werden in Runbooks, die mit der PowerShell 7.2-Laufzeitumgebung verbunden sind, unterstützt (Vorschau). Azure CLI-Befehle der Version 2.56.0 sind als Standardpaket in der PowerShell 7.2-Laufzeitumgebung verfügbar.

5. So laden Sie weitere Pakete hoch, die während der Ausführung des Runbooks erforderlich sind. Wählen Sie Datei hinzufügen aus, um die lokal auf Ihrem Computer gespeicherte(n) Datei(en) hinzuzufügen, oder wählen Sie Aus Katalog hinzufügen aus, um Pakete aus dem PowerShell-Katalog hochzuladen.

   

   Hinweis

   • Wenn Sie ein Paket importieren, kann es mehrere Minuten dauern. 100 MB ist die maximale Gesamtgröße der Dateien, die Sie importieren können.
   • Verwenden Sie .zip-Dateien für PowerShell-Laufzeittypen, wie hier erwähnt
   • Verwenden Sie für Python 3.8-Pakete .whl-Dateien für cp38-amd64.
   • Verwenden Sie für Python 3.10 (Vorschau)-Pakete .whl-Dateien für das cp310 Linux-Betriebssystem.

6. Wählen Sie Weiter aus, und überprüfen Sie auf der Registerkarte Überprüfen+ Erstellen, ob die Einstellungen korrekt sind. Wenn Sie Erstellen auswählen, führt Azure die Überprüfung der von Ihnen ausgewählten Laufzeitumgebungseinstellungen aus. Wenn die Überprüfung bestanden wird, können Sie mit der Erstellung der Laufzeitumgebung fortfahren, anderenfalls weist das Portal auf die Einstellungen hin, die Sie ändern müssen.

Auf der Seite Laufzeitumgebungen (Vorschau) können Sie die neu erstellte Laufzeitumgebung für Ihr Azure Automation-Konto anzeigen. Wenn Sie die neu erstellten Laufzeitumgebungen nicht in der Liste finden, wählen Sie Aktualisieren aus.

REST-API

Sie können eine neue Laufzeitumgebung für PowerShell 7.2 mit dem Az PowerShell-Modul in Azure Automation erstellen

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.2" 
        }, 
        "defaultPackages": { 
            "Az": "7.3.0" 
        } 
     }, 
    "name": "<runtimeEnvironmentName>" 
} 

Laden Sie ein Paket „Az.Accounts“ in die Laufzeitumgebung hoch.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

Laufzeitumgebung anzeigen

Rufen Sie die Eigenschaften der Laufzeitumgebung aus dem Azure Automation-Konto ab.

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

Auflisten von Laufzeitumgebungen

So listen Sie alle Laufzeitumgebungen aus dem Azure Automation-Konto auf:

Azure portal

1. Wählen Sie in Ihrem Azure Automation-Konto unter Prozessautomatisierung die Option Laufzeitumgebungen (Vorschau) aus.

   

REST-API

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2023-05-15-preview 

Anzeigen von Komponenten des Az PowerShell-Pakets

Um alle Komponentenpakete des Az PowerShell-Pakets anzuzeigen, führen Sie das Cmdlet Get-Module -ListAvailable in einem PowerShell-Runbook aus.

Die Auftragsausgabe würde alle Komponentenpakete und deren Versionen anzeigen.

Laufzeitumgebung löschen

Führen Sie diese Schritte aus, um die Laufzeitumgebung aus dem Azure Automation-Konto zu löschen:

Azure portal

1. Wählen Sie in Ihrem Azure Automation-Konto unter Prozessautomatisierung die Option Laufzeitumgebungen (Vorschau) aus.

2. Wählen Sie die Laufzeitumgebung aus, die Sie löschen möchten.

3. Wählen Sie Löschen aus, um die Laufzeitumgebung zu löschen.

   

REST-API

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

Laufzeitumgebung aktualisieren

Laufzeitsprache und Laufzeitversion sind unveränderliche Eigenschaften. Sie können jedoch die Version von Modulen aktualisieren und Pakete in der Laufzeitumgebung hinzufügen oder entfernen. Runbooks, die mit der Laufzeitumgebung verknüpft sind, werden automatisch mit den neuen Einstellungen aktualisiert.

Azure portal

1. Wählen Sie in Ihrem Azure Automation-Konto unter Prozessautomatisierung die Option Laufzeitumgebungen (Vorschau) aus.

2. Wählen Sie die Laufzeitumgebung aus, die Sie aktualisieren möchten.

3. Wählen Sie die Version aus der Dropdownliste aus, um die Version vorhandener Pakete zu aktualisieren.

4. Wählen Sie Speichern.

   

5. Wählen Sie Datei hinzufügen aus, um Pakete von Ihrem lokalen Computer hochzuladen, oder Aus Katalog hinzufügen, um Pakete aus dem PowerShell-Katalog hochzuladen.

   

   Hinweis

   Sie können bis zu 10 Pakete gleichzeitig zur Laufzeitumgebung hinzufügen. Stellen Sie sicher, dass Sie nach dem Hinzufügen von 10 Paketen speichern.

REST-API

Aktualisieren Sie die Az-Modulversion einer vorhandenen Laufzeitumgebung:

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "9.0.0" 

        } 

     } 

} 

Verwalten von Runbooks, die mit der Laufzeitumgebung verknüpft sind

Erstellen eines Runbooks

Sie können ein neues PowerShell-Runbook erstellen, das mit der Laufzeitumgebung konfiguriert wird.

Azure portal

Voraussetzung

• Stellen Sie sicher, dass Sie eine Laufzeitumgebung erstellt haben, bevor Sie ein Runbook erstellen.

Führen Sie diese Schritte aus, um ein neues Runbook zu erstellen, das mit der Laufzeitumgebung verknüpft ist:

1. Wählen Sie in Ihrem Automation-Konto unter Prozessautomatisierung die Option Runbooks aus.

2. Klicken Sie auf Erstellen.

3. Auf der Registerkarte Grundlagen können Sie entweder ein neues Runbook erstellen oder eine Datei von Ihrem lokalen Computer oder aus dem PowerShell-Katalog hochladen.

   1. Geben Sie einen Namen für das Runbook ein. Er muss mit einem Buchstaben beginnen und darf nur Buchstaben, Zahlen, Unterstriche und Gedankenstriche enthalten.

   2. Wählen Sie im Dropdownmenü Runbook-Typ den Typ des Runbooks aus, das Sie erstellen möchten.

   3. Wählen Sie die Laufzeitumgebung aus, die für das Runbook konfiguriert werden soll. Sie können entweder aus vorhandenen Laufzeitumgebungen auswählen oder neue Laufzeitumgebung erstellen und mit dem Runbook verknüpfen. Die Liste der Laufzeitumgebungen wird basierend auf dem in Schritt b ausgewählten Runbook-Typ aufgefüllt.

   4. Geben Sie eine entsprechende Beschreibung an.

      

   Hinweis

   Für den Typ PowerShell-Runbook würde nur die PowerShell-Laufzeitumgebung zur Auswahl aufgelistet. Für den Typ Python-Runbook würden nur die Python-Laufzeitumgebungen zur Auswahl aufgelistet.

4. Fügen Sie dem Runbook Tags hinzu, überprüfen Sie die Einstellungen, und wählen Sie Erstellen aus, um ein neues Runbook zu erstellen.

Dieses Runbook ist mit der ausgewählten Laufzeitumgebung verknüpft. Alle Pakete in der ausgewählten Laufzeitumgebung wären während der Ausführung des Runbook verfügbar.

REST-API

Voraussetzung

• Konfigurieren Sie eine PowerShell-Laufzeitumgebung, und stellen Sie diese als Eingabe für die Erstellung des Runbooks bereit.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
} 

Hinweis

Ähnliche APIs funktionieren auch für den Typ Python-Runbook.

Runbook aktualisieren

Sie können das Runbook aktualisieren, indem Sie die Laufzeitumgebung ändern, die mit dem Runbook verknüpft ist. Sie können einzelne oder mehrere Runbooks zum Aktualisieren auswählen. Ein Runbook im Ausführungsstatus wäre durch das Ändern der mit diesem Runbook verknüpften Laufzeitumgebung nicht betroffen.

Azure portal

1. Wählen Sie in Ihrem Automation-Konto unter Prozessautomatisierung die Option Runbooks aus.

2. Aktivieren Sie das Kontrollkästchen für alle Runbooks, die Sie aktualisieren möchten.

3. Wählen Sie Aktualisieren.

4. Wählen Sie die Laufzeitumgebung aus der Dropdownliste aus, mit der Sie die Runbooks verknüpfen möchten.

5. Wählen Sie Aktualisieren aus, um die ausgewählten Runbooks mit der neuen Laufzeitumgebung zu aktualisieren.

Überprüfen Sie, ob das Runbook nach dem Update wie erwartet ausgeführt wird. Wenn das Runbook nicht das erwartete Ergebnis liefert, können Sie die Laufzeitumgebung erneut auf die alte Erfahrung aktualisieren, indem Sie die Schritte 1–4 ausführen.

Hinweis

Runbook-Updates bleiben zwischen der neuen Runtime-Umgebung und der alten Umgebung erhalten. Alle Änderungen, die in der Laufzeitumgebung vorgenommen werden, die mit einem Runbook verknüpft ist, bleiben während der Ausführung des Runbooks in der alten Oberfläche erhalten.

REST-API

Aktualisieren Sie die Laufzeitumgebung, die mit einem Runbook verknüpft ist.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "type": "PowerShell" 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Hinweis

Die Aufrufe „Anzeigen/Löschen“ für ein Runbook bleiben unverändert und können auf Runbook – REST-API Azure Automation | Microsoft Learn referenziert werden.

Testen der Runbook-Aktualisierung

Führen Sie einen Testauftrag für ein Runbook mit einer anderen Laufzeitumgebung aus. Dieses Szenario ist nützlich, wenn ein Runbook vor der Aktualisierung mit einer Laufzeitumgebung getestet werden muss.

Azure portal

Sie können Runbooks aktualisieren, indem Sie die mit diesem Runbook verknüpfte Laufzeitumgebung ändern. Wir empfehlen Ihnen, die Ausführung des Runbooks vor dem Veröffentlichen der Änderungen zu testen. Dadurch wird sichergestellt, dass das Runbook erwartungsgemäß funktioniert.

Führen Sie diese Schritte aus, um die Ausführung des Runbook vor der Veröffentlichung von Änderungen an der Laufzeitumgebung zu testen:

1. Wechseln Sie zur Seite Runbooks, und wählen Sie das Runbook aus, für das Sie die Laufzeitumgebung aktualisieren möchten.

   

2. Wählen Sie auf der Seite Runbook bearbeiten die Option Im Portal bearbeiten aus, um den Text-Editor zu öffnen.

3. Das Feld „Laufzeitumgebung“ zeigt die vorhandene Konfiguration an. Wählen Sie die neue Laufzeitumgebung aus der Dropdownliste aus.

   

4. Wählen Sie Testbereich aus, um die Ausführung des Runbooks mit der aktualisierten Laufzeitumgebung zu testen. Wählen Sie Starten aus, um die Testausführung zu starten.

5. Schließen Sie den Testbereich, und nehmen Sie die erforderlichen Änderungen im Runbook-Code oder in der Laufzeitumgebung vor, falls notwendig.

6. Wählen Sie Veröffentlichen aus, um die mit dem Runbook verknüpfte Laufzeitumgebung zu aktualisieren.

7. Wählen Sie Ja aus, um die zuvor veröffentlichte Version zu überschreiben und die Änderungen zu bestätigen.

REST-API

Führen Sie einen Testauftrag für ein Runbook mit einer anderen Laufzeitumgebung aus. Dieses Szenario ist nützlich, wenn ein Runbook vor der Aktualisierung mit einer Laufzeitumgebung getestet werden muss.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>/draft/testJob?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Cloudauftrag erstellen

Azure portal

Derzeit würden Runbooks, die mit der Laufzeitumgebung verknüpft sind, auf Azure ausgeführt.

REST-API

Aufträge erben die Laufzeitumgebung vom Runbook. Führen Sie einen Cloudauftrag für ein veröffentlichtes Runbook aus:

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/jobs/<jobName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runbook": { 
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
} 

Hinweis

Die Aufrufe „Erstellen/Anzeigen“ für einen Auftrag bleiben unverändert und können auf Auftrags-REST API (Azure Automation) | Microsoft Learn referenziert werden.

Verknüpfen vorhandener Runbooks mit vom System generierten Laufzeitumgebungen

Alle vorhandenen Runbooks in Ihrem Azure Automation-Konto würden automatisch mit vom System generierten Laufzeitumgebungen verknüpft. Diese vom System generierten Laufzeitumgebungen werden basierend auf der Laufzeitsprache, der Version und Modulen/Paketen erstellt, die in Ihrem jeweiligen Azure Automation-Konto vorhanden sind. Weitere Informationen Um vorhandene Runbooks zu aktualisieren, ändern Sie die Laufzeitumgebung, indem Sie die hier erwähnten Schritte ausführen.

Nächste Schritte

• Für eine Übersicht wählen Sie Laufzeitumgebung.
• Informationen zum Behandeln von Problemen bei der Runbookausführung finden Sie unter Beheben von Runbookproblemen.