Exécuter des commandes Azure CLI dans des runbooks PowerShell 7.2

Vous pouvez exécuter des commandes Azure CLI dans des runbooks liés à l’environnement runtime PowerShell 7.2.

Remarque

Les commandes Azure CLI version 2.56.0 sont disponibles en tant que package par défaut dans l’environnement runtime PowerShell 7.2.

Prérequis

• Un compte Azure Automation (dans toutes les régions publiques prises en charge, à l’exception de l’Inde centrale, de l’Allemagne Nord, de l’Italie Nord, d’Israël Centre, de Pologne Centre, des Émirats arabes unis Centre et des clouds gouvernementaux).

Créer un environnement runtime

Remarque

Au lieu de créer un environnement d’exécution PowerShell 7.2, vous pouvez utiliser l’environnement d’exécution PowerShell 7.2 généré par le système.

Azure portal

1. Connectez-vous au portail Azure et sélectionnez votre compte Automation.

2. Sous Process Automation, sélectionnez Environnements d’exécution (préversion), puis sélectionnez Créer.

3. Sous l’onglet Informations de base , fournissez les détails suivants :

   1. Indiquez le nom de l’environnement runtime. Il doit commencer par l’alphabet et ne peut contenir que des alphabets, des nombres, des traits de soulignement et des tirets.
   2. Dans la liste déroulante Langue , sélectionnez PowerShell.
   3. Dans la version runtime pour le langage de script, sélectionnez 7.2
   4. Fournissez la description appropriée.

4. Sous l’onglet Packages , dans la liste déroulante Version du package, vous verrez Az version 8.3 et Azure CLI version 2.56.0 déjà présentes.

5. Sélectionnez +Ajouter à partir de la galerie pour ajouter d’autres packages à partir de la galerie, puis sélectionnez Suivant.

6. Sous l’onglet Vérifier + créer , passez en revue les entrées et sélectionnez Créer.

   Une notification s’affiche pour confirmer qu’un environnement runtime est correctement créé.

   

REST API

Azure CLI version 2.56.0 est disponible uniquement pour l’environnement runtime PowerShell 7.2.

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

Créer un runbook

Azure portal

Vous pouvez créer un runbook PowerShell qui prend en charge les commandes Azure CLI et qui est associé à l’environnement runtime PowerShell 7.2.

Pour créer un runbook, procédez comme suit :

Dans votre compte Automation, sous Process Automation, sélectionnez Runbooks.

1. Sélectionnez Créer.

2. Sous l’onglet Informations de base , vous pouvez créer un runbook ou charger un fichier à partir de votre ordinateur local ou à partir de PowerShell Gallery.

   1. Indiquez un nom pour le runbook. Elle doit commencer par une lettre et ne peut contenir que des lettres, des chiffres, des traits de soulignement et des tirets.

   2. Dans la liste déroulante type de Runbook , sélectionnez le type de runbook que vous souhaitez créer.

   3. Sélectionnez l’environnement runtime PowerShell 7.2 créé précédemment.

   4. Fournissez la description appropriée.

      

3. Ajoutez du code de runbook dans la page Modifier le Runbook, puis sélectionnez Enregistrer.

4. Tester l’exécution du runbook dans le volet Test. Après avoir confirmé les résultats, sélectionnez Publier pour publier le runbook et l’exécuter.

REST API

Vous pouvez créer des runbooks et établir un lien avec l’environnement runtime PowerShell 7.2.

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

Étapes suivantes

• Consultez Gérer l’environnement runtime pour afficher les différentes opérations via le portail et l’API REST.