Share via

  • Article

Modification d'un Runbook

 

Publication: juin 2016

S'applique à: Windows Azure Pack for Windows Server

Chaque Runbook dans Service Management Automation existe en deux versions : brouillon et publiée. Vous modifiez la version brouillon du flux de travail, puis vous la publiez pour permettre son exécution. La version publiée ne peut pas être modifiée.

Pour modifier un Runbook à l'aide du Portail de gestion

Le Portail de gestion inclut un éditeur qui vous permet d'afficher et de modifier les Runbooks. En plus des fonctionnalités de base en matière d'édition de texte, l'éditeur permet d'insérer automatiquement du code pour les ressources globales, les activités et les Runbooks.

  1. Dans le portail de gestion, sélectionnez Automation.

  2. Sélectionnez l'onglet Runbooks.

  3. Cliquez sur le nom du Runbook que vous souhaitez modifier.

  4. Sélectionnez l'onglet Auteur.

  5. Cliquez sur Brouillon en haut de l'écran, ou sur le bouton Modifier au bas de l'écran.

  6. Effectuez les modifications nécessaires.

  7. Cliquez sur Enregistrer quand vos modifications sont terminées.

  8. Cliquez sur Publier si vous souhaitez que la dernière version du Runbook soit publiée.

Insertion de code dans un Runbook

L'éditeur Automation inclut une fonctionnalité qui permet d'insérer du code relatif aux activités, aux paramètres et aux Runbooks dans un Runbook. Plutôt que de taper le code vous-même, vous pouvez sélectionner des éléments dans une liste de ressources disponibles, et insérer le code approprié dans le Runbook.

Pour insérer du code de Runbook dans un Runbook

  1. Ouvrez le Runbook dans l'éditeur du Portail de gestion.

  2. Au bas de l'écran, cliquez sur Insérer, puis sur Runbook.

  3. Sélectionnez le Runbook à insérer dans la colonne centrale, puis cliquez sur la flèche droite.

  4. Si le Runbook comporte des paramètres, ils sont répertoriés à titre d'information.

  5. Cliquez sur le bouton de vérification.

  6. Le code d'exécution du Runbook sélectionné est inséré dans le Runbook actif.

  7. Si le Runbook nécessite des paramètres, indiquez la valeur appropriée à la place du type de données placé entre crochets <>.

Pour insérer une ressource globale dans un Runbook

  1. Ouvrez le Runbook dans l'éditeur du Portail de gestion.

  2. Au bas de l'écran, cliquez sur Insérer, puis sur Paramètre.

  3. Dans la colonne Action du paramètre, sélectionnez le type de code dont vous avez besoin.

  4. Dans la colonne centrale, sélectionnez les éléments appropriés parmi les ressources disponibles.

  5. Cliquez sur le bouton de vérification.

Pour insérer une activité dans un Runbook

  1. Ouvrez le Runbook dans l'éditeur du Portail de gestion.

  2. Au bas de l'écran, cliquez sur Insérer, puis sur Activité.

  3. Dans la colonne Module d'intégration, sélectionnez le module qui contient l'activité.

  4. Dans le volet Activité, sélectionnez une activité.

  5. Dans la colonne Description, notez la description de l'activité. Si vous le souhaitez, vous pouvez cliquer sur Voir l'aide détaillée pour lancer l'aide relative à l'activité dans le navigateur.

  6. Cliquez sur la flèche droite.

  7. Si l'activité comporte des paramètres, ils sont répertoriés à titre d'information.

  8. Cliquez sur le bouton de vérification.

  9. Le code d'exécution de l'activité est inséré dans le Runbook.

  10. Si l'activité nécessite des paramètres, indiquez la valeur appropriée à la place du type de données placé entre crochets <>.

Pour modifier un Runbook Automation à l'aide de Windows PowerShell

Pour modifier un Runbook avec Windows PowerShell, modifiez le flux de travail à l'aide de l'éditeur de votre choix, puis enregistrez-le dans un fichier .ps1. Vous pouvez utiliser l'applet de commande Get-SMARunbookDefinition pour récupérer le contenu du Runbook, puis l'applet de commande Edit-SMARunbook pour remplacer la version brouillon du flux de travail par la version modifiée.

Pour créer un Runbook à partir du contenu d'un fichier de script, consultez d14db796-a3e5-4b1d-a098-e734ceae2e0e#ImportRunbookScriptPS.

Pour 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, la version brouillon est récupérée. Il est également possible de récupérer la version publiée du Runbook, bien que cette dernière ne puisse pas être changée.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

$runbookDefinition = Get-SMARunbookDefinition –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Type Draft
$runbookContent = $runbookDefinition.Content

Out-File -InputObject $runbookContent -FilePath $scriptPath

Pour changer 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 contenant un flux de travail.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

Edit-SmaRunbook –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Path $scriptPath -Overwrite
Publish-SmaRunbook –WebServiceEndpoint $webServer –Port $port –Name $runbookName –Path $scriptPath