• Artículo

Editar un runbook

 

Publicada: junio de 2016

Se aplica a: Windows Azure Pack for Windows Server

En Automatización de administración de servicios, cada runbook tiene dos versiones: borrador y publicada. Se edita la versión de borrador del flujo de trabajo y, después, se publica para que se pueda ejecutar. No se puede editar la versión publicada.

Para editar un runbook con el Portal de administración

El Portal de administración incluye un editor para ver y editar runbooks. Además de proporcionar funciones de edición de texto básicas, el editor permite insertar código automáticamente para activos globales, actividades y runbooks.

  1. En el Portal de administración, seleccione Automatización.

  2. Seleccione la pestaña Runbooks.

  3. Haga clic en el nombre del runbook que quiere editar.

  4. Seleccione la pestaña Autor.

  5. Haga clic en Borrador en la parte superior de la pantalla o en Editar en la parte inferior de la pantalla.

  6. Realice las modificaciones necesarias.

  7. Haga clic en Guardar cuando termine las modificaciones.

  8. Haga clic en Publicar si quiere que se publique la última versión de borrador del runbook.

Insertar código en un runbook

El editor de automatización incluye una característica para insertar código para actividades, configuración y runbooks en un runbook. En lugar de tener que escribir el código, puede seleccionar en una lista de activos disponibles y hacer que se inserte el código adecuado en el runbook.

Para insertar código para un runbook en un runbook

  1. Abra el runbook en el editor del Portal de administración.

  2. En la parte inferior de la pantalla, haga clic en Insertar y, después, en Runbook.

  3. En la columna central, seleccione el runbook que quiere insertar y haga clic en la flecha derecha.

  4. Si el runbook tiene parámetros, se enumerarán para su información.

  5. Haga clic en el botón Comprobar.

  6. El código para ejecutar el runbook seleccionado se insertará en el runbook actual.

  7. Si el runbook requiere parámetros, proporcione un valor adecuado en lugar del tipo de datos que aparece entre corchetes angulares <>.

Para insertar un activo global en un runbook

  1. Abra el runbook en el editor del Portal de administración.

  2. En la parte inferior de la pantalla, haga clic en Insertar y, después, en Configuración.

  3. En la columna Acción de configuración, seleccione el tipo de código que necesita.

  4. Seleccione entre los activos disponibles en la columna central.

  5. Haga clic en el botón Comprobar.

Para insertar una actividad en un runbook

  1. Abra el runbook en el editor del Portal de administración.

  2. En la parte inferior de la pantalla, haga clic en Insertar y, después, en Actividad.

  3. En la columna Módulo de integración, seleccione el módulo que contiene la actividad.

  4. En el panel Actividad, seleccione una actividad.

  5. En la columna Descripción, escriba la descripción de la actividad. Si lo desea, puede hacer clic en Ver ayuda detallada para iniciar la ayuda de la actividad en el explorador.

  6. Haga clic en la flecha derecha.

  7. Si la actividad tiene parámetros, se enumerarán para su información.

  8. Haga clic en el botón Comprobar.

  9. El código para ejecutar la actividad se insertará en el runbook.

  10. Si la actividad requiere parámetros, proporcione un valor adecuado en lugar del tipo de datos que aparece entre corchetes angulares <>.

Para editar un runbook de automatización con Windows PowerShell

Para editar un runbook con Windows PowerShell, edite el flujo de trabajo con el editor que elija y guárdelo en un archivo. ps1. Puede usar el cmdlet Get-SMARunbookDefinition para recuperar el contenido del runbook y, después, el cmdlet Edit-SMARunbook para reemplazar el flujo de trabajo de borrador existente por el modificado.

Para crear un nuevo runbook a partir del contenido de un archivo de script, consulte d14db796-a3e5-4b1d-a098-e734ceae2e0e#ImportRunbookScriptPS.

Para recuperar el contenido de un runbook con Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo recuperar el script para un runbook y guardarlo en un archivo de script. En este ejemplo, se recupera la versión de borrador. También es posible recuperar la versión publicada del runbook, aunque esta versión no se puede cambiar.

$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 cambiar el contenido de un runbook con Windows PowerShell

Los comandos de ejemplo siguientes muestran cómo reemplazar el contenido existente de un runbook por el contenido de un archivo de script que contiene un flujo de trabajo.

$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

Vea también

Crear o importar un runbook
Service Management Automation
Creación de runbooks [SMA]