Referencia de actividad de flujo de trabajo de Service Manager Authoring Tool
Importante
Esta versión de Service Manager ha llegado al final del soporte técnico. Se recomienda actualizar a Service Manager 2022.
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 de WF personalizadas 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 actividades de flujo de trabajo de este documento ofrece detalles de las actividades WF predeterminadas de la biblioteca de actividades. Esta información pretende ayudar a los desarrolladores (o a los profesionales de TI que actúan como desarrolladores) a crear actividades WF personalizadas, cuando sea necesario.
Para obtener información sobre cómo usar las actividades de WF y los flujos de trabajo de WF con Service Manager, consulte Automatización de procesos de TI con flujos de trabajo.
Actividades de Active Directory
Use actividades de 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 de Service Manager predeterminadas 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 tenga permisos suficientes para modificar los grupos de seguridad en AD DS. |
Propiedades
La actividad Agregar equipo de Active Directory Domain Services (AD DS) al grupo utiliza las propiedades de entrada descritas en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Dominio del equipo | ComputerDomain | String | Sí | Nombre de dominio DNS completo donde se encuentra el equipo (por ejemplo, contoso.com). |
| Nombre del equipo | FullyQualifiedComputerName | String | Sí | Nombre del equipo. |
| Nombre del grupo | FullyQualifiedGroupName | String | Sí | Nombre del grupo de Active Directory Domain Services. |
La actividad Agregar equipo de Active Directory Domain Services (AD DS) al grupo genera el resultado descrito en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Descripción |
|---|---|---|---|
| Resultados | Resultados | Boolean | 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; se busca en todos los contenedores en el 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 tenga permisos suficientes para modificar los 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 | Requerido | Descripción |
|---|---|---|---|---|
| Dominio del usuario | UserDomain | String | Sí | Nombre de dominio completo del usuario. |
| Nombre de usuario | UserName | String | Sí | Nombre de inicio de sesión del usuario. |
| Nombre del grupo | FullyQualifiedGroupName | String | Sí | Nombre de dominio completo del grupo. |
La actividad Agregar usuario de AD DS a grupo genera la salida que se describe en la tabla siguiente.
| Display Name (Nombre para mostrar) | Nombre interno | Tipo | Descripción |
|---|---|---|---|
| Resultados | Resultados | Boolean | 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 estructura (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 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 | Requerido | 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 |
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 itera cinco veces. Si la colección está vacía, el bucle no itera. 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. Establezca las siguientes propiedades en cada actividad del contenedor de bucles:
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 Current Item .
Dos tipos de actividades no obtienen las propiedades Current Item y Property to Bind 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 basadas en la clase base Activity , 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 De bucle For Each usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Colección de entrada | InputCollection | Matriz u objeto | N/D | Colección de objetos que se van a pasar, de uno en 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 en el 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 siguientes condiciones: - 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 dentro de 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 itera. 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 de un flujo de trabajo en función de una condición booleana (verdadero/falso). Puede utilizar el resultado de una actividad anterior, como una actividad de un 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 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 , vea IfElseActivity (clase) en la biblioteca de clases de .NET Framework 4. | None |
Actividad paralela
Esta actividad bifurca la secuencia de actividades en dos secuencias de actividades simultáneas. 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 de 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 de 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 tenga 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 tenga 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 | Requerido | Descripción |
|---|---|---|---|---|
| Conjunto de parámetros | ParameterSet | String | 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: - Todo: 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 designada por la propiedad Host de máquina virtual . |
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| All | All | Boolean | 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 | ID | String | 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 | Grupo de administración | String | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establezca en localhost. (solo lectura). |
| Servidor de script | Destino | String | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se deja para que la actividad se ejecute. |
| Host de VM | VMHost | String | 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 | String | No | Especifica el nombre o parte del nombre de la máquina virtual que se busca. 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 | String | 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 |
|---|---|---|---|
| Id. de VM | VMIDList | Matriz de cadenas | Especifica la lista de los identificadores de las máquinas virtuales con nombres que coinciden con toda o parte de la cadena de nombre de máquina virtual . |
| 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 alguna de las propiedades del script no se puede resolver. | 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 tenga 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 | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Bloquear migración en vivo si el host está ocupado | BlockLMIfHostBusy | Boolean | No. (El valor predeterminado es False). | Bloquea el reintento de una migración en vivo de Hyper-V cuando se produce un error en la migración porque el host de origen o el de destino está participando en otra migración en vivo. |
| 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 | String | No | Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro. |
| Grupo de administración | Grupo de administración | String | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establezca en localhost. (solo lectura). |
| Ruta de acceso | Ruta de acceso | String | 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 rendimiento y recursos (PRO) que desencadenó esta acción. Permite realizar auditorías de las sugerencias PRO posteriormente. |
| Ejecutar de forma asincrónica | RunAsynchronously | Boolean | 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 script | Destino | String | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se deja para que la actividad se ejecute. |
| Iniciar VM en destino | StartVMOnTarget | Boolean | No. (El valor predeterminado es False). | Especifica que la máquina virtual se inicia al llegar al host de destino. |
| Utilice el clúster | UseCluster | Boolean | No. (El valor predeterminado es False). | Fuerza el uso de la migración de clúster de Windows Server 2008 para la transferencia de una máquina virtual que está en un estado guardado en un host, aunque el clúster admita la migración en vivo de Hyper-V. |
| Usar LAN | UseLan | Boolean | No. (El valor predeterminado es False). | Fuerza una transferencia a través de la red de área local (LAN) aunque esté disponible un mecanismo más rápido, como una transferencia por red de área de almacenamiento (SAN). |
| Host de VM | VMHostName | String | Sí | Especifica el nombre del host de mantenimiento al que se va a mover la máquina virtual. |
| Id. de VM | VMID | String | Sí | Especifica el identificador único de la máquina virtual que se va a mover. |
| Servidor VMM | VMMServer | String | 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 | String | 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 máquina virtual de apagado
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. En una máquina virtual implementada en un host de Hyper-V, el servicio del sistema invitado de virtualización se denomina Componentes de integración. En una máquina virtual implementada en un host de Virtual Server, el servicio de sistema invitado de virtualización se denomina Virtual Machine Additions.
| 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úrese de que la cuenta de flujo de trabajo de Service Manager tenga 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 | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Variable de trabajo | JobVariable | String | No | Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro. |
| Grupo de administración | Grupo de administración | String | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establezca en localhost. (solo lectura). |
| PROTipID | PROTipID | Guid | No | Especifica el identificador de la sugerencia de Optimización de rendimiento y recursos (PRO) que desencadenó esta acción. Permite realizar auditorías de las sugerencias PRO posteriormente. |
| Ejecutar de forma asincrónica | RunAsynchronously | Boolean | 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 script | Destino | String | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use Localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se deja para que la actividad se ejecute. |
| Id. de VM | VMID | String | Sí | Especifica el identificador único de la máquina virtual que se va a cerrar. |
| VMMServer | VMMServer | String | 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 | String | Especifica el identificador único de la máquina virtual que se ha cerrado. 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 alguna de las propiedades del script no se puede resolver. | 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 | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Variable de trabajo | JobVariable | String | No | Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro. |
| Grupo de administración | Grupo de administración | String | No | El grupo de administración en el que se ejecutará esta actividad. Establezca en localhost. (solo lectura). |
| PROTipID | PROTipID | Guid | No | Especifica el identificador de la sugerencia de Optimización de rendimiento y recursos (PRO) que desencadenó esta acción. Permite realizar auditorías de las sugerencias PRO posteriormente. |
| Ejecutar de forma asincrónica | RunAsynchronously | Boolean | 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 script | Destino | String | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se deja para que la actividad se ejecute. |
| Id. de VM | VMID | String | Sí | Especifica el identificador único de la máquina virtual que se va a iniciar. |
| VMMServer | VMMServer | String | 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.
| Display Name (Nombre para mostrar) | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Id. de VM | VMID | String | Especifica el identificador único de la máquina virtual que se ha iniciado. 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 |
Guardar actividad de 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 de 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 tenga permisos suficientes para modificar grupos de seguridad en Servicios de dominio de Active Directory (AD DS). |
Propiedades
La actividad Guardar máquina virtual de estado usa las propiedades de entrada que se describen en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Variable de trabajo | JobVariable | String | No | Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro. |
| Grupo de administración | Grupo de administración | String | No | Especifica el grupo de administración en el que se ejecutará esta actividad. Establezca en localhost. (solo lectura). |
| PROTipID | PROTipID | Guid | No | Especifica el identificador de la sugerencia de Optimización de rendimiento y recursos (PRO) que desencadenó esta acción. Permite realizar auditorías de las sugerencias PRO posteriormente. |
| Ejecutar de forma asincrónica | RunAsynchronously | Boolean | 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 script | Destino | String | Sí | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos que se deja para que la actividad se ejecute. |
| Id. de VM | VMID | String | Sí | Especifica el identificador único de la máquina virtual que se va a guardar. |
| Servidor VMM | VMMServer | String | Sí | Especifica el nombre del servidor de System Center Virtual Machine Manager (VMM) que administra las máquinas virtuales. |
La actividad Guardar máquina virtual de estado genera la salida que se describe en la tabla siguiente.
| Nombre para mostrar | Nombre interno | Tipo | Comentarios |
|---|---|---|---|
| Id. de VM | VMID | String | 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 Guardar máquina virtual de estado 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 alguna de las propiedades del script no se puede resolver. | 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 | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Grupo de administración | ManagementGroupName | String | No | Especifica el grupo de administración al que pertenece el servidor de script. De forma predeterminada, se establece en localhost. (solo lectura). |
| Parámetros de script | Parámetros | Dictionary <string,string> | Sí | Especifica los modificadores de línea de comandos o los pares de valor/modificador que se van a pasar al script cuando se ejecuta. |
| Cuerpo de script | ScriptBody | String | Sí | Especifica el texto del mismo script. |
| Servidor de script | Destino | String | No | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos del script que se va a ejecutar. |
| 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 alguna de las propiedades del script no se puede resolver. | 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 | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Grupo de administración | ManagementGroupName | String | No | Especifica el grupo de administración al que pertenece el servidor de script. De forma predeterminada, se establece en localhost. (solo lectura). |
| Parámetros de script | Parámetros | Dictionary <string,string> | Sí | Especifica la lista de nombre y valor de parámetros que se pasan al script cuando se ejecuta. Puede establecer valores de parámetro a cualquiera de las siguientes referencias del módulo de administración: - $Target/...$ - $MPElement[...] - $Data/...$. Las referencias de $Data se resuelven en tiempo de ejecución en los parámetros (no en el mismo script). Con 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 de script | ScriptBody | String | Sí | Especifica el texto del mismo script. |
| Complementos | SnapIns | String | No | Listas Windows PowerShell complementos para cargar previamente en el espacio de ejecución. |
| Servidor de script | Destino | String | No | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos del script que se va a ejecutar. |
| 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 alguna de las propiedades del script no se puede resolver. | 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 VbScript Script depende de los siguientes requisitos previos en tiempo de diseño: Ninguno. |
None |
Propiedades
La actividad VbScript Script usa las propiedades de entrada que se describen en la tabla siguiente.
| Display Name (Nombre para mostrar) | Nombre interno | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo continúa ejecutándose si se produce un error en esta actividad. |
| Tiene un error | HasError | N/D | Especifica si la actividad tiene un error establecido (solo lectura). | |
| Grupo de administración | ManagementGroupName | String | No | Especifica el grupo de administración al que pertenece el servidor de script. (De forma predeterminada, se establece en localhost) (Solo lectura) |
| Parámetros de script | Parámetros | Dictionary <string,string> | Sí | Proporciona la lista de modificadores estándar y valores asociados que este script utiliza al ejecutarse. |
| Cuerpo de script | ScriptBody | String | Sí | Especifica el texto del mismo script. |
| Servidor de script | Destino | String | No | Especifica el nombre del Sistema de nombres de dominio (DNS) del servidor que ejecuta la consola de Service Manager. No use localhost. |
| Duración máxima de script | TimeoutSeconds | Entero | No. (El valor predeterminado es 300 segundos). | Especifica el número máximo de segundos del script que se va a ejecutar. |
| Errores y excepciones | Comentarios | Ejemplo |
|---|---|---|
| La actividad de 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 alguna de las propiedades del script no se puede resolver. | None | None |
Actividades de Service Manager
Use Service Manager actividades 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 cuatro actividades predeterminadas de Service Manager siguientes en el grupo Actividades de SM en el panel Cuadro de herramientas de actividades.
Creación de una actividad de incidente
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 |
|---|---|---|---|---|
| Identificador de incidente | IncidentID | String | Sí | Especifica el identificador único que se genera para el objeto Incident . |
| Comentario de registro de acciones | ActionLogComment | String | Sí | Especifica el comentario que se va a incluir en el registro de acciones del objeto Incident . |
| Dominio de usuario afectado | AffectedUserDomain | String | Sí | Especifica el nombre del dominio del Sistema de nombres de dominio (DNS) del usuario primario afectado por el incidente. |
| Nombre de usuario afectado | AffectedUserName | String | Sí | Especifica el nombre de usuario del usuario primario afectado por el incidente. |
| Category | Category | Entero | Sí | Especifica el tipo de incidente, como Redes o Impresión. El valor es el identificador de la enumeración. (Campo de datos categoría -enumeración ) |
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Impacto | Impacto | Entero | Sí | Especifica el impacto del incidente en el usuario o usuarios afectados. El valor es el identificador de la enumeración. (Tipo de datos impact -enum ) |
| 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 la enumeración. (Campo de tipo de datos Source -enum ) |
| Resumen | Resumen | String | Sí | Especifica el texto de resumen que describe el incidente. |
| Urgencia | Urgencia | Entero | Sí | Especifica la urgencia de resolución del incidente. El valor es el identificador de la enumeración. (Campo de tipo de datos 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 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 de usuario afectado | AffectedUserDomain | String | No | Especifica el nombre del dominio del Sistema de nombres de dominio (DNS) del usuario primario afectado por el incidente. |
| Nombre de usuario afectado | AffectedUserName | String | No | Especifica el nombre de usuario del usuario primario afectado por el incidente. |
| Category | Category | Entero | No | Especifica el tipo de incidente, como Redes o Impresión. El valor es el identificador de la enumeración. (Campo de datos categoría -enumeración ) |
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Identificador de incidente | IncidentID | String | No | Especifica el identificador único que se genera para el objeto Incidente. |
| Tipo de búsqueda | SearchType | Integer | No | Especifica el título del tipo de búsqueda que se utiliza con la actividad. |
| Estado | Estado | Entero | No | Especifica el estado del incidente. El valor es el identificador de la enumeración. (Campo de datos Status -enum ) |
| Texto de resumen | SummaryText | String | 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 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 |
Actualizar actividad 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 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 | Requerido | Descripción |
|---|---|---|---|---|
| Comentario de registro de acciones | ActionLogComment | String | No | Especifica un comentario que se va a incluir en el registro de acciones del objeto Incident. |
| Dominio de usuario afectado | AffectedUserDomain | String | No | Especifica el nombre del dominio del Sistema de nombres de dominio (DNS) del usuario primario afectado por el incidente. |
| Nombre de usuario afectado | AffectedUserName | String | No | Especifica el nombre de usuario del usuario primario afectado por el incidente. |
| Category | Category | Entero | No | Especifica el tipo de incidente, como Redes o Impresión. El valor es el identificador de la enumeración. (Tipo de datos Category -enum ) |
| Continuar después de un error | ContinueOnError | Boolean | No. (El valor predeterminado es True). | Determina si el flujo de trabajo debe continuar la ejecución si se produce un error en esta actividad. |
| Impacto | Impacto | Entero | No | Especifica el impacto del incidente en el usuario o usuarios afectados. El valor es el identificador de la enumeración. (Tipo de datos impact -enum ) |
| 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 la enumeración. (Tipo de datos source -enum ) |
| Incidente de Service Manager | SMIncident | System.Workitem.Incident | No | Instancia de clase de incidente construida que se actualizará. |
| Estado | Estado | Entero | No | Especifica el estado del incidente que generó la actividad. El valor es el identificador de la enumeración. (Tipo de datos Status -enum ) |
| Resumen | Resumen | String | No | Especifica el texto de resumen que describe el incidente. |
| Urgencia | Urgencia | Entero | No | Especifica la urgencia de resolución del incidente. El valor es el identificador de la enumeración. (Campo de tipo de datos 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 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 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 |
|---|---|
| Ninguno | 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 | Requerido | Descripción |
|---|---|---|---|---|
| Identificador de actividad | Identificador de actividad | String | 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