Tipos de runbooks de Azure AutomationAzure Automation runbook types

La característica de automatización de procesos de Azure Automation admite varios tipos de runbooks, tal como se define en la tabla siguiente.The Azure Automation Process Automation feature supports several types of runbooks, as defined in the following table. Para más información sobre el entorno de automatización de procesos, consulte Ejecución de un runbook en Azure Automation.To learn about the process automation environment, see Runbook execution in Azure Automation.

TipoType DescripciónDescription
GráficoGraphical Runbook gráfico basado en Windows PowerShell, y creado y editado completamente en el editor gráfico de Azure Portal.Graphical runbook based on Windows PowerShell and created and edited completely in the graphical editor in Azure portal.
Flujo de trabajo gráfico de PowerShellGraphical PowerShell Workflow Runbook gráfico basado en flujo de trabajo de Windows PowerShell, y creado y editado completamente en el editor gráfico de Azure Portal.Graphical runbook based on Windows PowerShell Workflow and created and edited completely in the graphical editor in Azure portal.
PowerShellPowerShell Runbook de texto basado en scripting de Windows PowerShell.Textual runbook based on Windows PowerShell scripting.
Flujo de trabajo de PowerShellPowerShell Workflow Runbook de texto basado en scripting de flujo de trabajo de Windows PowerShell.Textual runbook based on Windows PowerShell Workflow scripting.
PythonPython Runbook de texto basado en scripting de Python.Textual runbook based on Python scripting.

Tenga en cuenta las siguientes consideraciones al determinar qué tipo usar para un runbook concreto.Take into account the following considerations when determining which type to use for a particular runbook.

  • No es posible convertir runbooks de tipo gráfico a texto o viceversa.You can't convert runbooks from graphical to text type, or the other way around.
  • Existen limitaciones al utilizar runbooks de diferentes tipos como runbooks secundarios.There are limitations when using runbooks of different types as child runbooks. Para más información, consulte Child runbooks in Azure Automation (Runbooks secundarios en Azure Automation).For more information, see Child runbooks in Azure Automation.

Runbooks gráficosGraphical runbooks

Puede crear y editar runbooks gráficos y runbooks gráficos de flujo de trabajo de PowerShell mediante el editor gráfico de Azure Portal.You can create and edit graphical and graphical PowerShell Workflow runbooks using the graphical editor in the Azure portal. Sin embargo, no puede crear o editar este tipo de runbooks con otra herramienta.However, you can't create or edit this type of runbook with another tool. Principales características de los runbooks gráficos:Main features of graphical runbooks:

  • Se exportan a archivos de la cuenta de Automation y se importan a otra cuenta de Automation.Exported to files in your Automation account and then imported into another Automation account.
  • Generan código de PowerShell.Generate PowerShell code.
  • Se pueden convertir a y desde runbooks gráficos de flujo de trabajo de PowerShell durante la importación.Converted to or from graphical PowerShell Workflow runbooks during import.

VentajasAdvantages

  • Utilice modelos de creación visual para insertar, vincular y configurar.Use visual insert-link-configure authoring model.
  • Céntrese en cómo fluyen los datos por el proceso.Focus on how data flows through the process.
  • Represente visualmente los procesos de administración.Visually represent management processes.
  • Incluya otros runbooks como runbooks secundarios para crear flujos de trabajo de nivel alto.Include other runbooks as child runbooks to create high-level workflows.
  • Anime a usar la programación modular.Encourage modular programming.

LimitacionesLimitations

  • No puede crear o editar fuera de Azure Portal.Can't create or edit outside the Azure portal.
  • Puede requerir una actividad de código que contenga código de PowerShell para ejecutar una lógica compleja.Might require a code activity containing PowerShell code to execute complex logic.
  • No puede convertir a uno de los formatos de texto, ni puede convertir un runbook de texto a un formato gráfico.Can't convert to one of the text formats, nor can you convert a text runbook to graphical format.
  • No puede ver ni modificar directamente el código de PowerShell que el flujo de trabajo gráfico crea.Can't view or directly edit PowerShell code that the graphical workflow creates. Puede ver el código que crea en las actividades de código.You can view the code you create in any code activities.
  • No puede ejecutar runbooks en Linux Runbook Worker.Can't run runbooks on a Linux Hybrid Runbook Worker. Consulte Automatización de recursos en los centros de datos o nube con Hybrid Runbook Worker.See Automate resources in your datacenter or cloud by using Hybrid Runbook Worker.

Runbooks de PowerShellPowerShell runbooks

Los runbooks de PowerShell están basados en Windows PowerShell.PowerShell runbooks are based on Windows PowerShell. Puede modificar directamente el código del runbook con el editor de texto en el Portal de Azure.You directly edit the code of the runbook using the text editor in the Azure portal. También puede usar cualquier editor de texto sin conexión e importar el runbook en Azure Automation.You can also use any offline text editor and import the runbook into Azure Automation.

VentajasAdvantages

  • Implemente toda la lógica compleja con código de PowerShell sin otras complejidades del flujo de trabajo de PowerShell.Implement all complex logic with PowerShell code without the other complexities of PowerShell Workflow.
  • Se inician con más rapidez que los runbooks de flujo de trabajo de PowerShell, ya que no necesitan compilarse antes de la ejecución.Start faster than PowerShell Workflow runbooks, since they don't need to be compiled before running.
  • Ejecute en Azure y en Hybrid Runbook Worker para Windows y Linux.Run in Azure and on Hybrid Runbook Workers for both Windows and Linux.

LimitacionesLimitations

  • Debe estar familiarizado con el scripting de PowerShell.You must be familiar with PowerShell scripting.
  • Los runbooks no pueden usar el procesamiento paralelo para ejecutar varias acciones en paralelo.Runbooks can't use parallel processing to execute multiple actions in parallel.
  • Los runbooks no pueden usar los puntos de control para reanudar un runbook si se produce un error.Runbooks can't use checkpoints to resume runbook if there's an error.
  • Solo puede incluir los runbooks gráficos y de flujo de trabajo de PowerShell como runbooks secundarios mediante el cmdlet Start-AzAutomationRunbook, que crea un trabajo.You can include only PowerShell Workflow runbooks and graphical runbooks as child runbooks by using the Start-AzAutomationRunbook cmdlet, which creates a new job.

Problemas conocidosKnown issues

A continuación se describen los problemas conocidos actuales con los runbooks de PowerShell:The following are current known issues with PowerShell runbooks:

  • Los runbooks de PowerShell no pueden recuperar un recurso de variable sin cifrar con un valor null.PowerShell runbooks can't retrieve an unencrypted variable asset with a null value.
  • Los runbooks de PowerShell no pueden recuperar un recurso de variable con *~* en el nombre.PowerShell runbooks can't retrieve a variable asset with *~* in the name.
  • Una operación Get-Process en un bucle de un runbook de PowerShell puede bloquearse después de más de 80 iteraciones.A Get-Process operation in a loop in a PowerShell runbook can crash after about 80 iterations.
  • Un runbook de PowerShell puede producir un error si intenta escribir una gran cantidad de datos en el flujo de salida a la vez.A PowerShell runbook can fail if it tries to write a large amount of data to the output stream at once. Puede evitar este problema si hace que el runbook genere únicamente la información necesaria para trabajar con objetos grandes.You can typically work around this issue by having the runbook output just the information needed to work with large objects. Por ejemplo, en lugar de usar Get-Process sin limitaciones, puede hacer que el cmdlet genere solo los parámetros necesarios como en Get-Process | Select ProcessName, CPU.For example, instead of using Get-Process with no limitations, you can have the cmdlet output just the required parameters as in Get-Process | Select ProcessName, CPU.

Runbooks del flujo de trabajo de PowerShellPowerShell Workflow runbooks

Los runbooks del flujo de trabajo de PowerShell son runbooks de texto basados en el flujo de trabajo de Windows PowerShell.PowerShell Workflow runbooks are text runbooks based on Windows PowerShell Workflow. Puede modificar directamente el código del runbook con el editor de texto en el Portal de Azure.You directly edit the code of the runbook using the text editor in the Azure portal. También puede usar cualquier editor de texto sin conexión e importar el runbook en Azure Automation.You can also use any offline text editor and import the runbook into Azure Automation.

VentajasAdvantages

  • Implemente toda la lógica compleja con código del flujo de trabajo de PowerShell.Implement all complex logic with PowerShell Workflow code.
  • Use los puntos de control para reanudar la operación si se produce un error.Use checkpoints to resume operation if there's an error.
  • Utilice el procesamiento paralelo para realizar varias acciones en paralelo.Use parallel processing to do multiple actions in parallel.
  • Se pueden incluir otros runbooks gráficos o de flujo de trabajo de PowerShell como runbooks secundarios para crear flujos de trabajo de alto nivel.Can include other graphical runbooks and PowerShell Workflow runbooks as child runbooks to create high-level workflows.

LimitacionesLimitations

  • Debe estar familiarizado con el flujo de trabajo de PowerShell.You must be familiar with PowerShell Workflow.
  • Los runbooks deben tratar la complejidad adicional del flujo de trabajo de PowerShell como objetos deserializados.Runbooks must deal with the additional complexity of PowerShell Workflow, such as deserialized objects.
  • Los runbooks tardan más en iniciarse que los runbooks de PowerShell, ya que deben compilarse antes de su ejecución.Runbooks take longer to start than PowerShell runbooks since they must be compiled before running.
  • Solo puede incluir runbooks de PowerShell como runbooks secundarios mediante el cmdlet Start-AzAutomationRunbook.You can only include PowerShell runbooks as child runbooks by using the Start-AzAutomationRunbook cmdlet.
  • Los runbooks no se pueden ejecutar en una instancia de Hybrid Runbook Worker de Linux.Runbooks can't run on a Linux Hybrid Runbook Worker.

Runbooks de PythonPython runbooks

Los runbooks de Python utilizan Python 2 y Python 3.Python runbooks compile under Python 2 and Python 3. Actualmente, los runbooks de Python 3 están en versión preliminar.Python 3 runbooks are currently in preview. Puede modificar directamente el código del runbook con el editor de texto en Azure Portal.You can directly edit the code of the runbook using the text editor in the Azure portal. También puede usar cualquier editor de texto sin conexión e importar el runbook en Azure Automation.You can also use an offline text editor and import the runbook into Azure Automation.

VentajasAdvantages

  • Use las sólidas bibliotecas de Python.Use the robust Python libraries.
  • Se pueden ejecutar en Azure o en instancias de Hybrid Runbook Worker.Can run in Azure or on Hybrid Runbook Workers.
  • En el caso de Python 2, las instancias de Hybrid Runbook Worker de Windows son compatibles si Python2.7 está instalado.For Python 2, Windows Hybrid Runbook Workers are supported with python 2.7 installed.
  • Para los trabajos en la nube de Python 3, se admite la versión 3.8 de Python.For Python 3 Cloud Jobs, Python 3.8 version is supported. Es posible que los scripts y paquetes de cualquier versión 3.x funcionen si el código es compatible con distintas versiones.Scripts and packages from any 3.x version might work if the code is compatible across different versions.
  • En el caso de los trabajos híbridos de Python 3 en máquinas Windows, puede instalar cualquier versión 3. x que desee usar.For Python 3 Hybrid jobs on Windows machines, you can choose to install any 3.x version you may want to use.
  • Para los trabajos híbridos de Python 3 para Linux, depende de la versión de Python 3 instalada en el equipo para ejecutar DSC OMSConfig y Hybrid Worker para Linux.For Python 3 Hybrid jobs on Linux machines, we depend on the Python 3 version installed on the machine to run DSC OMSConfig and the Linux Hybrid Worker. Se recomienda instalar la versión 3.6 en máquinas Linux.We recommend installing 3.6 on Linux machines. Sin embargo, otras versiones también deberían funcionar si no hay cambios importantes en los contratos o firmas de método entre versiones de Python 3.However, different versions should also work if there are no breaking changes in method signatures or contracts between versions of Python 3.

LimitacionesLimitations

  • Debe estar familiarizado con el scripting de Python.You must be familiar with Python scripting.
  • Para utilizar bibliotecas de terceros, debe importar los paquetes a la cuenta de Automation.To use third-party libraries, you must import the packages into the Automation account.
  • Usar el cmdlet Start-AutomationRunbook en PowerShell o en el flujo de trabajo de PowerShell para iniciar un runbook de Python 3 (versión preliminar) no funciona.Using Start-AutomationRunbook cmdlet in PowerShell/PowerShell Workflow to start a Python 3 runbook (preview) does not work. Puede usar el cmdlet  Start-AzAutomationRunbook desde el nódulo Az.Automation o el cmdlet  Start-AzureRmAutomationRunbook del módulo AzureRm.Automation para solucionar esta limitación.You can use Start-AzAutomationRunbook cmdlet from Az.Automation module or Start-AzureRmAutomationRunbook cmdlet from AzureRm.Automation module to work around this limitation.
  • Los runbooks (versión preliminar) y los paquetes de Python 3 no funcionan con PowerShell.Python 3 runbooks (preview) and packages do not work with PowerShell.
  • Azure Automation no admite  sy.stderr.Azure Automation does not support sys.stderr.

Problemas conocidosKnown issues

Los trabajos de Python 3 a veces generan un error con el mensaje de excepción para indicar que la ruta de acceso ejecutable del intérprete no es válida.Python 3 jobs sometimes fails with an exception message invalid interpreter executable path. Podría ver esta excepción si un trabajo se retrasa y empieza más de 10 minutos tarde o usa Start-AutomationRunbook para iniciar runbooks de Python 3.You might see this exception if a job is delayed, starting more than 10 minutes or using Start-AutomationRunbook to start Python 3 runbooks. Si el trabajo se retrasa, reiniciar el runbook debería ser suficiente.If the job is delayed, restarting the runbook should be sufficient.

Pasos siguientesNext steps