Galeries de runbooks et de modules pour Azure AutomationRunbook and module galleries for Azure Automation

Au lieu de créer vos propres runbooks et modules dans Azure Automation, vous pouvez accéder à un large éventail de scénarios déjà générés par Microsoft et la communauté.Rather than creating your own runbooks and modules in Azure Automation, you can access a variety of scenarios that have already been built by Microsoft and the community. Vous pouvez utiliser ces scénarios sans les modifier ou les utiliser comme point de départ, puis les modifier selon vos besoins spécifiques.You can either use these scenarios without modification or you can use them as a starting point and edit them for your specific requirements.

Vous pouvez obtenir des runbooks à partir de la galerie de runbooks et des modules à partir de la PowerShell Gallery.You can get runbooks from the Runbook Gallery and modules from the PowerShell Gallery. Vous pouvez également contribuer à la communauté en partageant les scénarios que vous développez.You can also contribute to the community by sharing scenarios that you develop.

La galerie de runbooks fournit un éventail de runbooks de Microsoft et de la communauté que vous pouvez importer dans Azure Automation.The Runbook Gallery provides a variety of runbooks from Microsoft and the community that you can import into Azure Automation. Vous pouvez télécharger un runbook à partir de la galerie qui est hébergée dans le Centre de scripts TechNet, ou vous pouvez importer directement les runbooks depuis la galerie, à partir du portail Azure Classic ou du portail Azure.You can either download a runbook from the gallery, which is hosted in the TechNet Script Center, or you can directly import runbooks from the gallery from either the Azure classic portal or Azure portal.

Vous pouvez uniquement importer directement à partir de la galerie de runbooks à l’aide du portail Azure Classic ou du portail Azure.You can only import directly from the Runbook Gallery using the Azure classic portal or Azure portal. Vous ne pouvez pas exécuter cette fonction à l’aide de Windows PowerShell.You cannot perform this function using Windows PowerShell.

Note

Vous devez valider le contenu de tous les runbooks que vous obtenez de la galerie de runbooks et vous montrer très vigilant lors de leur installation et de leur exécution dans un environnement de production. |You should validate the contents of any runbooks that you get from the Runbook Gallery and use extreme caution in installing and running them in a production environment.|

  1. Dans le portail Azure, cliquez sur Nouveau, Services d’application, Automation, Runbook, À partir de la galerie.In the Azure portal, click, New, App Services, Automation, Runbook, From Gallery.
  2. Sélectionnez une catégorie pour afficher les runbooks associés, puis sélectionnez un runbook pour afficher les informations le concernant.Select a category to view related runbooks, and select a runbook to view its details. Une fois que vous avez sélectionné le runbook souhaité, cliquez sur la flèche droite.When you select the runbook you want, click the right arrow button.

    galerie de runbooks

  3. Passez en revue le contenu du runbook et prenez note des conditions requises dans la description.Review the contents of the runbook and note any requirements in the description. Cliquez sur la flèche droite lorsque vous avez terminé.Click the right arrow button when you’re done.
  4. Entrez les détails du runbook, puis cliquez sur la coche.Enter the runbook details and then click the checkmark button. Le nom du runbook est déjà renseigné.The runbook name is already filled in.
  5. Ce runbook apparaît sur l’onglet Runbooks du compte Automation.The runbook appears on the Runbooks tab for the Automation Account.
  1. Dans le portail Azure, ouvrez votre compte Automation.In the Azure portal, open your Automation account.
  2. Cliquez sur la vignette Runbooks pour ouvrir la liste des runbooks.Click on the Runbooks tile to open the list of runbooks.
  3. Cliquez sur le bouton Parcourir la galerie .Click Browse gallery button.

    Bouton Parcourir la galerie

  4. Recherchez l’élément de la galerie qui vous intéresse et sélectionnez-le pour afficher les informations le concernant.Locate the gallery item you want and select it to view its details.

    Parcourir la galerie

  5. Cliquez sur Afficher le projet source pour afficher l’élément dans le Centre de scripts TechNet.Click on View source project to view the item in the TechNet Script Center.
  6. Pour importer un élément, cliquez dessus pour afficher les informations le concernant, puis cliquez sur le bouton Importer .To import an item, click on it to view its details and then click the Import button.

    Bouton Importer

  7. Vous pouvez également modifier le nom du runbook, puis cliquer sur OK pour importer le runbook.Optionally, change the name of the runbook and then click OK to import the runbook.
  8. Ce runbook apparaît sur l’onglet Runbooks du compte Automation.The runbook appears on the Runbooks tab for the Automation Account.

Microsoft vous invite à ajouter à la galerie de runbooks des runbooks dont vous pensez qu’ils pourraient être utiles à d’autres utilisateurs.Microsoft encourages you to add runbooks to the Runbook Gallery that you think would be useful to other customers. Vous pouvez ajouter un runbook en le téléchargeant vers le Centre de scripts en tenant compte des informations suivantes.You can add a runbook by uploading it to the Script Center taking into account the following details.

  • Vous devez spécifier Windows Azure comme Catégorie et Automation comme Sous-catégorie pour le runbook à afficher dans l’Assistant.You must specify Windows Azure for the Category and Automation for the Subcategory for the runbook to be displayed in the wizard.
  • Le téléchargement doit être un seul fichier .ps1 ou .graphrunbook.The upload must be a single .ps1 or .graphrunbook file. Si le runbook nécessite des modules, des runbooks enfants ou des ressources, vous devez répertorier ceux figurant dans la description de l’envoi et dans la section commentaires du runbook.If the runbook requires any modules, child runbooks, or assets, then you should list those in the description of the submission and in the comments section of the runbook. Si vous disposez d’un scénario nécessitant plusieurs runbooks, téléchargez-les séparément et répertoriez les noms des runbooks associés dans chacune de leurs descriptions.If you have a scenario requiring multiple runbooks, then upload each separately and list the names of the related runbooks in each of their descriptions. Assurez-vous que vous utilisez les mêmes balises afin qu’elles s’affichent dans la même catégorie.Make sure that you use the same tags so that they show up in the same category. Un utilisateur doit lire la description pour savoir que les autres runbooks sont requis pour que le scénario fonctionne.A user will have to read the description to know that other runbooks are required the scenario to work.
  • Ajoutez la balise « GraphicalPS » si vous publiez un Runbook graphique (et non un workflow graphique).Add the tag "GraphicalPS" if you are publishing a Graphical runbook (not a Graphical Workflow).
  • Insérer un extrait de code PowerShell ou PowerShell Workflow dans la description à l’aide de l’icône Insérer la section de code .Insert either a PowerShell or PowerShell Workflow code snippet into the description using Insert code section icon.
  • Le résumé du chargement s’affiche dans les résultats de la galerie de runbooks. Vous devez donc fournir des informations détaillées qui aideront un utilisateur à identifier la fonctionnalité du runbook.The Summary for the upload is displayed in the Runbook Gallery results so you should provide detailed information that helps a user identify the functionality of the runbook.
  • Vous devez attribuer une à trois des balises suivantes pour le téléchargement.You should assign one to three of the following Tags to the upload. Le runbook est répertorié dans l’Assistant sous les catégories qui correspondent à ses balises.The runbook is listed in the wizard under the categories that match its tags. Toutes les balises ne figurant pas sur cette liste sont ignorées par l’Assistant.Any tags not on this list are ignored by the wizard. Si vous ne spécifiez pas les balises correspondantes, le runbook est répertorié dans la catégorie Autre.If you don’t specify any matching tags, the runbook is listed under the Other category.

    • SauvegardeBackup
    • Gestion de la capacitéCapacity Management
    • Contrôle des modificationsChange Control
    • ConformitéCompliance
    • Environnements de développement / testDev / Test Environments
    • Récupération d’urgenceDisaster Recovery
    • AnalyseMonitoring
    • Application de correctifsPatching
    • ApprovisionnementProvisioning
    • CorrectionRemediation
    • Gestion du cycle de vie des machines virtuellesVM Lifecycle Management
  • Automation met à jour la galerie toutes les heures, donc vous ne verrez pas vos contributions immédiatement.Automation updates the Gallery once an hour, so you won’t see your contributions immediately.

Les modules PowerShell contiennent des applets de commande que vous pouvez utiliser dans vos runbooks ; des modules existants que vous pouvez installer dans Azure Automation sont disponibles dans PowerShell Gallery.PowerShell modules contain cmdlets that you can use in your runbooks, and existing modules that you can install in Azure Automation are available in the PowerShell Gallery. Vous pouvez lancer cette galerie à partir du portail Azure et les installer directement dans Azure Automation, ou vous pouvez les télécharger et les installer manuellement.You can launch this gallery from the Azure portal and install them directly into Azure Automation or you can download them and install them manually. Vous ne pouvez pas installer les modules directement depuis le portail Azure Classic, mais vous pouvez les télécharger et les installer comme vous le feriez avec tout autre module.You cannot install the modules directly from the Azure classic portal, but you can download them install them as you would any other module.

  1. Dans le portail Azure, ouvrez votre compte Automation.In the Azure portal, open your Automation account.
  2. Sélectionnez Modules sous Ressources partagées pour ouvrir la liste des modules.Select Modules under Shared Resources to open the list of modules.
  3. Cliquez sur Parcourir la galerie, en haut de la page.Click Browse gallery from the top of the page.

    Galerie du module

  4. Sur la page Parcourir la galerie, vous pouvez effectuer des recherches en fonction des champs suivants :On the Browse gallery page, you can search by the following fields:

    • Nom du moduleModule Name
    • TagsTags
    • AuteurAuthor
    • Nom Applet de commande/Ressource DSCCmdlet/DSC resource name
  5. Recherchez un module qui vous intéresse et sélectionnez-le pour en afficher les détails.Locate a module that you're interested in and select it to view its details.
    Lorsque vous explorez un module spécifique, vous pouvez afficher plus d’informations le concernant, y compris un lien vers PowerShell Gallery, les dépendances requises et toutes les applets de commande et/ou les ressources DSC que contient le module.When you drill into a specific module, you can view more information about the module, including a link back to the PowerShell Gallery, any required dependencies, and all of the cmdlets and/or DSC resources that the module contains.

    Détails du module PowerShell

  6. Pour installer le module directement dans Azure Automation, cliquez sur le bouton Importer .To install the module directly into Azure Automation, click the Import button.

    Bouton Importer le module

  7. Lorsque vous cliquez sur le bouton Importer du volet Importer, le nom du module que vous êtes sur le point d’importer s’affiche.When you click the Import button, on the Import pane, you see the module name that you are about to import. Si toutes les dépendances sont installées, le bouton OK est activé.If all the dependencies are installed, the OK button is activated. S'il manque des dépendances, vous devrez les importer avant de pouvoir importer ce module.If you are missing dependencies, you need to import those before you can import this module.
  8. Cliquez sur OK pour importer le module.Click OK to import the module. Quand il importe un module dans votre compte, le logiciel Azure Automation extrait les métadonnées sur le module et les cmdlets.While Azure Automation imports a module to your account, it extracts metadata about the module and the cmdlets.

    Page Importer le module

    Cette opération peut prendre quelques minutes, car chaque activité doit être extraite.This may take a couple of minutes since each activity needs to be extracted.

  9. Vous recevez une première notification indiquant que le module est en cours de déploiement, puis une autre, signalant que le processus est terminé.You receive an initial notification that the module is being deployed and another notification when it has completed.
  10. Une fois le module importé, les activités disponibles s’affichent ; vous pouvez en utiliser les ressources dans vos runbooks et la Configuration d’état souhaité.After the module is imported, you can see the available activities, and you can use its resources in your runbooks and Desired State Configuration.

Demande d’un runbook ou d’un moduleRequesting a runbook or module

Vous pouvez envoyer des demandes à User Voice.You can send requests to User Voice. Si vous avez besoin d’aide pour écrire un runbook ou si vous avez une question à propos de PowerShell, publiez une question sur notre forum.If you need help writing a runbook or have a question about PowerShell, post a question to our forum.

Étapes suivantesNext Steps