Galerías de runbooks y módulos para Automatización de AzureRunbook and module galleries for Azure Automation

En lugar de crear sus propios runbooks y módulos en Automatización de Azure, dispone de acceso a diversos escenarios ya compilados por Microsoft y la comunidad.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. Puede usar estos escenarios sin modificaciones o como punto de partida para modificarlos según sus requisitos específicos.You can either use these scenarios without modification or you can use them as a starting point and edit them for your specific requirements.

Puede obtener runbooks en la Galería de Runbook y módulos en la Galería de PowerShell.You can get runbooks from the Runbook Gallery and modules from the PowerShell Gallery. También puede contribuir a la comunidad si comparte los escenarios que desarrolle.You can also contribute to the community by sharing scenarios that you develop.

La Galería de Runbook ofrece diversos runbooks de Microsoft y la comunidad que se pueden importar a Azure Automation.The Runbook Gallery provides a variety of runbooks from Microsoft and the community that you can import into Azure Automation. Puede descargar un runbook de la galería, que se hospeda en el Centro de scripts de TechNet, o puede importar runbooks directamente desde la galería del Portal de Azure clásico o de Azure Portal.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.

Solo se puede importar directamente desde la Galería de Runbooks mediante el Portal de Azure (o su versión clásica).You can only import directly from the Runbook Gallery using the Azure classic portal or Azure portal. No se puede llevar a cabo esta función mediante Windows PowerShell.You cannot perform this function using Windows PowerShell.

Nota

Debería validar el contenido de los runbooks que obtenga de la Galería de runbooks y extremar el cuidado al instalarlos y ejecutarlos en un entorno de producción.|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. En Azure Portal, haga clic en Nuevo, App Services, Automation, Runbook, De la galería.In the Azure portal, click, New, App Services, Automation, Runbook, From Gallery.
  2. Seleccione una categoría para ver runbooks relacionados y seleccione uno para ver sus detalles.Select a category to view related runbooks, and select a runbook to view its details. Cuando seleccione el Runbook que desee, haga clic en el botón de flecha derecha.When you select the runbook you want, click the right arrow button.

    Galería de runbooks

  3. Revise el contenido del runbook y tenga en cuenta los requisitos de la descripción.Review the contents of the runbook and note any requirements in the description. Haga clic en el botón de flecha derecha cuando termine.Click the right arrow button when you’re done.
  4. Escriba los detalles del runbook y haga clic en el botón de marca de verificación.Enter the runbook details and then click the checkmark button. El nombre del runbook ya estará rellenado.The runbook name is already filled in.
  5. El runbook aparecerá en la pestaña Runbooks para la cuenta de Automation.The runbook appears on the Runbooks tab for the Automation Account.
  1. En Azure Portal, abra su cuenta de Automation.In the Azure portal, open your Automation account.
  2. Haga clic en el icono Runbooks para abrir la lista de runbooks.Click on the Runbooks tile to open the list of runbooks.
  3. Haga clic en el botón Examinar galería .Click Browse gallery button.

    Botón Examinar galería

  4. Busque el elemento de la galería que desee y selecciónelo para ver sus detalles.Locate the gallery item you want and select it to view its details.

    Examinar galería

  5. Haga clic en Ver proyecto de origen para ver el elemento en el Centro de scripts de TechNet.Click on View source project to view the item in the TechNet Script Center.
  6. Para importar un elemento, haga clic en él para ver sus detalles y después haga clic en el botón Importar .To import an item, click on it to view its details and then click the Import button.

    Botón Importar

  7. Si lo desea, cambie el nombre del runbook y después haga clic en Aceptar para importarlo.Optionally, change the name of the runbook and then click OK to import the runbook.
  8. El runbook aparecerá en la pestaña Runbooks para la cuenta de Automation.The runbook appears on the Runbooks tab for the Automation Account.

Microsoft recomienda agregar a la Galería de Runbooks aquellos runbooks que piense que podrían ser útiles para otros clientes.Microsoft encourages you to add runbooks to the Runbook Gallery that you think would be useful to other customers. Puede agregar un runbook si lo carga al Centro de scripts teniendo en cuenta los siguientes detalles.You can add a runbook by uploading it to the Script Center taking into account the following details.

  • Necesita especificar Windows Azure como categoría y Automation como subcategoría para el runbook que se mostrará en el asistente.You must specify Windows Azure for the Category and Automation for the Subcategory for the runbook to be displayed in the wizard.
  • Se debe cargar un único archivo. ps1 o .graphrunbook.The upload must be a single .ps1 or .graphrunbook file. Si el runbook requiere módulos, runbooks secundarios o recursos, debe enumerarlos en la descripción del envío y en la sección de comentarios del 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 tiene un escenario que requiere varios runbooks, cargue cada uno por separado e indique los nombres de los runbooks relacionados en cada una de sus descripciones.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. Asegúrese de usar las mismas etiquetas para que se muestren en la misma categoría.Make sure that you use the same tags so that they show up in the same category. Un usuario tendrá que leer la descripción para saber que se requieren otros runbooks para que funcione el escenario.A user will have to read the description to know that other runbooks are required the scenario to work.
  • Agregue la etiqueta "GraphicalPS" si va a publicar un runbook gráfico (no en un flujo de trabajo gráfico).Add the tag "GraphicalPS" if you are publishing a Graphical runbook (not a Graphical Workflow).
  • Inserte un fragmento de código de Flujo de trabajo de PowerShell o PowerShell en la descripción con el icono Insertar sección de código .Insert either a PowerShell or PowerShell Workflow code snippet into the description using Insert code section icon.
  • El resumen de la descarga se mostrará en los resultados de la Galería de runbooks, por lo que debería proporcionar información detallada que ayude a un usuario a identificar la funcionalidad del 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.
  • Debería asignar entre una y tres de las etiquetas siguientes a la carga.You should assign one to three of the following Tags to the upload. El runbook se mostrará en el asistente en las categorías que coincidan con sus etiquetas.The runbook is listed in the wizard under the categories that match its tags. El asistente pasará por alto las etiquetas que no aparezcan en esta lista.Any tags not on this list are ignored by the wizard. Si no especifica ninguna etiqueta coincidente, el runbook se incluirá en la categoría Otros.If you don’t specify any matching tags, the runbook is listed under the Other category.

    • BackupBackup
    • Administración de la capacidadCapacity Management
    • Control de cambiosChange Control
    • Cumplimiento normativoCompliance
    • Desarrollo y entornos de pruebaDev / Test Environments
    • Recuperación ante desastresDisaster Recovery
    • SupervisiónMonitoring
    • Aplicación de revisionesPatching
    • AprovisionamientoProvisioning
    • CorrecciónRemediation
    • Administración del ciclo de vida de VMVM Lifecycle Management
  • Automatización actualiza la galería una vez a la hora, por lo que no verá sus contribuciones de inmediato.Automation updates the Gallery once an hour, so you won’t see your contributions immediately.

Los módulos de PowerShell contienen cmdlets que puede usar en sus runbooks; los módulos existentes que se pueden instalar en Automatización de Azure están disponibles en la Galería de PowerShell.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. Puede iniciar esta galería desde el Portal de Azure e instalarlos directamente en Automatización de Azure o puede descargarlos e instalarlos de forma manual.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. No puede instalar los módulos directamente desde el Portal de Azure clásico, pero puede descargarlos e instalarlos como cualquier otro módulo.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. En Azure Portal, abra su cuenta de Automation.In the Azure portal, open your Automation account.
  2. Seleccione Módulos en Recursos compartidos para abrir la lista de módulos.Select Modules under Shared Resources to open the list of modules.
  3. Haga clic en Examinar la galería en la parte superior de la página.Click Browse gallery from the top of the page.

    Galería de módulos

  4. En la página Examinar galería, puede buscar por los campos siguientes:On the Browse gallery page, you can search by the following fields:

    • Nombre de móduloModule Name
    • EtiquetasTags
    • AutorAuthor
    • Nombre de cmdlet/recurso de DSCCmdlet/DSC resource name
  5. Busque un módulo que le interese y selecciónelo para ver sus detalles.Locate a module that you're interested in and select it to view its details.
    Cuando explore un módulo específico, podrá ver más información sobre el módulo, incluido un vínculo a la Galería de PowerShell, las dependencias necesarias y todos los cmdlets o recursos de DSC que contiene el módulo.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.

    Detalles del módulo de PowerShell

  6. Para instalar el módulo directamente en Automatización de Azure, haga clic en el botón Importar .To install the module directly into Azure Automation, click the Import button.

    Botón de importación de módulo

  7. Al hacer clic en el botón Importar, en el panel Importar, verá el nombre del módulo que se va a importar.When you click the Import button, on the Import pane, you see the module name that you are about to import. Si están instaladas todas las dependencias, el botón Aceptar estará activo.If all the dependencies are installed, the OK button is activated. Si faltan dependencias, debe importarlas antes de importar este módulo.If you are missing dependencies, you need to import those before you can import this module.
  8. Haga clic en Aceptar para importar el módulo.Click OK to import the module. Cuando Azure Automation importa un módulo en la cuenta, extrae metadatos sobre el módulo y los cmdlets.While Azure Automation imports a module to your account, it extracts metadata about the module and the cmdlets.

    Página de importación de módulo

    Esto puede tardar un par de minutos, ya que cada actividad debe extraerse.This may take a couple of minutes since each activity needs to be extracted.

  9. Recibirá una notificación inicial indicando que el módulo se está implementado y otra notificación cuando se haya completado.You receive an initial notification that the module is being deployed and another notification when it has completed.
  10. Una vez importado el módulo, verá las actividades disponibles y podrá usar sus recursos en los runbooks y en la Configuración de estado deseado.After the module is imported, you can see the available activities, and you can use its resources in your runbooks and Desired State Configuration.

Solicitud de un runbook o móduloRequesting a runbook or module

Puede enviar solicitudes a Voz de usuario.You can send requests to User Voice. Si necesita ayuda para escribir un runbook o se plantea preguntas acerca de PowerShell, publique una pregunta en nuestro foro.If you need help writing a runbook or have a question about PowerShell, post a question to our forum.

Pasos siguientesNext Steps