Verwalten der Laufzeitumgebung und zugeordneter Runbooks

Führen Sie die folgenden Schritte aus, um eine Laufzeitumgebung zu erstellen:

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

2. Wählen Sie auf der Seite "Übersicht " die Option "Laufzeitumgebung testen" aus, wenn sie nicht bereits in der neuen Oberfläche enthalten ist.

3. Wählen Sie unter "Prozessautomatisierung" die Option "Laufzeitumgebungen" und dann "Erstellen" aus.

4. Geben Sie auf der Registerkarte Grundeinstellungen die folgenden Informationen ein:

   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.4
      • Für Python – wählen Sie 3.10

   4. Geben Sie die entsprechende Beschreibung ein.

      

5. 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.

   Hinweis

   Azure CLI-Befehle werden in Runbooks unterstützt, die der PowerShell 7.4-Laufzeitumgebung zugeordnet sind. Azure CLI-Befehle Version 2.64.0 sind als Standardpaket in powerShell 7.4-Runtime-Umgebung verfügbar.

6. 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-Runbooktypen, wie hier erwähnt.
   • Für Pakete von Python 3.10 verwenden Sie .whl-Dateien für das cp310 Linux-Betriebssystem.

7. 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 " können Sie die neu erstellte Laufzeitumgebung für Ihr Automatisierungskonto anzeigen. Wenn Sie die neu erstellten Laufzeitumgebungen nicht in der Liste finden, wählen Sie Aktualisieren aus.

Sie können eine neue Laufzeitumgebung für PowerShell 7.4 mit Az PowerShell-Modul in der Automatisierung erstellen.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.4" 
        }, 
        "defaultPackages": { 
            "Az": "12.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=2024-10-23

{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

Führen Sie den folgenden Schritt aus, um alle Laufzeitumgebungen aus dem Automatisierungskonto auflisten zu können:

1. Wählen Sie in Ihrem Automatisierungskonto unter "Prozessautomatisierung" die Option "Laufzeitumgebungen" aus.

   

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2024-10-23

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

1. Wählen Sie in Ihrem Automatisierungskonto unter "Prozessautomatisierung" die Option "Laufzeitumgebungen" 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.

   

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23

Führen Sie die folgenden Schritte aus, um eine Laufzeitumgebung zu aktualisieren:

1. Wählen Sie in Ihrem Automatisierungskonto unter "Prozessautomatisierung" die Option "Laufzeitumgebungen" 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 aus.

   

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.

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=2024-10-23
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "12.3.0" 

        } 

     } 

} 

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 die entsprechende Beschreibung ein.

      

   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.

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=2024-10-23

{ 
  "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"
} 

Führen Sie die folgenden Schritte aus, um ein Runbook zu aktualisieren:

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 "Update Runtime Environment" aus.

   

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.

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=2024-10-23
{ 
  "properties": { 
    "type": "PowerShell",
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Sie können Runbooks aktualisieren, indem Sie die mit diesem Runbook verknüpfte Laufzeitumgebung ändern. Es wird empfohlen, die Ausführung des Runbook 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 "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.

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=2024-10-23
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Sie können Runbooks ausführen, die sowohl in Azure als auch in Hybrid Worker mit Laufzeitumgebung verknüpft sind.

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=2024-10-23
{
  "properties": {
    "runbook": {
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
}