Ausführen von Azure-CLI-Befehlen in PowerShell-7.4-Runbooks

Sie können Azure CLI-Befehle in Runbooks ausführen, die mit der PowerShell 7.4-Laufzeitumgebung verknüpft sind.

Hinweis

Azure CLI-Befehle Version 2.64.0 sind als Standardpaket in powerShell 7.4-Runtime-Umgebung verfügbar.

Voraussetzungen

• Ein Azure Automation-Konto (in allen unterstützten öffentlichen Regionen mit Ausnahme von Brasilien Südost- und Gov-Clouds).

Laufzeitumgebung erstellen

Azure-Portal

Führen Sie die folgenden Schritte aus, um die Laufzeitumgebung im Azure-Portal 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 (Vorschau)und dann Erstellen aus.

4. Geben Sie auf der Registerkarte " Grundlagen " die folgenden Details an:

   1. Geben Sie den Namen für die Laufzeitumgebung ein. Er muss mit einem Buchstaben beginnen und darf nur Buchstaben, Zahlen, Unterstriche und Bindestriche enthalten.
   2. Wählen Sie in der Dropdownliste Sprache die Option PowerShell aus.
   3. Wählen Sie in der Laufzeitversion für die Skriptsprache 7.4
   4. Geben Sie die entsprechende Beschreibung ein.

5. Auf der Registerkarte "Pakete " in der Dropdownliste " Paketversion " würden Az Version 12.3.0 und Azure CLI, Version 2.64.0 , bereits vorhanden sein.

6. Wählen Sie + Aus Katalog hinzufügen aus, um weitere Pakete aus dem Katalog hinzuzufügen, und wählen Sie dann Weiter aus.

7. Überprüfen Sie auf der Registerkarte " Überprüfen+ Erstellen " die Einträge, und wählen Sie "Erstellen" aus.

   In einer Benachrichtigung wird bestätigt, dass eine Laufzeitumgebung erfolgreich erstellt wurde.

REST-API

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",
            "Azure CLI": "2.64.0"
        } 
     }, 
    "name": "<runtimeEnvironmentName>"
}

Runbook erstellen

Azure-Portal

Sie können ein neues PowerShell-Runbook erstellen, das Azure CLI-Befehle unterstützt und der PowerShell 7.4-Runtime-Umgebung zugeordnet ist.

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

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 zuvor erstellte PowerShell 7.4-Laufzeitumgebung aus.
   4. Geben Sie die entsprechende Beschreibung ein.

4. Fügen Sie Runbook-Code auf der Seite " Runbook bearbeiten" hinzu, und wählen Sie "Speichern" aus.

5. Testen Sie die Runbookausführung im Testbereich. Nachdem Sie die Ergebnisse bestätigt haben, wählen Sie Veröffentlichen aus, um das Runbook zu veröffentlichen und auszuführen.

REST-API

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

Nächste Schritte

• Weitere Informationen zum Ausführen der verschiedenen Vorgänge über das Portal und die REST-API finden Sie unter Verwalten der Laufzeitumgebung.