Referencia de actividad de flujo de trabajo de La herramienta de creación de Service Manager
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 la herramienta de creación de Service Manager. 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, según sea necesario.
Para obtener información sobre cómo usar actividades de WF y flujos de trabajo de WF con Service Manager, consulte Automatización de procesos de TI con flujos de trabajo.
Actividades de Active Directory
Use Servicios de dominio de Active Directory (AD DS) para que las funciones de Active Directory formen parte del flujo de trabajo en Service Manager.
La herramienta de creación de Service Manager 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 en tiempo de ejecución |
|---|---|
| None | Al usar esta actividad, asegúrese 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 de equipo | ComputerDomain | Cadena | Sí | 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í | Nombre del grupo de 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 |
Agregar usuario de AD DS a la actividad de grupo
Esta actividad agrega un usuario a un grupo de seguridad en Servicios de dominio de Active Directory (AD DS) en Service Manager. El usuario 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 en tiempo de ejecución |
|---|---|
| None | Al usar esta actividad, asegúrese 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 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í | Nombre de dominio completo (FQDN) del usuario. |
| Nombre de usuario | UserName | Cadena | Sí | Nombre de inicio de sesión del usuario. |
| Nombre de grupo | FullyQualifiedGroupName | Cadena | Sí | FQDN del grupo. |
La actividad Agregar usuario de AD DS a grupo genera la salida que se describe en la tabla siguiente.
| Nombre | 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 |
Actividades de Flujo de control
Use 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 de retraso
Esta actividad presenta 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 en 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 esta actividad, vea Clase DelayActivity en la biblioteca de clases de .NET Framework. | None |
Para cada actividad de bucle
La actividad Bucle For Each 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 De bucle For Each siempre se ejecuta en el equipo en el que se ejecuta el flujo de trabajo.
La actividad de bucle For Each es una actividad compuesta con dos contenedores para las actividades:
Contenedor de entrada: esta actividad configura el bucle y define la colección de entrada. Puede usar la actividad Obtener incidente o Obtener máquina virtual en este rol.
Contenedor de bucles: denominado 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, establezca estas propiedades de la siguiente manera:
Establezca Elemento actual en la propiedad Elemento actual de la actividad Contenedor de bucles de la actividad ForEach . Si esta actividad es la primera actividad de la actividad De bucle For Each, el elemento actual se establece automáticamente.
Establezca el valor de la propiedad Property en Bind 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 en 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 Activity , como las actividades nativas de Visual Studio.
| Requisitos previos de tiempo de diseño | Requisitos previos en tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Bucle For Each usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Colección de entrada | 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 De bucle For Each. Si la actividad que reside en el contenedor de entrada genera una matriz de objetos como su propiedad de salida, Input Collection se establece automáticamente en esa propiedad. Para ver el valor actual de esta propiedad, haga clic con el botón derecho en el contenedor de bucles y seleccione Propiedades. |
| Elemento actual | CurrentItem | Object | N/D | Índice en la colección de entrada 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 De bucle For Each 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 ForEachLoop 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 de bucle For Each debe escribir sus propios errores o excepciones en el servicio de seguimiento personalizado. La actividad De bucle For Each 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). Puede 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), vea Tutorial: Usar reglas y condiciones en WF en MSDN Library.
| Requisitos previos de tiempo de diseño | Requisitos previos en tiempo de ejecución |
|---|---|
| None | None |
Propiedades
Ninguno.
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | Para obtener más información sobre la actividad IfElse , vea 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 , vea Clase ParallelActivity en la biblioteca de clases de .NET Framework.
| Requisitos previos de tiempo de diseño | Requisitos previos en tiempo de ejecución |
|---|---|
| None | None |
Propiedades
Ninguno.
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Actividades de Virtual Machine Manager
Use actividades de administración de máquinas virtuales en Service Manager para crear flujos de trabajo que permitan crear y actualizar máquinas virtuales. Las actividades de administración de máquinas virtuales admiten System Center Virtual Machine Manager.
La herramienta de creación de Service Manager proporciona las cinco actividades de administración de máquinas virtuales predeterminadas siguientes en el grupo Actividades de VMM en el panel Cuadro de herramientas de actividades.
Obtención de la actividad de máquina virtual
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 en tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrese de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Servicios de dominio de Active Directory (AD DS). - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrese de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Servicios de dominio de Active Directory (AD DS). |
Propiedades
La actividad Obtener máquina virtual usa las propiedades de entrada de la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Conjunto de parámetros | ParameterSet | Cadena | No; el valor predeterminado es Connection. | Especifica un subconjunto de parámetros organizados para un propósito determinado. Para la actividad Obtener máquina virtual , puede seleccionar uno de los siguientes conjuntos de parámetros: - All: busque todas las máquinas virtuales disponibles. - Id. : busque una máquina virtual con un identificador conocido. - Conexión: busque máquinas virtuales conectadas al servidor de Virtual Machine Manager (VMM) designado por la propiedad VMMServer . - VMHostGroup: busque máquinas virtuales conectadas al host de máquina virtual designado por la propiedad Host de máquina virtual. |
| Continuar con el 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 de parámetros es All. Si se establece en True, la actividad Obtener máquina virtual 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 de parámetros es id. Si se establece en True, la actividad Obtener máquina virtual 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ézcalo 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Host de máquina virtual | 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 máquina virtual 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 contienen la cadena. |
| 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 máquina virtual genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Identificadores de máquina virtual | VMIDList | Matriz de cadenas | Especifica la lista de identificadores de las máquinas virtuales con nombres que coinciden con la cadena nombre de máquina virtual o parte de ella. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Obtener máquina virtual 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 |
Movimiento de la actividad de máquina virtual
Esta actividad en 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 en tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrese de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Servicios de dominio de Active Directory (AD DS). |
Propiedades
La actividad Mover máquina virtual usa las propiedades de entrada de la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar con el 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 vivo de Hyper-V si se produjo un error en la migración porque el host de origen o el host de destino ya participan en otra migración en vivo. |
| Grupo de trabajos | 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 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ézcalo 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 Optimización de recursos y rendimiento (PRO) que desencadenó esta acción. Permite futuras auditorías de sugerencias PRO. |
| Ejecutar de forma 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 300 segundos). | Especifica el número máximo de segundos que se va a permitir que se ejecute la actividad. |
| Inicio de la máquina virtual 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. |
| Uso del 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. |
| Uso de 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 máquina virtual | 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 máquina virtual 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 identificador de máquina virtual de entrada y el identificador de máquina virtual de salida son iguales a menos que la actividad no encuentre una máquina virtual con un identificador de máquina virtual que coincida con el identificador de máquina virtual de entrada. En ese caso, el identificador de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Mover máquina virtual 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 de apagado de máquina virtual
Esta actividad en Service Manager apaga el sistema operativo invitado en una máquina virtual.
Puede usar la actividad Apagar máquina virtual 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 en tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrese de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Servicios de dominio de Active Directory (AD DS). |
Propiedades
La actividad Apagar máquina virtual usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar con el 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 se realiza un seguimiento del progreso del trabajo y 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ézcalo en localhost. (Solo lectura) |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia Optimización de recursos y rendimiento (PRO) que desencadenó esta acción. Permite futuras auditorías de sugerencias PRO. |
| Ejecutar de forma 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 use Localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 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 Apagar máquina virtual 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 cerró. El identificador de máquina virtual de entrada y el identificador de máquina virtual de salida son iguales a menos que la actividad no encuentre una máquina virtual con un identificador de máquina virtual que coincida con el identificador de máquina virtual de entrada. En ese caso, el identificador de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Apagar máquina virtual 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 |
Iniciar actividad de máquina virtual
Esta actividad en Service Manager inicia una máquina virtual detenida o en pausa.
| Requisitos previos de tiempo de diseño | Requisitos previos en tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Iniciar máquina virtual usa las propiedades de entrada de la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar con el 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 se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro. |
| Grupo de administración | ManagementGroup | Cadena | No | Grupo de administración en el que se ejecutará esta actividad. Establézcalo en localhost. (Solo lectura) |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia Optimización de recursos y rendimiento (PRO) que desencadenó esta acción. Permite futuras auditorías de sugerencias PRO. |
| Ejecutar de forma 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 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 máquina virtual 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 inició. El identificador de máquina virtual de entrada y el identificador de máquina virtual de salida son iguales a menos que la actividad no encuentre una máquina virtual con un identificador de máquina virtual que coincida con el identificador de máquina virtual de entrada. En ese caso, el identificador de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Iniciar máquina virtual 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 guardar máquina virtual de estado
Esta actividad en Service Manager guarda el estado de una máquina virtual y, a continuación, detiene la máquina virtual.
| Requisitos previos de tiempo de diseño | Requisitos previos en tiempo de ejecución |
|---|---|
| None | - La consola de Virtual Machine Manager y Service Manager deben estar instaladas en el mismo servidor. - Asegúrese de que la cuenta de flujo de trabajo de Service Manager tiene permisos suficientes para modificar grupos de seguridad en Servicios de dominio de Active Directory (AD DS). |
Propiedades
La actividad Save State VM usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar con el 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 se realiza un seguimiento del progreso del trabajo y 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ézcalo en localhost. (Solo lectura) |
| PROTipID | PROTipID | GUID | No | Especifica el identificador de la sugerencia Optimización de recursos y rendimiento (PRO) que desencadenó esta acción. Permite futuras auditorías de sugerencias PRO. |
| Ejecutar de forma 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 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 Save State 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 guardó. El identificador de máquina virtual de entrada y el identificador de máquina virtual de salida son iguales a menos que la actividad no encuentre una máquina virtual con un identificador de máquina virtual que coincida con el identificador de máquina virtual de entrada. En ese caso, el identificador de máquina virtual de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad Save State 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 |
Actividades de script
Use una actividad de script en 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; sin embargo, también se ejecutan en el contexto de seguridad de la cuenta de flujo de trabajo de Service Manager.
La herramienta de creación de Service Manager proporciona las tres actividades de script predeterminadas siguientes en el subgrupo Actividades de script genérico del grupo Actividades de script en el panel Cuadro de herramientas de actividades.
Actividad script de comandos
Esta actividad ejecuta un script de 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 en tiempo de ejecución |
|---|---|
| None | None |
Propiedades
La actividad Script de comandos usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| Continuar con el 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, se establece en localhost. (Solo lectura) |
| Parámetros de script | Parámetros | Cadena de diccionario,cadena <> | Sí | Especifica los modificadores de línea de comandos o los pares switch/value 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 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 comandos 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 de script de Windows PowerShell
Esta actividad en 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 en 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 con el 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, se establece en localhost. (Solo lectura) |
| Parámetros de script | Parámetros | Cadena de diccionario,cadena <> | Sí | Especifica la lista de nombres y valores de los parámetros que se van a pasar al script cuando se ejecuta. Puede establecer valores de parámetro en cualquiera de las siguientes referencias del módulo de administración: - $Target/...$ - $MPElement[...] - $Data/...$. $Data referencias solo se resuelven en tiempo de ejecución en los parámetros (no en el propio script). Usar una de estas referencias como el ú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 | Complementos | Cadena | No | Enumera los complementos de Windows PowerShell para 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 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 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. | Para obtener más información sobre Windows PowerShell, consulte Windows PowerShell. | None |
Actividad de script de VBScript
Esta actividad en 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 en 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 con el 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 | Cadena de diccionario,cadena <> | Sí | Proporciona la lista de modificadores 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 use localhost. |
| Límite de tiempo de script | TimeoutSeconds | Entero | No. (La configuración predeterminada es de 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 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 |
Actividades de Service Manager
Use actividades de Service Manager en Service Manager para que las funciones de Service Manager formen parte del flujo de trabajo.
La herramienta de creación de Service Manager proporciona las siguientes cuatro actividades predeterminadas de Service Manager en el grupo Actividades de SM en el panel Cuadro de herramientas de actividades.
Crear actividad de incidentes
Esta actividad crea y rellena un incidente en Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos en 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 Incident . |
| Comentario del registro de acciones | ActionLogComment | Cadena | Sí | Especifica el comentario que se va a incluir en el registro de acciones del objeto Incident . |
| Dominio de 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. (Campo de datos category -enum ) |
| Continuar con el 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. |
| 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. (Campo de tipo de datos source -enum ) |
| 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. (Campo de tipo de datos de urgencia -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 |
Obtener actividad de incidentes
Esta actividad recupera uno o varios incidentes en Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos en 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 de 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. (Campo de datos category -enum ) |
| Continuar con el 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 de 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. (Campo de datos Status -enum ) |
| 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 de actualización de incidentes
Esta actividad de Service Manager guarda los cambios de propiedad en un incidente de Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos en 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 Incident. |
| Dominio de 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. (Tipo de datos Category -enum ) |
| Continuar con el 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. |
| 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. (Tipo de datos source -enum ) |
| Incidente de Service Manager | SMIncident | System.Workitem.Incident | No | 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. (Tipo de datos Status -enum ) |
| 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. (Campo de tipo de datos de urgencia -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 clase de incidente. El incidente sm de entrada y el incidente sm de salida son iguales a menos que la actividad no encuentre el incidente de SM. En ese caso, el incidente sm de salida se establece en Null. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| None | None | None |
Establecer el estado de la actividad en Actividad completada
Esta actividad actualiza el estado de una actividad automatizada en Service Manager.
| Requisitos previos de tiempo de diseño | Requisitos previos en 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 use esta actividad en un flujo de trabajo desencadenado por una actividad automatizada de Service Manager, escriba $Data/BaseManagedEntityId$ como valor de esta propiedad. Este valor se aplica a la actividad Set Activity Status to Completed (Establecer estado de actividad en completado ) en la actividad automatizada que desencadenó el flujo de trabajo que se va a ejecutar. | None |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de