Tipos de runbook da Automação do AzureAzure Automation runbook types

O recurso de Automação de Processo da Automação do Azure dá suporte a vários tipos de runbooks, conforme definido na tabela a seguir.The Azure Automation Process Automation feature supports several types of runbooks, as defined in the following table. Para saber mais sobre o ambiente de automação de processo, veja Execução de runbook na Automação do Azure.To learn about the process automation environment, see Runbook execution in Azure Automation.

TypeType DescriçãoDescription
GráficoGraphical Runbook gráfico baseado no Windows PowerShell e criado e editado totalmente no editor gráfico do portal do Azure.Graphical runbook based on Windows PowerShell and created and edited completely in the graphical editor in Azure portal.
Fluxo de Trabalho Gráfico do PowerShellGraphical PowerShell Workflow Runbook gráfico baseado no Fluxo de Trabalho do Windows PowerShell e criado e editado totalmente no editor gráfico do portal do Azure.Graphical runbook based on Windows PowerShell Workflow and created and edited completely in the graphical editor in Azure portal.
PowerShellPowerShell Runbook de texto baseado no script do Windows PowerShell.Text runbook based on Windows PowerShell scripting.
Fluxo de Trabalho do PowerShellPowerShell Workflow Runbook de texto baseado no script do Windows PowerShell.Text runbook based on Windows PowerShell Workflow scripting.
PythonPython Runbook de texto baseado no script do Python.Text runbook based on Python scripting.

Considere os fatores a seguir ao determinar qual tipo usar para um runbook específico.Take into account the following considerations when determining which type to use for a particular runbook.

  • Não é possível converter runbooks do tipo gráfico para texto ou vice-versa.You can't convert runbooks from graphical to text type, or the other way around.
  • Existem limitações para o uso de runbooks de tipos diferentes, como runbooks filhos.There are limitations when using runbooks of different types as child runbooks. Para obter mais informações, confira Runbooks filho na Automação do Azure.For more information, see Child runbooks in Azure Automation.

Runbooks gráficosGraphical runbooks

Você pode criar e editar runbooks gráficos e runbooks gráficos de Fluxo de Trabalho do PowerShell usando o editor gráfico no portal do Azure.You can create and edit graphical and graphical PowerShell Workflow runbooks using the graphical editor in the Azure portal. No entanto, não é possível criar ou editar este tipo de runbook com outra ferramenta.However, you can't create or edit this type of runbook with another tool. Principais recursos dos runbooks gráficos:Main features of graphical runbooks:

  • Podem ser exportados para arquivos na conta de Automação e, em seguida, importados para outra conta de Automação.Can be exported to files in your Automation account and then imported into another Automation account.
  • Gerar código do PowerShell.Generate PowerShell code.
  • Podem ser convertidos de ou para runbooks gráficos de Fluxo de Trabalho do PowerShell durante a importação.Can be converted to or from graphical PowerShell Workflow runbooks during import.

VantagensAdvantages

  • Uso do modelo visual de criação para configurar link de inserção.Use visual insert-link-configure authoring model.
  • Foco em como os dados fluem no processo.Focus on how data flows through the process.
  • Represente visualmente os processos de gerenciamento.Visually represent management processes.
  • Inclui outros runbooks como runbooks filhos para criar fluxos de trabalho de alto nível.Include other runbooks as child runbooks to create high-level workflows.
  • Incentiva a programação modular.Encourage modular programming.

LimitaçõesLimitations

  • Não é possível criar ou editar fora do portal do Azure.Can't create or edit outside the Azure portal.
  • Pode exigir uma atividade de código que contenha código do PowerShell para executar lógica complexa.Might require a code activity containing PowerShell code to execute complex logic.
  • Não é possível converter para dos formatos de texto, nem converter um runbook de texto para formato gráfico.Can't convert to one of the text formats, nor can you convert a text runbook to graphical format.
  • Não é possível exibir ou editar diretamente o código do PowerShell que o fluxo de trabalho gráfico cria.Can't view or directly edit PowerShell code that the graphical workflow creates. É possível exibir o código criado em todas as atividades do código.You can view the code you create in any code activities.
  • Não é possível executar runbooks em um Hybrid Runbook Worker do Linux.Can't run runbooks on a Linux Hybrid Runbook Worker. Veja Automação de recursos em seu datacenter ou nuvem usando o Hybrid Runbook Worker.See Automate resources in your datacenter or cloud by using Hybrid Runbook Worker.

Runbooks do PowerShellPowerShell runbooks

Os runbooks do PowerShell se baseiam no Windows PowerShell.PowerShell runbooks are based on Windows PowerShell. Você edita o código do runbook diretamente usando o editor de texto do portal do Azure.You directly edit the code of the runbook using the text editor in the Azure portal. Também é possível usar qualquer editor de texto offline e importar o runbook na Automação do Azure.You can also use any offline text editor and import the runbook into Azure Automation.

VantagensAdvantages

  • Implemente toda a lógica complexa com o código do PowerShell sem as complexidades adicionais do Fluxo de Trabalho do PowerShell.Implement all complex logic with PowerShell code without the additional complexities of PowerShell Workflow.
  • Inicia mais rápido que os runbooks de Fluxo de Trabalho do PowerShell, já que não precisa ser compilado antes da execução.Start faster than PowerShell Workflow runbooks, since they don't need to be compiled before running.
  • Pode ser executado no Azure e em Hybrid Runbook Workers para Windows e Linux.Run in Azure and on Hybrid Runbook Workers for both Windows and Linux.

LimitaçõesLimitations

  • Exige familiarização com script do PowerShell.You must be familiar with PowerShell scripting.
  • Os runbooks não usam processamento paralelo para executar várias ações paralelamente.Runbooks can't use parallel processing to execute multiple actions in parallel.
  • Os runbooks não usam pontos de verificação para retomar o runbook em caso de erro.Runbooks can't use checkpoints to resume runbook if there's an error.
  • Os runbooks de Fluxo de Trabalho do PowerShell e os runbooks gráficos só podem ser incluídos como runbooks filhos usando o cmdlet Start-AzAutomationRunbook, que cria um novo trabalho.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 conhecidosKnown issues

A seguir estão os problemas atualmente conhecidos com os runbooks do PowerShell:The following are current known issues with PowerShell runbooks:

  • Os runbooks do PowerShell não conseguem recuperar um ativo variável não criptografado com um valor nulo.PowerShell runbooks can't retrieve an unencrypted variable asset with a null value.
  • Os runbooks do PowerShell não conseguem recuperar um ativo variável com *~* no nome.PowerShell runbooks can't retrieve a variable asset with *~* in the name.
  • Uma operação Get-Process em um loop dentro de um runbook do PowerShell pode falhar após cerca de 80 iterações.A Get-Process operation in a loop in a PowerShell runbook can crash after about 80 iterations.
  • Um runbook do PowerShell pode falhar se tentar gravar uma grande quantidade de dados no fluxo de saída de uma só vez.A PowerShell runbook can fail if it tries to write a large amount of data to the output stream at once. Geralmente, você pode contornar esse problema fazendo com que o runbook emita apenas as informações necessárias para trabalhar com objetos grandes.You can typically work around this issue by having the runbook output just the information needed to work with large objects. Por exemplo, em vez de usar Get-Process sem limitações, faça com que o cmdlet gere apenas os parâmetros necessários como em 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 do Fluxo de Trabalho do PowerShellPowerShell Workflow runbooks

Os runbooks do Fluxo de Trabalho do PowerShell são runbooks de texto baseados no Fluxo de Trabalho do Windows PowerShell.PowerShell Workflow runbooks are text runbooks based on Windows PowerShell Workflow. Você edita o código do runbook diretamente usando o editor de texto do portal do Azure.You directly edit the code of the runbook using the text editor in the Azure portal. Também é possível usar qualquer editor de texto offline e importar o runbook na Automação do Azure.You can also use any offline text editor and import the runbook into Azure Automation.

VantagensAdvantages

  • Implemente toda a lógica complexa com o código do Fluxo de Trabalho do PowerShell.Implement all complex logic with PowerShell Workflow code.
  • Utiliza os pontos de verificação para retomar a operação caso ocorra um erro.Use checkpoints to resume operation if there's an error.
  • Utiliza o processamento paralelo para executar várias ações paralelamente.Use parallel processing to do multiple actions in parallel.
  • Pode incluir outros runbooks gráficos e runbooks de Fluxo de Trabalho do PowerShell como runbooks filhos para criar fluxos de trabalho de alto nível.Can include other graphical runbooks and PowerShell Workflow runbooks as child runbooks to create high-level workflows.

LimitaçõesLimitations

  • Você deve estar familiarizado com o Fluxo de Trabalho do PowerShell.You must be familiar with PowerShell Workflow.
  • Os runbooks devem lidar com a complexidade adicional do Fluxo de Trabalho do PowerShell, como objetos desserializados.Runbooks must deal with the additional complexity of PowerShell Workflow, such as deserialized objects.
  • Os runbooks demoram mais para iniciar do que os runbooks do PowerShell, pois precisam ser compilados antes da execução.Runbooks take longer to start than PowerShell runbooks since they must be compiled before running.
  • Você só pode incluir unbooks do PowerShell como runbooks filhos usando o cmdlet Start-AzAutomationRunbook.You can only include PowerShell runbooks as child runbooks by using the Start-AzAutomationRunbook cmdlet.
  • Os runbooks não podem ser executados em um Hybrid Runbook Worker do Linux.Runbooks can't run on a Linux Hybrid Runbook Worker.

Runbooks PythonPython runbooks

Compilar runbooks Python em no Python 2.Python runbooks compile under Python 2. Você pode editar o código do runbook diretamente usando o editor de texto do portal do Azure.You can directly edit the code of the runbook using the text editor in the Azure portal. Também é possível usar um editor de texto offline e importar o runbook na Automação do Azure.You can also use an offline text editor and import the runbook into Azure Automation.

VantagensAdvantages

  • As bibliotecas robustas do Python podem ser usadas.Use the robust Python libraries.
  • Os runbooks podem ser executados no Azure ou em Hybrid Runbook Workers do Linux.Can run in Azure or on Linux Hybrid Runbook Workers. Há suporte para Hybrid Runbook Workers do Windows com Python 2.7 instalado.Windows Hybrid Runbook Workers are supported with python2.7 installed.

LimitaçõesLimitations

  • Você deve estar familiarizado com script do Python.You must be familiar with Python scripting.
  • Atualmente há suporte apenas para o Python 2.Only Python 2 is supported presently. Todas as funções específicas do Python 3 falham.Any Python 3-specific functions fail.
  • Para utilizar bibliotecas de terceiros, você deve importar os pacotes para a conta de Automação.To use third-party libraries, you must import the packages into the Automation account.

Próximas etapasNext steps