Uso de los runbooks y módulos existentes

En lugar de crear sus propios runbooks y módulos en Azure Automation, dispone de acceso a escenarios ya compilados por Microsoft y la comunidad. Puede obtener runbooks de Python y PowerShell relacionados con Azure en la galería de runbooks de Azure Portal, y módulos y runbooks (que pueden ser específicos de Azure o no) en la galería de PowerShell. También puede contribuir a la comunidad si comparte los escenarios que desarrolle.

Nota:

El Centro de scripts de TechNet se va a retirar. Todos los runbooks del centro de scripts de la galería de runbooks se han migrado a la organización GitHub de Automation. Para más información, consulteMigración de runbooks de Azure Automation a GitHub.

Importación de runbooks desde GitHub con Azure Portal

Nota:

• La opción Examinar galería de Azure Portal tiene una experiencia de usuario mejorada.
• En la hoja Automatización de procesos>Runbook, puede importar runbooks mediante la opción Importar un runbook o Examinar galería y la página Runbooks muestra dos columnas nuevas: Versión en entorno de ejecución y Tipo de runbook.

1. En Azure Portal, abra la cuenta de Automation.

2. Seleccione la hoja Runbooks en Automatización de procesos.

3. Haga clic en Importar un runbook en la página Runbooks.

   

4. En la página Importar un runbook, puede importar un archivo almacenado en el equipo local o desde GitHub mediante Buscar archivo o Examinar la galería, respectivamente.

5. Seleccione el archivo.

6. Escriba el nombre, la versión del entorno de ejecución y la descripción.

7. Haga clic en Import.

   

8. Como alternativa, seleccione Examinar galería en la página Runbooks para examinar los runbooks disponibles.

   

9. Puede usar los filtros situados encima de la lista para restringir la presentación por publicador, tipo y ordenación. Busque el elemento de la galería que desee y selecciónelo para ver sus detalles.

   

10. Haga clic en Seleccionar para seleccionar el runbook que haya elegido.

11. En la página Importar un runbook, escriba el nombre y seleccione las versiones del entorno de ejecución.

12. El tipo de runbook y la descripción se completan automáticamente.

13. Haga clic en Import.

    

14. El runbook aparecerá en la pestaña Runbooks para la cuenta de Automation.

Runbooks de la galería de PowerShell

Importante

Debe comprobar el contenido de cualquier runbook que obtenga de la galería de PowerShell. Tenga mucho cuidado al instalarlos y ejecutarlos en un entorno de producción.

La galería de PowerShell ofrece diversos runbooks de Microsoft y de la comunidad que se pueden importar a Azure Automation. Puede usar uno al descargarlo de la galería, o puede importar runbooks directamente desde la galería o de la cuenta de Automation en Azure Portal.

Nota:

Los runbooks gráficos no se admiten en la Galería de PowerShell.

Solo se puede importar directamente desde la Galería de PowerShell mediante Azure Portal. No se puede llevar a cabo esta función mediante PowerShell. El procedimiento es el mismo que se indica en Importación de runbooks desde GitHub con Azure Portal, excepto en que el origen será la galería de PowerShell.

Módulos de la galería de PowerShell

Los módulos de PowerShell contienen cmdlets que puede usar en sus runbooks. Los módulos existentes que se pueden instalar en Azure Automation están disponibles en la Galería de PowerShell. Puede iniciar esta galería desde Azure Portal e instalar los módulos directamente en Azure Automation, o puede descargarlos e instalarlos de forma manual.

También puede encontrar módulos para importar en Azure Portal. Se muestran para la cuenta de Automation en la opción Módulos en Recursos compartidos.

Importante

No incluya la palabra clave "AzureRm" en ningún script diseñado para ejecutarse con el módulo Az. La inclusión de la palabra clave, incluso en un comentario, puede hacer que AzureRm se cargue y, a continuación, entre en conflicto con el módulo Az.

Escenarios comunes disponibles en la galería de PowerShell

La lista siguiente contiene algunos runbooks que admiten escenarios comunes. Para obtener una lista completa de los runbooks creados por el equipo de Azure Automation, consulte el perfil de AzureAutomationTeam.

• Update-ModulesInAutomationToLatestVersion: Importa la versión más reciente de todos los módulos de una cuenta de Automation de la Galería de PowerShell.
• Enable-AzureDiagnostics: Configura Azure Diagnostics y Log Analytics para recibir registros de Azure Automation que contengan el estado y los flujos de trabajo.
• Copy-ItemFromAzureVM: Copia un archivo remoto de una máquina virtual Windows de Azure.
• Copy-ItemToAzureVM: copia un archivo local en una máquina virtual de Azure.

Contribución a la comunidad

Le recomendamos encarecidamente que contribuya y ayude a crecer a la comunidad de Azure Automation. Comparta los runbooks increíbles que haya creado con la comunidad. Se agradecen sus contribuciones.

Adición de un runbook a la galería de runbooks de GitHub

Puede agregar nuevos runbooks de PowerShell o Python a la galería de runbooks con este flujo de trabajo de GitHub.

1. Cree un repositorio público en GitHub y agregue el runbook y cualquier otro archivo necesario (como readme.md, description, etc.).

2. Agregue el tema azureautomationrunbookgallery para asegurarse de que nuestro servicio detecta el repositorio, de modo que se pueda mostrar en la galería de runbooks de Automation.

3. Si el runbook que creó es un flujo de trabajo de PowerShell, agregue el tema PowerShellWorkflow. Si se trata de un runbook de Python 3, agregue Python3. No se requiere ningún otro tema específico para runbooks de Azure, pero le recomendamos que agregue otros temas que se puedan usar para la categorización y la búsqueda en la galería de runbooks.

   Nota:

   Consulte los runbooks existentes en la galería para ver aspectos como el formato, los encabezados y las etiquetas existentes que puede usar (como Azure Automation o Linux Azure Virtual Machines).

Para sugerir cambios en un runbook existente, realice una solicitud de incorporación de cambios en él.

Si decide clonar y editar un runbook existente, el procedimiento recomendado es darle un nombre diferente. Si vuelve a usar el nombre anterior, aparecerá dos veces en la lista de la galería de runbooks.

Nota:

Espere al menos 12 horas para la sincronización entre GitHub y la galería de runbooks de Automation, tanto para runbooks nuevos como actualizados.

Adición de un runbook de PowerShell a la galería de PowerShell

Microsoft recomienda agregar a la Galería de PowerShell aquellos runbooks que piense que podrían ser útiles para otros clientes. La Galería de PowerShell acepta módulos y scripts de PowerShell. Puede agregar un runbook cargándolo en la Galería de PowerShell.

Importación de un módulo de la galería de módulos de Azure Portal

1. En Azure Portal, abra la cuenta de Automation.

2. En Recursos compartidos, seleccione Módulos.

3. En la página Módulos, seleccione Examinar galería para abrir la lista de módulos.

   

4. En la página Examinar galería, puede buscar por los campos siguientes:

   • Nombre del módulo
   • Etiquetas
   • Autor
   • Nombre de cmdlet/recurso de DSC

5. Busque un módulo que le interese y selecciónelo para ver sus detalles.

   Al explorar un módulo específico, puede ver más información. Esta información incluye 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.

   

6. Para instalar el módulo directamente en Azure Automation, haga clic en Importar.

7. En el panel Importar, puede ver el nombre del módulo que se va a importar. Si están instaladas todas las dependencias, el botón Aceptar estará activo. Si faltan dependencias, debe importarlas antes de importar este módulo.

8. En la página Importar, haga clic en Aceptar para importar el módulo. Cuando Azure Automation importa un módulo en la cuenta, extrae metadatos sobre el módulo y los cmdlets. Esta acción puede tardar un par de minutos, ya que debe extraerse cada actividad.

9. Recibirá una notificación inicial indicando que el módulo se está implementado y otra notificación cuando se haya completado.

10. Una vez importado el módulo, puede ver las actividades disponibles. Puede usar los recursos del módulo en los runbooks y recursos de DSC.

Nota:

Los módulos que solo admiten PowerShell Core no son compatibles con Azure Automation y no pueden importarse en Azure Portal, ni implementarse directamente desde la Galería de PowerShell.

Solicitud de un runbook o módulo

Puede enviar solicitudes a Voz de usuario. Si necesita ayuda para escribir un runbook o se plantea preguntas acerca de PowerShell, publique una pregunta en nuestra Página de preguntas y respuestas de Microsoft.

Pasos siguientes

• Para empezar a trabajar con runbooks de PowerShell, consulte Tutorial: Creación de un runbook de PowerShell.
• Para trabajar con runbooks, consulte Administración de runbooks en Azure Automation.
• Para más información sobre el scripting de PowerShell, consulte la documentación de PowerShell.
• Para obtener una referencia de los cmdlets de PowerShell, consulte Az.Automation.