Editar um Runbook
Publicado: junho de 2016
Aplica-se a: Windows Azure Pack for Windows Server
Cada runbook do Service Management Automation tem duas versões, a de Rascunho e a Publicada. Para executar o runbook, começa por editar a versão de Rascunho do fluxo de trabalho e, depois, publica-o. A versão Publicada não pode ser editada.
Para Editar um Runbook através do Portal de Gestão
O Portal de Gestão inclui um editor que pode utilizar para ver e editar runbooks. Além de disponibilizar capacidades de edição de texto básicas, o editor proporciona a capacidade de inserir automaticamente códigos para Ativos Globais, Atividades e Runbooks.
No Portal de Gestão, selecione Automatização.
Selecione o separador Runbooks.
Clique no nome do runbook que pretende editar.
Selecione o separador Criar.
Clique em Rascunho, na parte superior do ecrã, ou em Editar, na parte inferior.
Efetue a edição necessária.
Clique em Guardar, quando tiver concluído a edição.
Clique em Publicar, se pretender que a versão mais recente de rascunho do runbook seja publicada.
Inserir um Código num Runbook
O editor de Automatização inclui uma funcionalidade para inserir códigos para Atividades, Definições e Runbooks num runbook. Em vez de digitar o código, pode selecioná-lo numa lista de ativos disponíveis e inserir o código correto automaticamente no runbook.
Para Inserir um Código para um Runbook num Runbook
Abra o runbook no editor do Portal de Gestão.
Na parte inferior do ecrã, clique em Inserir e, em seguida, em Runbook.
Selecione o runbook a inserir a partir da coluna central e clique na seta para a direita.
Se o runbook contiver parâmetros, estes serão apresentados para sua informação.
Clique no botão Verificar.
O código para executar o runbook selecionado será inserido no runbook atual.
Se o runbook necessitar de parâmetros, indique um valor apropriado, em vez do tipo de dados, entre chavetas <>.
Para Inserir um Elemento Global num Runbook
Abra o runbook no editor do Portal de Gestão.
Na parte inferior do ecrã, clique em Inserir e em Definição.
Na coluna Ação da Definição, selecione o tipo de código de que precisa
Selecione-o nos elementos disponíveis na coluna central.
Clique no botão Verificar.
Para Inserir uma Atividade num Runbook
Abra o runbook no editor do Portal de Gestão.
Na parte inferior do ecrã, clique em Inserir e 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, indique a descrição da atividade. Em alternativa, pode clicar em Ver ajuda detalhada para iniciar a ajuda da atividade no browser.
Clique na seta para a direita.
Se a atividade contiver parâmetros, estes serão apresentados para sua informação.
Clique no botão Verificar.
O código para executar a atividade será inserido no runbook.
Se a atividade necessitar de parâmetros, indique um valor apropriado, em vez do tipo de dados, entre chavetas <>.
Para editar um Runbook de Automatização com o Windows PowerShell
Para editar um runbook com o Windows PowerShell, tem de utilizar o editor que selecionou para editar o fluxo de trabalho e guardá-lo num ficheiro .ps1. Pode utilizar o cmdlet Get-SMARunbookDefinition para obter os conteúdos do runbook e, em seguida, o cmdlet Edit-SMARunbook para substituir o fluxo de trabalho de rascunho existente pelo modificado.
Para criar um novo runbook a partir dos conteúdos de um ficheiro de script, consulte d14db796-a3e5-4b1d-a098-e734ceae2e0e#ImportRunbookScriptPS.
Para Obter os Conteúdos de um Runbook com o Windows PowerShell
Os comandos de exemplo seguintes exemplificam como obter o script de um runbook e guardá-lo num ficheiro de script. Neste exemplo, é obtida a versão de Rascunho. Também é possível obter a versão Publicada do runbook, embora essa 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 os Conteúdos de um Runbook com o Windows PowerShell
Os comandos de exemplo seguintes exemplificam como substituir os conteúdos existentes de um runbook pelos conteúdos de um ficheiro de script que contenha 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
Consultar Também
Criar ou Importar um Runbook
Service Management Automation
Runbook Authoring [SMA]