Propiedades de RunbookRunbook properties

Se aplica a: System Center 2016 - OrchestratorApplies To: System Center 2016 - Orchestrator

En líneas generales, un Runbook es una serie de actividades que utilizan datos, realizan tareas y publican datos para que los utilicen otras actividades del Runbook.A runbook is essentially a series of activities that are using data, performing tasks, and publishing data for use by other activities in the runbook. Cada Runbook tiene una colección de propiedades configurables.Each runbook has a collection of configurable properties. Dichas propiedades permiten personalizar el comportamiento de un Runbook.These properties let you customize the behavior of a runbook.

Para ver las propiedades de un RunbookTo view the properties of a runbook

  1. En el Runbook Designer, en el panel Conexiones , haga clic en la carpeta Runbooks .In the Runbook Designer, in the Connections pane, click the Runbooks folder.

  2. Si el Runbook se almacena en una carpeta, seleccione la carpeta correspondiente en Runbooks.If the runbook is stored in a folder, select the appropriate folder under Runbooks.

  3. En el Runbook Designer área de trabajo de diseño, haga clic en la pestaña de un runbook para seleccionar propiedades.In the Runbook Designer Design workspace, Right-click the tab of a runbook to select Properties.

  4. Para cerrar el cuadro de diálogo Propiedades de Runbook , haga clic en Finalizar.To close the Runbook Properties dialog box, click Finish.

Se mostrará un resumen de las propiedades del Runbook e información acerca de cómo configurarlas.A summary of the runbook properties and how to configure them follows.

GeneralGeneral

En la pestaña General del cuadro de diálogo Propiedades de Runbook , es posible personalizar el nombre y la descripción del Runbook.On the General tab of the Runbook Properties dialog box, you can customize a name and description for the runbook. También puede asociar una programación al Runbook.You can also associate a schedule with the runbook. Una vez asignada la programación al Runbook, este solo se ejecutará en las fechas y las horas especificadas en la programación.After you assigned a schedule to the runbook, the runbook only runs on the dates and times that you specified in the schedule.

Para crear una programaciónTo create a schedule

  1. En Runbook Designer, en el panel Conexiones , expanda la carpeta Configuración global .In the Runbook Designer, in the Connections pane, expand the Global Settings folder.

  2. Haga clic con el botón secundario en la carpeta Programaciones para seleccionar la opción Nueva y, a continuación, la opciónProgramación.Right-click the Schedules folder to select New to selectSchedule.

  3. En la pestaña General del cuadro de diálogo Nueva programación , en el cuadro Nombre , escriba un nombre para la programación.On the General tab of the New Schedule dialog box, in the Name box, enter a name for the schedule.

  4. En la pestaña Detalles del cuadro de diálogo Nueva programación , seleccione la fecha y la hora a la que se iniciará el Runbook.On the Details tab of the New Schedule dialog box, select the date and time to start the runbook.

    Para configurar la programación para determinados días de la semanaTo configure the schedule for specific days of the week
    1. En la pestaña Detalles del cuadro de diálogo Nueva programación , haga clic en Días de la semanay, a continuación, seleccione los días en los que desea que se inicie el Runbook.On the Details tab of the New Schedule dialog box, click Days of the week, and then select the days on which you want to start the runbook.

    2. En Repetición, seleccione la semana del mes en la que desea iniciar el Runbook.Under Occurrence, select the week of the month to start the runbook.

      Por ejemplo, si desea iniciar el Runbook todos los lunes, en Días de la semana, seleccione Lunesy, en Repetición, seleccione Primera, Segunda, Tercera, Cuartay Última.For example, if you want to start the runbook every Monday, under Days of the week, select Monday, and under Occurrence, select First, Second, Third, Fourth, and Last.

    Para configurar la programación para días específicos del mesTo configure the schedule for specific days in the month
    1. En la pestaña Detalles del cuadro de diálogo Nueva programación , haga clic en Días del mes.On the Details tab of the New Schedule dialog box, click Days of the month.

    2. En el cuadro Días del mes , escriba la fecha o las fechas en las que desea iniciar el Runbook.In the Days of the month box, enter the date or dates on which you want to start the runbook.

      Separe las fechas por comas.Separate multiple dates with a comma.

      Por ejemplo, si desea que el Runbook se inicie los días 1 y 15 de cada mes, escriba 1, 15 en el cuadro Días del mes .For example, if you want to start the runbook on the first and 15th of every month, enter 1, 15 in the Days of the month box.

    Para configurar la programación a horas específicasTo configure the schedule for specific hours
    1. En la pestaña Detalles del cuadro de diálogo Nueva programación , seleccione Horas.On the Details tab of the New Schedule dialog box, select Hours.

    2. En el cuadro de diálogo Programar horas , seleccione las horas a las que desea que se inicie el Runbook.In the Schedule Hours dialog box, select the hours on which you want to start the runbook.

      Puede permitir y denegar el inicio de un Runbook durante un período determinado.You can both allow and deny the start of a runbook during any period. Por ejemplo, si desea iniciar un runbook solo fuera del horario comercial, seleccione las horas de 9 a. M.For example, if you want to start a runbook only outside business hours, select the hours of 9 A.M. a 5 P.M.to 5 P.M. para el lunes, el martes, el miércoles, el jueves y el viernes y, a continuación, haga clic en denegado.for Monday, Tuesday, Wednesday, Thursday, and Friday, and then click Denied.

  5. En la pestaña Excepciones del cuadro de diálogo Nueva programación , agregue las excepciones de fechas para el Runbook y, a continuación, haga clic en Aceptar.On the Exceptions tab of the New Schedule dialog box, add any date exceptions for the runbook, and then click OK.

  6. Haga clic en Finalizar.Click Finish.

[IMPORTANTE][IMPORTANT]
La fecha y la hora programadas para el inicio de un Runbook se basan en el reloj del sistema del servidor de Runbook.The scheduled date and time to start a runbook is based on the system clock of the runbook server. Esto permite que las programaciones funcionen en entornos de máquina virtual y sigan ejecutándose incluso cuando el reloj del sistema se ajuste al horario de verano.This enables schedules to function in virtual machine environments and to continue to run even when the system clock adjusts for daylight savings time.

Para asociar una programación a un RunbookTo associate a schedule with a runbook

  1. En el propiedades de Runbook cuadro de diálogo, en la General , haga clic en los puntos suspensivos (... ) botón para buscar un programación.In the Runbook Properties dialog box, on the General tab, click the ellipsis (...) button to browse for a Schedule.

  2. Seleccione una programación, haga clic en Aceptary, a continuación, haga clic en Finalizar.Select a schedule, click OK, and then click Finish.

Servidores RunbookRunbook servers

Esta pestaña muestra la lista de servidores de Runbooks asignados para ejecutar este Runbook.This tab displays the list of runbook servers assigned to run this runbook. Si la lista está vacía, el Runbook utilizará la configuración definida en la carpeta Servidores de Runbooks que se encuentra en el panel Conexiones de Runbook Designer.If the list is empty, the runbook uses the setting defined in the Runbook Servers folder found in the Connections pane of the Runbook Designer. Si el servidor de Runbook que utiliza el rol Principal está disponible, el Runbook se ejecutará con dicho rol.If the runbook server that uses the Primary role is available, the runbook runs on it. Si el servidor de Runbook principal no está disponible, se comprobará cada servidor de Runbook que utilice el rol Modo de espera hasta que se encuentre uno que pueda ejecutar el Runbook.If the primary runbook server is not available, each runbook server that uses a Standby role is checked until one is found that can run the runbook.

Puede invalidar el comportamiento predeterminado y asignar a un Runbook un servidor de Runbook principal, así como tantos servidores de Runbooks como desee.You can override the default behavior and assign a primary and any number of standby runbook servers to a runbook. Puede resultar útil asignar un servidor de Runbook específico a un Runbook si este requiere acceso a un recurso especializado como, por ejemplo, un dispositivo de reserva.It is useful to assign a specific runbook server to a runbook if the runbook requires access to a specialized resource, such as a backup device.

Para asignar los servidores de Runbooks principal y de reserva a un RunbookTo assign primary and standby runbook servers to a runbook

  1. En el cuadro de diálogo Propiedades de Runbook , en la pestaña Runbook Servers , seleccione Sobrescribir roles predeterminados de Runbook Server para configurar los servidores de Runbooks principal y de reserva.In the Runbook Properties dialog box, on the Runbook Servers tab, select Override default Runbook Server roles to configure primary and standby runbook servers.

  2. Haga clic en Agregar.Click Add.

  3. Seleccione un servidor de Runbook y, a continuación, haga clic en Aceptar.Select a runbook server, and then click OK.

    El primer servidor de Runbook agregado se convertirá en el servidor de Runbook principal.The first runbook server that you added becomes the primary runbook server.

  4. Para agregar más servidores de Runbooks, haga clic en Agregary seleccione otro servidor de Runbook.To add more runbook servers, click Add, and select another runbook server.

    Los servidores de Runbooks adicionales se agregarán como servidor de Runbook de reserva.All additional runbook servers are added as standby runbook servers.

  5. Cuando haya terminado de agregar servidores de Runbooks, haga clic en Finalizar.When you are finished adding runbook servers, click Finish.

RegistroLogging

Esta característica controla los datos que se registran en la base de datos de Orchestration.This feature controls what data is logged to the orchestration database. Si se almacena en la base de datos de Orchestration, los datos estarán visibles en vistas como, por ejemplo, el panel Registro de Runbook Designer y en la consola de Orchestration.If stored in the orchestration database, this data is visible in views such as the Log pane in the Runbook Designer and in the Orchestration console. Esta información no afecta a la disponibilidad de los datos publicados de un Runbook en ejecución.This information does not affect the availability of Published Data in a running runbook.

Los datos publicados incluyen datos específicos de cada actividad.Published Data includes data specific to each activity.

Los datos publicados comunes son conjuntos de elementos de datos comunes a todas las actividades.Common Published Data is a set of data items that are common to all activities. Estos elementos son los siguientes:These items are as follows:

  • Nombre de actividadActivity Name

  • Tipo de actividadActivity Type

  • Identificador de actividadActivity ID

  • Hora de finalización de actividad (año, mes, día, día de la semana, horas, minutos, segundos)Activity End Time Year, Month, Day, Weekday, Hours, Minutes, Seconds

  • Duración de actividadActivity Duration

  • Actividad anteriorPrevious Activity

  • Nombre de la actividad anteriorPrevious Activity Name

[ADVERTENCIA][CAUTION]
Cuando se activa el registro, aumenta el tamaño de la base de datos de Orchestration.When you turn on logging, the size of the orchestration database increases.

Notificaciones de eventosEvent notifications

Puede habilitar la notificación de eventos para el Runbook.You can enable event notification for the runbook. Las notificaciones aparecen en vistas como, por ejemplo, el panel Registro de Runbook Designer y en la consola de Orchestration.Notifications appear in views such as the Log pane in the Runbook Designer and in the Orchestration console.

Si desea recibir notificaciones cuando un Runbook se ejecuta durante un periodo superior al especificado, escriba un valor en el cuadro Segundos .If you want to be notified when a runbook runs for more than a specified length of time, enter a value in the seconds box.

Si desea recibir una notificación si no se ejecuta el Runbook, haga clic en la opción Notificar si el Runbook no se puede ejecutar .If you want to be notified if the runbook does not run, click the Runbook fails to run option.

Para obtener más información acerca de las notificaciones de eventos, vea registros de Orchestrator.For more information about event notifications, see Orchestrator Logs.

Simultaneidad de trabajosJob concurrency

La configuración de la simultaneidad de trabajos permite establecer el número máximo de trabajos simultáneos para que pueda realizar varias solicitudes para el mismo Runbook al mismo tiempo.The job concurrency setting lets you set the maximum number of simultaneous jobs, so that you can carry out multiple requests for the same runbook at the same time. Esta configuración se aplica al Runbook individual.This setting applies to the individual runbook. Un servidor de Runbook puede ejecutar hasta 50 Runbooks al mismo tiempo.A runbook server can run 50 runbooks at the same time. Si selecciona una configuración de simultaneidad de trabajos superior a 50, su entorno requerirá más servidores de Runbooks; de lo contrario, las solicitudes de inicio de Runbooks se pondrán en cola.If you select a job concurrency setting over 50, your environment requires more runbook servers or the requests to start a runbook will queue.

Se aplican las siguientes limitaciones:The following limitations apply:

  • No se pueden ejecutar solicitudes simultáneas de Runbooks que comienzan con actividades de supervisión.You cannot run simultaneous requests for runbooks that start with Monitoring activities. Si intenta cambiar el número máximo de solicitudes simultáneas para estos Runbooks, Runbook Designer restablecerá el valor de Número máximo de trabajos simultáneos a 1 y mostrará un mensaje de error.If you try to change the maximum number of simultaneous requests for these runbooks, the Runbook Designer resets the Maximum number of simultaneous jobs value to 1 and displays an error message.

  • Un servidor de Runbook puede ejecutar solicitudes simultáneas de Runbooks hasta alcanzar el límite máximo de procesamiento.A runbook server runs simultaneous requests for runbooks up to the maximum processing limit. Para cambiar el límite máximo de procesamiento, vea How to Configure Runbook Throttling.To change the maximum processing limit, see How to Configure Runbook Throttling.

  • No cree solicitudes simultáneas de Runbooks que contengan actividades del tipo Modificar contador.Do not create simultaneous requests for runbooks that contain Modify Counter activities. Al ejecutar copias diferentes del mismo runbook al mismo tiempo que modifican (establecido, restablecer, incrementar o disminuir), un contador es posible que el valor del contador deje de ser confiable.When you run different copies of the same runbook at the same time that modify (set, reset, increment, or decrement), a Counter can cause the Counter value to become unreliable. Puede leer el valor de los Contadores en Runbooks que se ejecutan al mismo tiempo.You can read the value of Counters in runbooks that run at the same time.

  • No ejecute solicitudes simultáneas de runbooks que interactúen con un no-productos de Microsoft, como un sistema o de vales-supervisión herramienta, a menos que tenga una buena comprensión de cómo dichas herramientas controlan el procesamiento en paralelo.Do not run simultaneous requests for runbooks that interact with a non-Microsoft product, such as a ticketing or system-monitoring tool, unless you have a good understanding of how the tool handles parallel processing. Si el no-aplicación de Microsoft no se puede controlar el procesamiento paralelo, o si no conoce, deje el número máximo de solicitudes simultáneas en un valor de 1.If the non-Microsoft application cannot handle parallel processing, or if you do not know, leave the maximum number of simultaneous requests at a value of 1.

  • Planee detenidamente la utilización de solicitudes simultáneas.Plan the use of multiple requests carefully. Antes de cambiar el número máximo de solicitudes de Runbook simultáneas, tenga en cuenta las tareas que realiza el Runbook.Before you change the maximum number of simultaneous runbook requests, consider the tasks performed by the runbook. Compruebe que cada instancia del Runbook pueda finalizar correctamente.Verify that each runbook instance can finish successfully. Por ejemplo, si el Runbook crea una carpeta, copia archivos en la carpeta y, a continuación, la elimina al finalizar, es posible que una instancia del Runbook elimine la carpeta antes de que otra instancia haya terminado de usarla.For example, if your runbook creates a folder, copies files into it, and then deletes the folder when it is finished, one instance of the runbook might delete the folder before other instances are finished with it. En este caso, debe mantener el número máximo de solicitudes simultáneas para este Runbook con un valor igual a 1 para evitar conflictos.In this case, you should keep the maximum number of simultaneous requests for this runbook a value of 1 to avoid conflicts.

Datos devueltosReturned Data

Datos devueltos define los datos que devuelve un Runbook cuando termina.Returned Data defines the data that a runbook returns when it finishes. Cada definición de Datos devueltos puede contener uno o varios valores de parámetro.Each Returned Data definition can contain either a single or multiple parameter values. Para rellenar las definiciones de datos, finalice el flujo de trabajo con la actividad Datos devueltos que contenga los valores devueltos.To populate the data definitions, end the workflow with a Return Data activity that contains the return values.

Puede tener acceso a los valores de datos devueltos a través de los datos publicados de una de las siguientes formas.You access the Returned Data values through Published Data in one of several ways.

  • Invoque el Runbook desde otro Runbook mediante la actividad Invocar Runbook.Invoke the runbook from another runbook by using the Invoke Runbook activity. El runbook primario puede tener acceso a datos devueltos del runbook secundario como datos publicados de la actividad invocar Runbook.The parent runbook can access the child runbook's Returned Data as Published Data from the Invoke Runbook activity.

  • Visualice los datos publicados desde Runbook Designer o desde la consola de Orchestration.View the Published Data from the Runbook Designer or Orchestration console.

  • Usar el servicio web Orchestrator para devolver los datos publicados mediante programación.Use the Orchestrator web service to return the Published Data programmatically.

Para definir los datos que debe devolver un Runbook, utilice las opciones Agregar, Editary Quitar para crear cada uno de los parámetros.To define the Returned Data for a runbook to return, use Add, Edit, and Remove to create each parameter.

Pasos siguientesNext steps