Referencia de actividad de flujo de trabajo de Service Manager Authoring Tool
En este artículo se proporcionan instrucciones para desarrolladores de tecnologías de la información (TI) para que puedan crear actividades personalizadas de Windows Workflow Foundation (WF) que los profesionales de TI pueden usar para crear flujos de trabajo de WF específicos de sus procesos de TI. Las actividades personalizadas de WF amplían la biblioteca de actividades: las actividades que se distribuyen con Service Manager Authoring Tool. La sección Referencia de actividad de flujo de trabajo de este documento proporciona detalles de las actividades de WF predeterminadas en la biblioteca de actividades. Esta información está pensada para ayudar a los desarrolladores (o profesionales de TI que actúan como desarrolladores) a crear actividades de WF personalizadas, como sea necesario.
Para obtener información sobre cómo usar actividades de WF y flujos de trabajo de WF con Service Manager, consulta Automatización de procesos de TI con flujos de trabajo.
Actividades de Active Directory
Usa Active Directory Domain Services (AD DS) para que las funciones de Active Directory formen parte del flujo de trabajo en Service Manager.
Service Manager Authoring Tool proporciona dos actividades predeterminadas de Service Manager en el grupo Actividades de Active Directory en el panel Cuadro de herramientas de actividades. En las secciones de este artículo se describen estas actividades.
Agregar equipo de AD DS a una actividad de grupo
Esta actividad agrega un equipo a un grupo de seguridad en Servicios de dominio de Active Directory (AD DS) en Service Manager. El equipo y el grupo deben pertenecer al mismo dominio y se buscan todos los contenedores del dominio.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | Al usar esta actividad, asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en AD DS. |
Propiedades
La actividad Agregar equipo de AD DS a grupo usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Dominio del equipo | ComputerDomain | Cadena | Sí | El nombre de dominio DNS completo donde se encuentra el equipo (por ejemplo, contoso.com). |
| Nombre del equipo | FullyQualifiedComputerName | Cadena | Sí | El nombre del equipo. |
| Nombre de grupo | FullyQualifiedGroupName | Cadena | Sí | El nombre del grupo Servicios de dominio de Active Directory. |
La actividad Agregar equipo de AD DS al grupo genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Descripción |
|---|---|---|---|
| Output | Resultados | Booleano | Resultado de la operación: True si la adición se realizó correctamente; False si se produjo un error. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Actividad Agregar usuario de AD DS a un grupo
Esta actividad agrega un usuario de Active Directory Domain Services (AD DS) a un grupo de seguridad en Service Manager. El usuario y el grupo deben pertenecer al mismo dominio y se busca en todos los contenedores del dominio.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | Al usar esta actividad, asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en AD DS. |
Propiedades
La actividad Agregar usuario de AD DS a un grupo usa las propiedades de entrada que se enumeran en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Dominio de usuario | UserDomain | Cadena | Sí | El nombre de dominio completo (FQDN) del usuario. |
| Nombre de usuario | UserName | Cadena | Sí | El nombre de inicio de sesión del usuario. |
| Nombre de grupo | FullyQualifiedGroupName | Cadena | Sí | El FQDN del grupo. |
La actividad Agregar usuario de AD DS a un grupo genera la salida que se describe en la tabla siguiente.
| Nombre | Nombre interno | Tipo | Descripción |
|---|---|---|---|
| Output | Resultados | Booleano | El resultado de la operación: Verdadero si la adición se ha realizado correctamente, Falso si se ha producido un error. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Actividades de flujo de control
Usa actividades de flujo de control para proporcionar estructuras (ramas, bucles o retrasos del temporizador) para el flujo de trabajo en Service Manager.
La herramienta de creación proporciona cuatro actividades de flujo de control predeterminadas en el grupo Flujo de control en el panel Cuadro de herramientas de actividades.
Actividad Delay
Esta actividad introduce un retraso entre las actividades de un flujo de trabajo en Service Manager. La actividad Delay se deriva de la clase DelayActivity de Microsoft .NET Framework.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Delay usa las propiedades de entrada que se enumeran en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Inicializar TimeoutDuration | InitializeTimeoutDuration | Interno | Especifica un controlador para inicializar la propiedad TimeoutDuration. | |
| TimeoutDuration | TimeoutDuration | TimeSpan | Sí | Duración del retraso. |
La actividad Delay no genera una propiedad de salida.
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | Para obtener más información sobre el uso de esta actividad, consulta Clase DelayActivity en la biblioteca de clases .NET Framework. | None |
Actividad For Each Loop
La actividad For Each Loop toma como entrada una matriz (colección) de objetos y repite el conjunto de actividades dentro del bucle para cada objeto de la colección. Por ejemplo, si la colección de entrada tiene cinco objetos, el bucle recorre en iteración cinco veces. Si la colección está vacía, el bucle no recorre en iteración. No hay ningún límite superior para el número de objetos de la colección. La actividad For Each Loop siempre se ejecuta en el equipo en el que se ejecuta el flujo de trabajo.
La actividad For Each Loop es una actividad compuesta con dos contenedores para actividades:
Input Container: esta actividad configura el bucle y define la colección de entrada. Puedes usar la actividad Get Incident o Get Virtual Machine virtual en este rol.
Loop Container: denominada ForEachChildActivity, esta actividad contiene las actividades de bucle. La mayoría de las actividades de Windows Workflow Foundation (WF) que se colocan en este contenedor tienen dos propiedades adicionales: Elemento actual y Propiedad para enlazar. Para cada actividad dentro del contenedor de bucles, establece estas propiedades de la siguiente manera:
Establece Elemento actual en la propiedad Elemento actual de la actividad Loop Container de la actividad ForEach. Si esta actividad es la primera actividad de la actividad For Each Loop, Elemento actual se establece automáticamente.
Establece el valor de la propiedad Propiedad para enlazar en el valor de la propiedad de la actividad actual que usa el valor Elemento actual.
Dos tipos de actividades no obtienen las propiedades Elemento actual y Propiedad para enlazar y, por lo tanto, no pueden usar los objetos de la colección de entrada:
Actividades de script, como la actividad Script de Windows PowerShell.
Actividades personalizadas u otras actividades que no heredan de la clase WorkflowActivityBase. Estas actividades incluyen las actividades que se basan en la clase base Actividad, como las actividades nativas de Visual Studio.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Para cada bucle usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Recopilación de entradas | InputCollection | Matriz/objeto | N/D | Colección de objetos que se van a pasar, de uno a uno, a las actividades dentro de la actividad Para cada bucle. Si la actividad que reside en el contenedor de entrada genera una matriz de objetos como su propiedad de salida, Colección de entradas se establece automáticamente en esa propiedad. Para ver el valor actual de esta propiedad, haz clic con el botón secundario en el contenedor de bucles y selecciona Propiedades. |
| Elemento actual | CurrentItem | Object | N/D | Índice en la colección de entradas que las actividades dentro del bucle pueden usar como propiedad de entrada. Para la primera actividad del contenedor de bucles, esta propiedad se establece automáticamente. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Para cada bucle usa el servicio de seguimiento personalizado proporcionado por Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones en las condiciones siguientes: - Si se produce algún error en la actividad Para cada bucle y que no está con las actividades secundarias, el flujo de trabajo finaliza. - Si se produce algún error en las actividades secundarias, el flujo de trabajo finaliza a menos que ContinueOnError=true. - Si alguna de las propiedades de entrada es null. La actividad no recorre en iteración. Cada actividad dentro de la actividad Para cada bucle debe escribir sus propios errores o excepciones en el servicio de seguimiento personalizado. La actividad Para cada bucle no lo hace. |
None | None |
Actividad IfElse
Esta actividad controla la secuencia de actividades dentro de un flujo de trabajo en función de una condición booleana (True/False). Puedes usar el resultado de una actividad anterior, como una actividad de script, para la condición.
La actividad IfElse es una actividad de Visual Studio que usa reglas y condiciones. Para obtener más información sobre el uso de reglas y condiciones en Windows Workflow Foundation (WF), consulta Tutorial: Use Rules and Conditions in WF (Tutorial: usar reglas y condiciones en WF) en la Biblioteca de MSDN.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
Ninguno.
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | Para obtener más información sobre la actividad IfElse, consulta Clase IfElseActivity en la biblioteca de clases de .NET Framework 4. | None |
Actividad paralela
Esta actividad bifurca la secuencia de actividades en dos secuencias simultáneas de actividades. La actividad Parallel es una actividad de Visual Studio. Para obtener más información sobre la clase ParallelActivity, consulta Clase ParallelActivity en la biblioteca de clases de .NET Framework.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
Ninguno.
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Actividades de Virtual Machine Manager
Usa actividades de Virtual Machine Manager en Service Manager para crear flujos de trabajo que permitan crear y actualizar máquinas virtuales. Las actividades de Virtual Machine Manager admiten System Center Virtual Machine Manager.
Service Manager Authoring Tool proporciona las siguientes cinco actividades de Virtual Machine Management predeterminadas en el grupo Actividades de VMM en el panel Cuadro de herramientas de actividades.
Actividad Obtener VM
Esta actividad de Service Manager recupera una lista de uno o varios identificadores de máquina virtual de una biblioteca de Virtual Machine Manager (VMM).
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Active Directory Domain Services (AD DS). - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Active Directory Domain Services (AD DS). |
Propiedades
La actividad Obtener VM usa las propiedades de entrada de la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Conjunto de parámetros | ParameterSets | Cadena | No; el valor predeterminado es Conexión. | Especifica un subconjunto de parámetros organizados para un propósito determinado. Para la actividad Obtener VM, puedes seleccionar uno de los siguientes conjuntos de parámetros: - Todas: busca todas las máquinas virtuales disponibles. - Id.: busca una máquina virtual con un identificador conocido. - Conexión: busca máquinas virtuales conectadas al servidor de Virtual Machine Manager (VMM) designado por la propiedad VMMServer. - VMHostGroup: busca máquinas virtuales conectadas al host de máquina virtual designado por la propiedad host de VM. |
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| All | All | Booleano | No. (El valor predeterminado es True). | Disponible si el Conjunto parámetros es All. Si se establece en True, la actividad Obtener VM devuelve una lista de los identificadores de máquina virtual de todas las máquinas virtuales disponibles. |
| ID | Identificador | Cadena | Obligatorio si el conjunto de parámetros es ID. | Disponible si el conjunto el parámetros es ID. Si se establece en True, la actividad Obtener VM devuelve una lista de los identificadores de máquina virtual de todas las máquinas virtuales cuyos identificadores de máquina virtual coinciden con todos o parte del valor de identificador especificado. |
| Grupo de administración | ManagementGroup | Cadena | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establécelo en localhost. (Solo lectura) |
| Servidor de scripts | Destino | Cadena | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Host de VM | VMHost | Cadena | Obligatorio si el conjunto de parámetros es VMHostGroup | Disponible si el conjunto de parámetros es VMHostGroup. Si se selecciona este conjunto de parámetros, la actividad Obtener VM devuelve una lista de los identificadores de máquina virtual de todas las máquinas virtuales que se ejecutan en el host especificado. |
| Nombre de la máquina virtual | VMName | Cadena | No | Especifica el nombre o parte de un nombre de la máquina virtual que se va a buscar. Si la cadena forma parte de un nombre, la actividad recupera los identificadores de todas las máquinas virtuales que la contienen. |
| VMMServer | VMMServer | Cadena | Sí | Especifica el nombre del servidor de System Center Virtual Machine Manager (VMM) que administra las máquinas virtuales. |
La actividad Obtener VM genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Identificadores de VM | VMIDList | Matriz de cadenas | Especifica la lista de identificadores de las máquinas virtuales con nombres que coinciden con la cadena nombre de VM o parte de ella. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Obtener VM usa el servicio de seguimiento personalizado proporcionado por Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | None | None |
Actividad Mover VM
Esta actividad de Service Manager mueve una máquina virtual de la biblioteca de Virtual Machine Manager (VMM) a un host de mantenimiento.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Active Directory Domain Services (AD DS). |
Propiedades
La actividad Mover VM usa las propiedades de entrada de la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Bloquear LM si el host está ocupado | BlockLMIfHostBusy | Booleano | No. (El valor predeterminado es False). | Bloquea el reintento de una migración en directo de Hyper-V si se produjo un error en la migración porque el host de origen o el host de destino ya está participando en otra migración en directo. |
| Grupo de trabajo | JobGroup | Guid (cadena) | No | Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto. |
| Variable de trabajo | JobVariable | Cadena | No | Especifica que se realiza un seguimiento del progreso del trabajo y que este progreso se almacena en la variable denominada por este parámetro. |
| Grupo de administración | ManagementGroup | Cadena | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establécelo en localhost. (Solo lectura) |
| Path | Path | Cadena | No | Especifica el destino de la máquina virtual en el host de mantenimiento. |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia de Optimización de rendimientos y recursos (PRO) que ha desencadenado esta acción. Permite futuras auditorías de sugerencias de PRO. |
| Ejecución asincrónica | RunAsynchronously | Booleano | No. (El valor predeterminado es False). | Especifica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente. |
| Servidor de scripts | Destino | Cadena | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Iniciar VM en el destino | StartVMOnTarget | Booleano | No. (El valor predeterminado es False). | Especifica que una máquina virtual se inicia tan pronto como llegue a su host de destino. |
| Usar clúster | UseCluster | Booleano | No. (El valor predeterminado es False). | Fuerza el uso de la migración de clústeres de Windows Server 2008 para la transferencia de una máquina virtual que se encuentra en un estado guardado en un host, incluso si el clúster admite la migración en vivo de Hyper V. |
| Usar LAN | UseLan | Booleano | No. (El valor predeterminado es False). | Fuerza una transferencia a través de la red de área local (LAN) incluso si hay disponible un mecanismo de transferencia más rápido, como una transferencia de red de área de almacenamiento (SAN). |
| Host de VM | VMHostName | Cadena | Sí | Especifica el nombre del host de mantenimiento al que se moverá la máquina virtual. |
| Id. de VM | VMID | Cadena | Sí | Especifica el identificador único de la máquina virtual que se va a mover. |
| Servidor VMM | VMMServer | Cadena | Sí | Especifica el nombre del servidor de System Center Virtual Machine Manager (VMM) que administra las máquinas virtuales. |
La actividad Mover VM genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Id. de VM | VMID | Cadena | Especifica el identificador único de la máquina virtual que se movió. El Id. de máquina virtual de entrada y el Id. de máquina virtual de salida son iguales a menos que la actividad no consiga encontrar una máquina virtual con un Id. de máquina virtual que coincida con el Id. de máquina virtual de entrada. En ese caso, el Id. de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Mover VM usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | None | None |
Actividad Apagado de VM
Esta actividad de Service Manager apaga el sistema operativo invitado en una máquina virtual.
Puedes usar la actividad Apagado de VM en una máquina virtual en un host basado en Windows (un host de Hyper-V o un host de servidor virtual) solo si los servicios invitados de virtualización están instalados en la máquina virtual. Para una máquina virtual que se implementa en un host de Hyper-V, el servicio invitado de virtualización se denomina Componentes de integración. Para una máquina virtual que se implementa en un host de servidor virtual, el servicio invitado de virtualización se denomina Adiciones de máquina virtual.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Active Directory Domain Services (AD DS). |
Propiedades
La actividad Apagado de VM usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Variable de trabajo | JobVariable | Cadena | No | Especifica que el progreso del trabajo se rastrea y se almacena en la variable nombrada por este parámetro. |
| Grupo de administración | ManagementGroup | Cadena | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establécelo en localhost. (Solo lectura) |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia de Optimización de rendimientos y recursos (PRO) que ha desencadenado esta acción. Permite futuras auditorías de sugerencias de PRO. |
| Ejecución asincrónica | RunAsynchronously | Booleano | No. (El valor predeterminado es False). | Especifica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente. |
| Servidor de scripts | Destino | Cadena | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses Localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Id. de VM | VMID | Cadena | Sí | Especifica el identificador único de la máquina virtual que se va a apagar. |
| VMMServer | VMMServer | Cadena | Sí | Especifica el nombre del servidor de System Center Virtual Machine Manager (VMM) que administra las máquinas virtuales. |
La actividad Apagado de VM genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Id. de VM | VMID | Cadena | Especifica el identificador único de la máquina virtual que se ha apagado. El Id. de máquina virtual de entrada y el Id. de máquina virtual de salida son iguales a menos que la actividad no consiga encontrar una máquina virtual con un Id. de máquina virtual que coincida con el Id. de máquina virtual de entrada. En ese caso, el Id. de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Apagado de VM usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | None | None |
Actividad Iniciar VM
Esta actividad de Service Manager inicia una máquina virtual detenida o en pausa.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Iniciar VM usa las propiedades de entrada de la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Variable de trabajo | JobVariable | Cadena | No | Especifica que el progreso del trabajo se rastrea y se almacena en la variable nombrada por este parámetro. |
| Grupo de administración | ManagementGroup | Cadena | No | Grupo de administración en el que se ejecutará esta actividad. Establécelo en localhost. (Solo lectura) |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia de Optimización de rendimientos y recursos (PRO) que ha desencadenado esta acción. Permite futuras auditorías de sugerencias de PRO. |
| Ejecución asincrónica | RunAsynchronously | Booleano | No. (El valor predeterminado es False). | Especifica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente. |
| Servidor de scripts | Destino | Cadena | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Id. de VM | VMID | Cadena | Sí | Especifica el identificador único de la máquina virtual que se va a iniciar. |
| VMMServer | VMMServer | Cadena | Sí | Especifica el nombre del servidor de System Center Virtual Machine Manager (VMM) que administra las máquinas virtuales. |
La actividad Iniciar VM genera la salida que se describe en la tabla siguiente.
| Nombre | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Id. de VM | VMID | Cadena | Especifica el identificador único de la máquina virtual que se ha iniciado. El Id. de máquina virtual de entrada y el Id. de máquina virtual de salida son iguales a menos que la actividad no consiga encontrar una máquina virtual con un Id. de máquina virtual que coincida con el Id. de máquina virtual de entrada. En ese caso, el Id. de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Iniciar VM usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones, según corresponda, si no se puede resolver alguna de las propiedades del script. | None | None |
Actividad Guardar VM de estado
Esta actividad de Service Manager guarda el estado de una máquina virtual y, después, detiene la máquina virtual.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrate de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Active Directory Domain Services (AD DS). |
Propiedades
La actividad Guardar VM de estado usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Variable de trabajo | JobVariable | Cadena | No | Especifica que el progreso del trabajo se rastrea y se almacena en la variable nombrada por este parámetro. |
| Grupo de administración | ManagementGroup | Cadena | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establécelo en localhost. (Solo lectura) |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia de Optimización de rendimientos y recursos (PRO) que ha desencadenado esta acción. Permite futuras auditorías de sugerencias de PRO. |
| Ejecución asincrónica | RunAsynchronously | Booleano | No. (El valor predeterminado es False). | Especifica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente. |
| Servidor de scripts | Destino | Cadena | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Id. de VM | VMID | Cadena | Sí | Especifica el identificador único de la máquina virtual que se va a guardar. |
| Servidor VMM | VMMServer | Cadena | Sí | Especifica el nombre del servidor de System Center Virtual Machine Manager (VMM) que administra las máquinas virtuales. |
La actividad Guardar VM de estado genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Id. de VM | VMID | Cadena | Especifica el identificador único de la máquina virtual que se ha guardado. El Id. de máquina virtual de entrada y el Id. de máquina virtual de salida son iguales a menos que la actividad no consiga encontrar una máquina virtual con un Id. de máquina virtual que coincida con el Id. de máquina virtual de entrada. En ese caso, el Id. de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Guardar VM de estado usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | None | None |
Actividades de script
Usa una actividad de script de Service Manager para ejecutar un script como parte de un flujo de trabajo.
Las actividades de script se ejecutan como un proceso independiente de los flujos de trabajo; pero también se ejecutan en el contexto de seguridad de la cuenta de flujo de trabajo de Service Manager.
Service Manager Authoring Tool proporciona las tres actividades de script predeterminadas siguientes en el subgrupo Actividades de script genéricas del grupo Actividades de script en el panel Cuadro de herramientas de actividades.
Actividad Script de comando
Esta actividad ejecuta un script de la línea de comandos como parte de un flujo de trabajo de Windows Workflow Foundation (WF).
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Script de comando usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Grupo de administración | ManagementGroupName | Cadena | No | Especifica el grupo de administración al que pertenece el servidor de scripts. De forma predeterminada, este valor se establece en localhost. (Solo lectura) |
| Parámetros de script | Parámetros | Diccionario <string,string> | Sí | Especifica los conmutadores de la línea de comandos o los pares de conmutador/valor que se pasarán al script cuando se ejecuta. |
| Cuerpo del script | ScriptBody | Cadena | Sí | Especifica el texto del propio script. |
| Servidor de scripts | Destino | Cadena | No | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute el script. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Script de comando usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | None | None |
Actividad Script de Windows PowerShell
Esta actividad de Service Manager ejecuta un script de Windows PowerShell como parte de un flujo de trabajo de Windows Workflow Foundation (WF).
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| La actividad Script de Windows PowerShell depende de los siguientes requisitos previos en tiempo de diseño: - Windows PowerShell 2.0 |
Windows PowerShell 2.0 |
Propiedades
La actividad Script de Windows PowerShell usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Grupo de administración | ManagementGroupName | Cadena | No | Especifica el grupo de administración al que pertenece el servidor de scripts. De forma predeterminada, este valor se establece en localhost. (Solo lectura) |
| Parámetros de script | Parámetros | Diccionario <string,string> | Sí | Especifica la lista de nombres y valores de los parámetros que se van a pasar al script cuando se ejecuta. Puedes establecer valores de parámetro en cualquiera de las siguientes referencias del módulo de administración: - $Target/...$ - $MPElement[...] - $Data/...$. Las referencias de $Data solo se resuelven en tiempo de ejecución en los parámetros (no en el propio script). El uso de una de estas referencias como único valor de un parámetro establece ese parámetro en la cadena XML que representa el elemento de datos de entrada (de GetItemXML). |
| Cuerpo del script | ScriptBody | Cadena | Sí | Especifica el texto del propio script. |
| Complementos | Snapins | Cadena | No | Enumera los complementos de Windows PowerShell que se deben cargar previamente en el espacio de ejecución. |
| Servidor de scripts | Destino | Cadena | No | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute el script. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Script de Windows PowerShell usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | Para más información sobre Windows PowerShell, consulta Windows PowerShellGet | None |
Actividad Script de VBScript
Esta actividad de Service Manager ejecuta un script VBScript como parte de un flujo de trabajo de Windows Workflow Foundation (WF).
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| La actividad Script de VBScript depende de los siguientes requisitos previos en tiempo de diseño: Ninguno. |
None |
Propiedades
La actividad Script de VBScript usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es True). | Determina si el flujo de trabajo continúa ejecutándose si se produce un error en la actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un conjunto de errores. (Solo lectura) | |
| Grupo de administración | ManagementGroupName | Cadena | No | Especifica el grupo de administración al que pertenece el servidor de scripts. (De forma predeterminada, se establece en localhost) (solo lectura) |
| Parámetros de script | Parámetros | Diccionario <string,string> | Sí | Proporciona la lista de conmutadores estándar y los valores asociados que usa este script cuando se ejecuta. |
| Cuerpo del script | ScriptBody | Cadena | Sí | Especifica el texto del propio script. |
| Servidor de scripts | Destino | Cadena | No | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No uses localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute el script. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Script de VBScript usa el servicio de seguimiento personalizado que suministra Service Manager para registrar errores y excepciones cuando se ejecuta la actividad. La actividad genera errores o excepciones según corresponda si no se puede resolver alguna de las propiedades del script. | None | None |
Actividades de Service Manager
Usa las actividades de Service Manager en Service Manager para que las funciones de Service Manager formen parte del flujo de trabajo.
Service Manager Authoring Tool proporciona las siguientes cuatro actividades predeterminadas de Service Manager en el grupo Actividades de SM del panel Cuadro de herramientas de actividades.
Actividad Crear incidente
Esta actividad crea y rellena un incidente en Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Crear incidente usa las propiedades de entrada que se enumeran en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Comentarios |
|---|---|---|---|---|
| Id. de incidente | IncidentID | Cadena | Sí | Especifica el identificador único que se genera para el objeto Incidente. |
| Comentario del registro de acciones | ActionLogComment | Cadena | Sí | Especifica el comentario que se va a incluir en el registro de acciones del objeto Incidente. |
| Dominio del usuario afectado | AffectedUserDomain | Cadena | Sí | Especifica el nombre del dominio del Sistema de nombres de dominio (DNS) del usuario principal afectado por el incidente. |
| Nombre de usuario afectado | AffectedUserName | Cadena | Sí | Especifica el nombre de usuario del usuario principal afectado por el incidente. |
| Category | Category | Entero | Sí | Especifica el tipo de incidente, como Redes o Impresión. El valor es el identificador de enumeración. (Categoría - campo de datos enumeración) |
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es verdadero). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Impacto | Impacto | Entero | Sí | Especifica el impacto del incidente en el usuario o los usuarios afectados. El valor es el identificador de enumeración. (Impacto - tipo de datos de enumeración) |
| Source | Source | Entero | No | Especifica el origen de información sobre el incidente, como Teléfono o Correo electrónico. El valor es el identificador de enumeración. (Origen - campo de tipo de datos de enumeración) |
| Resumen | Resumen | Cadena | Sí | Especifica el texto de resumen que describe el incidente. |
| Urgencia | Urgencia | Entero | Sí | Especifica la urgencia de resolver el incidente. El valor es el identificador de enumeración. (Urgencia - campo de tipo de datos de enumeración) |
La actividad Crear incidente genera la salida que se describe en la tabla siguiente.
| Nombre | Tipo | Comentarios |
|---|---|---|
| Incidente de SM | System.WorkItem.Incident | Devuelve la instancia de clase de incidente construida. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Actividad Obtener incidente
Esta actividad recupera uno o varios incidentes en Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Obtener incidente usa las propiedades de entrada que se enumeran en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Comentarios |
|---|---|---|---|---|
| Dominio del usuario afectado | AffectedUserDomain | Cadena | No | Especifica el nombre del dominio del Sistema de nombres de dominio (DNS) del usuario principal afectado por el incidente. |
| Nombre de usuario afectado | AffectedUserName | Cadena | No | Especifica el nombre de usuario del usuario principal afectado por el incidente. |
| Category | Category | Entero | No | Especifica el tipo de incidente, como Redes o Impresión. El valor es el identificador de enumeración. (Categoría - campo de datos enumeración) |
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es verdadero). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Id. de incidente | IncidentID | Cadena | No | Especifica el identificador único que se genera para el objeto del incidente. |
| Tipo de búsqueda | SearchType | Entero | No | Especifica el título del tipo de búsqueda que se usa con la actividad. |
| Estado | Estado | Entero | No | Especifica el estado del incidente. El valor es el identificador de enumeración. (Estado - campo de datos de enumeración) |
| Texto de resumen | SummaryText | Cadena | No | Especifica el texto de resumen que describe el incidente. |
La actividad Obtener incidente genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Incidentes de SM | SMIncidents | Matriz de System.Workitem.Incident | Especifica una matriz de objetos de incidente. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | La actividad Obtener incidente tiene su propio validador para realizar la validación de errores en las propiedades de entrada. | None |
Actividad Actualizar incidente
Esta actividad de Service Manager guarda los cambios de la propiedad en un incidente de Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Actualizar incidente usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Comentario del registro de acciones | ActionLogComment | Cadena | No | Especifica un comentario que se va a incluir en el registro de acciones del objeto Incidente. |
| Dominio del usuario afectado | AffectedUserDomain | Cadena | No | Especifica el nombre del dominio del Sistema de nombres de dominio (DNS) del usuario principal afectado por el incidente. |
| Nombre de usuario afectado | AffectedUserName | Cadena | No | Especifica el nombre de usuario del usuario principal afectado por el incidente. |
| Category | Category | Entero | No | Especifica el tipo de incidente, como Redes o Impresión. El valor es el identificador de enumeración. (Categoría - tipo de datos de enumeración) |
| Continuar después de un error | ContinueOnError | Booleano | No. (El valor predeterminado es verdadero). | Determina si el flujo de trabajo debe seguir ejecutándose si se produce un error en la actividad. |
| Impacto | Impacto | Entero | No | Especifica el impacto del incidente en el usuario o los usuarios afectados. El valor es el identificador de enumeración. (Impacto - tipo de datos de enumeración) |
| Source | Source | Entero | No | Especifica el origen de información sobre el incidente, como Teléfono o Correo electrónico. El valor es el identificador de enumeración. (Origen - tipo de datos de enumeración ) |
| Incidente de Service Manager | SMIncident | System.Workitem.Incident | No | La instancia de clase de incidente construida que se va a actualizar. |
| Estado | Estado | Entero | No | Especifica el estado del incidente que generó la actividad. El valor es el identificador de enumeración. (Estado - tipo de datos de enumeración) |
| Resumen | Resumen | Cadena | No | Especifica el texto de resumen que describe el incidente. |
| Urgencia | Urgencia | Entero | No | Especifica la urgencia de resolver el incidente. El valor es el identificador de enumeración. (Urgencia - campo de tipo de datos de enumeración) |
La actividad Actualizar incidente genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Descripción |
|---|---|---|---|
| Incidente de SM | SMIncident | System.WorkItem.Incident | Devuelve una actualización de la instancia de la clase de incidente. El Incidente de SM de entrada y el Incidente de SM de salida son iguales a menos que la actividad no consiga encontrar el Incidente de SM. En ese caso, el Incidente de SM de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Actividad Establecer estado de actividad en Completado
Esta actividad actualiza el estado de una actividad automatizada en Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos de tiempo de ejecución |
|---|---|
| None | Ninguno. |
Propiedades
La actividad Establecer estado de actividad en Completado usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Identificador de actividad | Identificador de actividad | Cadena | Sí | Especifica el identificador de un objeto de actividad automatizada de Service Manager. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | Cuando uses esta actividad en un flujo de trabajo desencadenado por una actividad automatizada de Service Manager, escribe $Data/BaseManagedEntityId$ como el valor de esta propiedad. Este valor se aplica a la actividad Establecer el estado de actividad como completado en la actividad automatizada que desencadenó el flujo de trabajo que se va a ejecutar. | None |