Editar um Runbook
Publicado: março de 2016
Aplica-se a: Windows Azure Pack for Windows Server
Cada runbook no Service Management Automation tem duas versões, Rascunho e Publicado. Você edita a versão de Rascunho do fluxo de trabalho e, em seguida, publica-o para que ele pode ser executado. A versão Publicada não pode ser editada.
Para editar um Runbook com o Portal de gerenciamento
O Portal de gerenciamento inclui um editor que você pode usar para exibir e editar runbooks. Além de fornecer recursos básicos de edição de texto, o editor fornece a capacidade de inserir automaticamente o código para Ativos Globais, Atividades e Runbooks.
No Portal de gerenciamento, selecione Automação.
Selecione a guia Runbooks.
Clique no nome do runbook que deseja editar.
Selecione a guia Autor.
Clique em Rascunho na parte superior da tela ou então no botão Editar na parte inferior da tela.
Efetue a edição necessária.
Clique em Salvar quando suas edições estiverem concluídas.
Clique em Publicar se você quiser que a última versão de rascunho do runbook seja publicada.
Inserção de código em um Runbook
O editor de automação inclui um recurso para inserir código para atividades, configurações e runbooks em um runbook. Em vez de digitar o código por conta própria, você pode selecioná-lo em uma lista de ativos disponíveis e fazer com que o código apropriado seja inserido no runbook.
Para inserir código para um runbook em um runbook
Abra o runbook no editor do Portal de gerenciamento.
Na parte inferior da tela, clique em Inserir e então em Runbook.
Selecione o runbook a ser inserido na coluna central e clique na seta à direita.
Se o runbook tiver parâmetros, eles serão listados para sua informação.
Clique no botão de seleção.
O código para executar o runbook selecionado será inserido no runbook atual.
Se o runbook exigir parâmetros, forneça um valor apropriado no local do tipo de dados cercado por chaves <>.
Para inserir um ativo global em um Runbook
Abra o runbook no editor do Portal de gerenciamento.
Na parte inferior da tela, clique em Inserir e então em Configuração.
No coluna Ação de Configuração, selecione o tipo de código que você requer
Selecione os ativos disponíveis na coluna central.
Clique no botão de seleção.
Para inserir uma atividade em um runbook
Abra o runbook no editor do Portal de gerenciamento.
Na parte inferior da tela, clique em Inserir e então em Atividade.
Na coluna Módulo de Integração, selecione o módulo que contém a atividade.
No painel Atividade, selecione uma atividade.
Na coluna Descrição, observe a descrição da atividade. Opcionalmente, você pode clicar em Exibir ajuda detalhada para iniciar a ajuda para a atividade no navegador.
Clique na seta à direita.
Se a atividade tiver parâmetros, eles serão listados para sua informação.
Clique no botão de seleção.
O código para executar a atividade será inserido no runbook.
Se a atividade requer parâmetros, forneça um valor apropriado no lugar do tipo de dados cercado por chaves <>.
Para editar um runbook de automação usando o Windows PowerShell
Para editar um runbook com o Windows PowerShell, você edita o fluxo de trabalho usando o editor de sua escolha e salva-o em um arquivo .ps1. Você pode usar o cmdlet Get-SMARunbookDefinition para recuperar o conteúdo do runbook e, em seguida, o cmdlet Edit-SMARunbook para substituir o fluxo de trabalho de rascunho pelo modificado.
Para criar um novo runbook do conteúdo por meio de um arquivo de script, consulte d14db796-a3e5-4b1d-a098-e734ceae2e0e#ImportRunbookScriptPS.
Para 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 de rascunho é recuperada. Também é possível recuperar a versão publicada do runbook, embora esta versão não possa ser alterada.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"
$runbookDefinition = Get-SMARunbookDefinition –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Type Draft
$runbookContent = $runbookDefinition.Content
Out-File -InputObject $runbookContent -FilePath $scriptPath
Para 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 que contém um fluxo de trabalho.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"
Edit-SmaRunbook –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Path $scriptPath -Overwrite
Publish-SmaRunbook –WebServiceEndpoint $webServer –Port $port –Name $runbookName –Path $scriptPath
Consulte também
Criar ou importar um Runbook
Service Management Automation
Criação de runbooks