Modifier des runbooks textuels dans Azure Automation

  • Article

L’éditeur de texte dans Azure Automation permet de modifier des Runbooks PowerShell et des Runbooks de flux de travail PowerShell. Cet éditeur offre les caractéristiques standard des autres éditeurs de code, par exemple IntelliSense. Il utilise également un code couleur assorti de fonctionnalités spéciales supplémentaires pour vous aider à accéder à des ressources communes aux runbooks.

L’éditeur de texte inclut une fonctionnalité permettant d’insérer du code pour les cmdlets, les ressources et les runbooks enfants dans un runbook. Plutôt que de taper le code vous-même, vous pouvez sélectionner le code approprié dans la liste des ressources disponibles, et l’éditeur l’insère dans le runbook.

Dans Azure Automation, chaque runbook existe en deux versions : un brouillon et une version publiée. Vous devez modifier le brouillon du runbook, puis le publier afin qu’il puisse être exécuté. La version publiée ne peut pas être modifiée. Pour plus d’informations, consultez Publier un runbook.

Cet article fournit des instructions détaillées pour effectuer différentes fonctions avec cet éditeur. Elles ne s’appliquent pas aux runbooks graphiques. Pour utiliser ces runbooks, consultez Création de graphiques dans Azure Automation.

Important

N’incluez pas le mot clé « AzureRm » dans un script conçu pour être exécuté avec le module Az. L’inclusion de ce mot clé, même dans un commentaire, peut entraîner le chargement d’AzureRm, puis un conflit avec le module Az.

Pour modifier un runbook via le portail Azure

  1. Dans le portail Azure, sélectionnez votre compte Automation.
  2. Sous AUTOMATISATION DE PROCESSUS, cliquez sur Runbooks pour ouvrir la liste des runbooks.
  3. Choisissez le runbook à modifier, puis cliquez sur Modifier.
  4. Modifiez le runbook.
  5. Cliquez sur Enregistrer lorsque vos modifications sont terminées.
  6. Cliquez sur Publier si vous souhaitez que le dernier brouillon du runbook soit publié.

Insérer une applet de commande dans un runbook

  1. Dans le canevas de l’éditeur de texte, placez le curseur à l’emplacement où vous souhaitez placer l’applet de commande.
  2. Développez le nœud Applets de commande dans le contrôle Bibliothèque.
  3. Développez le module contenant l’applet de commande à utiliser.
  4. Cliquez avec le bouton droit sur le nom de la cmdlet à insérer, puis sélectionnez Ajouter au canevas. Si plusieurs jeux de paramètres sont définis pour l’applet de commande, l’éditeur ajoute le jeu par défaut. Vous pouvez également développer l’applet de commande pour sélectionner un jeu de paramètres différent.
  5. Notez que le code de l’applet de commande est inséré avec sa liste entière de paramètres.
  6. Indiquez une valeur appropriée à la place de la valeur entourée par des crochets (<>) pour tous les paramètres obligatoires. Supprimez les paramètres dont vous n’avez pas besoin.

Insérer du code pour un runbook enfant dans un runbook

  1. Dans le canevas de l’éditeur de texte, placez le curseur à l’emplacement où vous souhaitez placer le code pour le runbook enfant.
  2. Développez le nœud Runbooks dans le contrôle Bibliothèque.
  3. Cliquez avec le bouton droit sur le runbook à insérer, puis sélectionnez Ajouter au canevas.
  4. Le code du runbook enfant est inséré avec des espaces réservés pour les paramètres des runbooks.
  5. Remplacez les espaces réservés par des valeurs appropriées pour chaque paramètre.

Insérer une ressource dans un runbook

  1. Dans le contrôle Canevas de l’éditeur de texte, positionnez le curseur à l’emplacement où vous souhaitez placer le code pour le runbook enfant.
  2. Développez le nœud Ressources dans le contrôle Bibliothèque.
  3. Développez le nœud du type de ressource souhaité.
  4. Cliquez avec le bouton droit sur le nom de la ressource à insérer, puis sélectionnez Ajouter au canevas. Pour les ressources variables, sélectionnez Ajouter « Obtenir la variable » au canevas ou Ajouter « Définir la variable » au canevas selon que vous souhaitez obtenir ou définir la variable.
  5. Notez que le code de la ressource est inséré dans le runbook.

Modifier un runbook Azure Automation à l’aide de Windows PowerShell

Pour modifier un runbook avec Windows PowerShell, utilisez l’éditeur de votre choix et enregistrez le runbook dans un fichier .ps1. Vous pouvez utiliser l’applet de commande Export-AzAutomationRunbook pour récupérer le contenu du runbook. Vous pouvez utiliser la cmdlet Import-AzAutomationRunbook pour remplacer le brouillon de runbook existant par le runbook modifié.

Récupérer le contenu d’un runbook à l’aide de Windows PowerShell

Les exemples de commandes suivants montrent comment récupérer le script d’un runbook et l’enregistrer dans un fichier de script. Dans cet exemple, le brouillon est récupéré. Il est également possible de récupérer la version publiée du runbook, bien que cette version ne puisse pas être modifiée.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

Modifier le contenu d’un runbook à l’aide de Windows PowerShell

Les exemples de commandes suivants montrent comment remplacer le contenu existant d’un runbook par le contenu d’un fichier de script.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Étapes suivantes