Partilhar via

Editar runbooks textuais na Automação do Azure

  • Artigo

Você pode usar o editor de texto na Automação do Azure para editar runbooks do PowerShell e runbooks do Fluxo de Trabalho do PowerShell. Este editor tem as características típicas de outros editores de código, como o IntelliSense. Ele também usa codificação de cores com recursos especiais adicionais para ajudá-lo a acessar recursos comuns aos runbooks.

O editor de texto inclui um recurso para inserir código para cmdlets, ativos e runbooks filho em um runbook. Em vez de digitar o código você mesmo, você pode selecionar a partir de uma lista de recursos disponíveis e o editor insere o código apropriado no runbook.

Cada runbook na Automação do Azure tem duas versões, Rascunho e Publicado. Edite a versão de rascunho do runbook e, em seguida, publique-o para que possa ser executado. A versão publicada não pode ser editada. Para obter mais informações, consulte Publicar um runbook.

Este artigo fornece etapas detalhadas para executar diferentes funções com este editor. Estes não são aplicáveis a runbooks gráficos. Para trabalhar com esses runbooks, consulte Criação gráfica na Automação do Azure.

Importante

Não inclua a palavra-chave "AzureRm" em nenhum script projetado para ser executado com o módulo Az. A inclusão da palavra-chave, mesmo em um comentário, pode fazer com que o AzureRm carregue e, em seguida, entre em conflito com o módulo Az.

Editar um runbook com o portal do Azure

  1. No portal do Azure, selecione sua conta de automação.
  2. Em AUTOMAÇÃO DE PROCESSOS, selecione Runbooks para abrir a lista de runbooks.
  3. Escolha o runbook a ser editado e clique em Editar.
  4. Edite o runbook.
  5. Clique em Salvar quando as edições estiverem concluídas.
  6. Clique em Publicar se quiser publicar a versão de rascunho mais recente do runbook.

Inserir um cmdlet em um runbook

  1. Na tela do editor de texto, posicione o cursor onde deseja colocar o cmdlet.
  2. Expanda o nó Cmdlets no controle Library.
  3. Expanda o módulo que contém o cmdlet a ser usado.
  4. Clique com o botão direito do mouse no nome do cmdlet para inserir e selecione Adicionar à tela. Se o cmdlet tiver mais de um conjunto de parâmetros, o editor adicionará o conjunto padrão. Você também pode expandir o cmdlet para selecionar um conjunto de parâmetros diferente.
  5. Observe que o código do cmdlet é inserido com toda a sua lista de parâmetros.
  6. Forneça um valor apropriado no lugar do valor entre colchetes angulares (<>) para quaisquer parâmetros necessários. Remova todos os parâmetros de que não precisa.

Inserir código para um runbook filho em um runbook

  1. Na tela do editor de texto, posicione o cursor onde deseja colocar o código para o runbook filho.
  2. Expanda o nó Runbooks no controle Library.
  3. Clique com o botão direito do mouse no runbook para inserir e selecione Adicionar à tela.
  4. O código para o runbook filho é inserido com quaisquer espaços reservados para quaisquer parâmetros do runbook.
  5. Substitua os espaços reservados por valores apropriados para cada parâmetro.

Inserir um ativo em um runbook

  1. No controle Canvas do editor de texto, posicione o cursor onde você deseja colocar o código para o runbook filho.
  2. Expanda o nó Ativos no controle Biblioteca.
  3. Expanda o nó para o tipo de ativo desejado.
  4. Clique com o botão direito do mouse no nome do ativo para inserir e selecione Adicionar à tela. Para ativos variáveis, selecione Adicionar "Obter variável" à tela ou Adicionar "Definir variável" à tela, dependendo se você deseja obter ou definir a variável.
  5. Observe que o código do ativo é inserido no runbook.

Editar um runbook de Automação do Azure usando o Windows PowerShell

Para editar um runbook com o Windows PowerShell, use o editor de sua escolha e salve o runbook em um arquivo .ps1 . Você pode usar o cmdlet Export-AzAutomationRunbook para recuperar o conteúdo do runbook. Você pode usar o cmdlet Import-AzAutomationRunbook para substituir o runbook de rascunho existente pelo modificado.

Recuperar o conteúdo de um runbook usando o Windows PowerShell

Os comandos de exemplo a seguir mostram como recuperar o script para um runbook e salvá-lo em um arquivo de script. Neste exemplo, a versão Draft é recuperada. Também é possível recuperar a versão publicada do runbook, embora esta versão não possa ser alterada.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

Alterar o conteúdo de um runbook usando o Windows PowerShell

Os comandos de exemplo a seguir mostram como substituir o conteúdo existente de um runbook pelo conteúdo de um arquivo de script.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Próximos passos