Acciones: Paso a paso

Este tema contiene instrucciones paso a paso para crear acciones de Edge Intelligence y vincularlas a una consulta o una alerta. También explica el uso de variables de acción, marcadores de posición y el uso de datos de consulta en su acción.

Prerrequisitos

El agente de Ivanti Neurons instalado en los endpoints que desea consultar o para los que desea establecer alertas. Consulte Agente de Ivanti Neurons.
- Los endpoints deben tener una Política con la Función Edge Intelligence activada. Consulte Funciones de la política del agente en la Política.
Un rol con permisos para configurar acciones, realizar acciones y establecer alertas para Edge Intelligence. Consulte Roles.

Crear una acción de consulta personalizada desde el panel de configuración de Edge Intelligence

En este ejemplo añadirá una acción a la consulta Estado de aplicación para desinstalar una aplicación. La acción utiliza un script de PowerShell, con un marcador de posición para la información recuperada por la consulta. Una vez desinstalada la aplicación, el usuario recibirá una notificación.

Vaya a Insights > Edge Intelligence, y haga clic en en la esquina superior derecha de la página.
Aparece el panel configuración de Edge Intelligence.
En la pestaña Acciones seleccione Añadir nueva acción.
La página Nueva acción se abre dentro del panel.
1. Especifique un Nombre para la acción, por ejemplo Desinstalar aplicación.
2. En la sección Variables seleccione Añadir nueva variable.
  Aparece el panel Nueva variable.
  1. Especifique un Nombre para la variable, por ejemplo Nombre.
    A efectos ilustrativos, los nombres especificados para las variables de este ejemplo son idénticos a los de las variables autogeneradas del ejemplo siguiente. Esto no es un requisito.
  2. No especifique un Valor. Esto lo proporcionará la consulta.
  3. Deje activada la opción Variable pública. Esto permite establecer el valor de la variable durante la ejecución de la acción.
  4. Haga clic en Guardar.
    La variable se guarda y se cierra el panel Nueva variable.
  5. Repita los pasos i a iv para crear variables para Versión y Proveedor.
3. En la sección Tareas seleccione Añadir nueva tarea.
  Aparece el panel Nueva tarea.
  1. Especifique un Nombre para la tarea, por ejemplo Desinstalar aplicación por nombre.
  2. En la sección inferior, haga clic en Seleccionar para ver una lista de las tareas disponibles. Seleccione Ejecutar PowerShell.
  3. En el campo Script que aparece, introduzca su script de PowerShell (borrador).
    Para este ejemplo:
    Copiar
    $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(var placeholder)'" $application.Uninstall()
    Si está seguro de la ortografía exacta del texto que debe sustituir a $(var placeholder), puede escribir o pegar directamente la versión final en el campo Script. En ese caso, puede pasar al paso vi.
  4. En la sección Marcadores de posición disponibles (bajo el campo Script ) copie $(action.Name) con . Esta es la variable Nombre que creó en el paso 2b.
  5. En el campo Script sustituya $(var placeholder) por el marcador que copió en el paso iv.
    El script debería tener ahora este aspecto:
    Copiar
    $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(action.Name)'" $application.Uninstall()
  6. Haga clic en Guardar.
    La tarea se guarda y se cierra el panel Tarea nueva.
4. En la sección Tareas seleccione de nuevo Añadir nueva tarea.
  Aparece el panel Nueva tarea.
  1. Especifique un Nombre para la tarea, por ejemplo Notificar al usuario final.
  2. En la sección inferior, haga clic en Seleccionar para ver una lista de las tareas disponibles. Seleccione Notificar al usuario.
  3. En el campo Asunto que aparece, escriba (por ejemplo) Aplicación desinstalada con éxito: $(action.Name).
    Los marcadores de posición aparecen de nuevo debajo de los campos específicos de la tarea del panel Nueva tarea, en este caso los campos Asunto y Mensaje.
  4. En el campo Mensaje escriba el cuerpo del mensaje que desee enviar al usuario. Por ejemplo:
    Estimado usuario:
    
    La aplicación siguiente se ha desinstalado correctamente:
    $(action.Name)
    $(action.Vendor)
    $(action.Version)
    
    Saludos cordiales,
    El equipo de TI
  5. Haga clic en Guardar.
    La tarea se guarda y se cierra el panel Tarea nueva.
  El resultado debería parecerse a la imagen siguiente.
5. Haga clic en Guardar.
  La acción se guarda y se cierra la página Nueva acción.
En la pestaña Consultas del panel Configuración de Edge Intelligence busque la consulta Estado de la aplicación y haga clic en su nombre.
La página de detalles de la consulta se abre dentro del panel, mostrando un resumen de las acciones vinculadas.
1. En la sección Acciones seleccione Añadir acción.
  Se abre el panel Agregar acción.
2. En el menú desplegable, seleccione Desinstalar aplicación, el nombre de la acción que creó en el paso 2a-e.
  Aparecen la sección Datos de la acción (que enumera las variables creadas en el paso 2b) y la sección Marcadores de posición disponibles (que enumera los datos recuperados por la consulta).
  1. En la sección Acción, para Nombre:
    - en Tipo seleccione Usar el valor siguiente:
    - en Valor especificar $(query.name), el marcador de posición para Programa.
  2. En la sección Acción, para Proveedor:
    - en Tipo seleccione Usar el valor siguiente:
    - en Valor especificar $(query.publisher), el marcador de posición para Editor.
  3. En la sección Acción, para Versión:
    - en Tipo seleccione Usar el valor siguiente:
    - en Valor especificar $(query.version), el marcador de posición para Versión.
  Puede copiar un marcador de posición mediante el icono que aparece junto a la definición del marcador de posición.
3. Haga clic en Agregar para guardar los cambios.
  Se cierra el panel Agregar acción.
Haga clic en Cerrar.
Se cierra el panel configuración de Edge Intelligence.

La acción Desinstalar aplicación ya está disponible para su uso:

Ejecute la consulta Estado de la aplicación.
En la vista de lista de los resultados de la consulta, busque la línea con el Nombre del equipo deseado y Programa.
También puede utilizar filtros o parámetros para ello.
Abra el menú de opciones () de la línea seleccionada y seleccione Desinstalar aplicación.
1. La acción desinstala el programa y se actualizan los resultados de la consulta Estado de la aplicación.
2. La notificación creada en el paso 2d se muestra al usuario final.

Si va al menú de opciones a nivel de consulta en lugar de al menú de opciones a nivel de registro, Edge Intelligence aplicará la acción a todos los registros del resultado de la consulta. Según los parámetros de consulta, esto puede significar todas las aplicaciones de todos los equipos de su entorno.

Cree una acción rápida mediante el panel "Gestionar acciones para la consulta".

En este ejemplo añadirá una acción similar a la del ejemplo Crear una acción de consulta personalizada desde el panel de configuración de Edge Intelligence, pero como una Acción Rápida. Esto automatiza algunos de los pasos de configuración.

Vaya a Insights > Edge Intelligence y abra la consulta Estado de la aplicación (en la categoría Inventario).
Aparece el widget de consulta Estado de la aplicación.
Utilice el conmutador para cambiar a la vista de lista.
Abra el menú de opciones () y seleccione Gestionar.
Aparece el panel Administrar acciones para la consulta del estado de aplicaciones, que muestra una lista de acciones vinculadas.
Seleccione Crear una acción rápida.

Aparece el panel Crear acción rápida.
1. Especifique un Nombre de acción, por ejemplo Acción rápida Desinstalar la aplicación por nombre.
2. Seleccione la tarea Ejecutar Powershell.
  La tarea seleccionada se añade en Tareas y aparecen campos de configuración adicionales para la tarea.
  1. En el campo Script, introduzca su script de PowerShell (borrador).
    Para este ejemplo:
    Copiar
    $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(var placeholder)'" $application.Uninstall()
  2. En el campo Script, seleccione $(var placeholder) y haga clic en el marcador de posición Programa, en Marcadores de posición disponibles.
    Se introduce el marcador de posición y el script debería tener ahora este aspecto:
    Copiar
    $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(query.name)'" $application.Uninstall()
    Puede insertar marcadores de posición a medida que escribe la secuencia de comandos.
3. Seleccione Añadir otra tarea.
  Aparece la lista de tareas disponibles.
4. Seleccione la tarea Notificar al usuario.
  La tarea seleccionada se añade en Tareas y aparecen campos de configuración adicionales para la tarea.
  1. Especifique un Asunto y un Mensaje para la notificación. Puede utilizar marcadores de posición en estos campos.
5. Haga clic en Guardar.
  El panel Crear una acción rápida se cierra y el panel Administrar acciones para consultas de sesiones vuelve a estar visible. La nueva acción aparece en Acciones vinculadas.
Haga clic en Cerrar.

Se cierra el panel Administrar acciones para la consulta de sesiones.

La Acción rápida Desinstalar aplicación por nombre ya está disponible para su uso.

Vincular una acción existente a una consulta o una alerta

Vaya a Insights > Edge Intelligence, y haga clic en en la esquina superior derecha de la página.
Aparece el panel configuración de Edge Intelligence.
En la pestaña Consultas seleccione la consulta a la que desea vincular una acción. Por ejemplo: Usuarios de Active Directory.
La lista de acciones vinculadas para la consulta Usuarios de Active Directory se abre dentro del panel.
1. En la sección Acciones seleccione Añadir acción.
  Se abre el panel Agregar acción.
2. En el menú desplegable, seleccione Eliminar de los administradores locales, una acción por defecto que proporciona Ivanti.
  Aparecen la sección Datos de la acción (que enumera las variables de la acción) y la sección Marcadores de posición disponibles (que enumera los datos recuperados por la consulta Usuarios de Active Directory).
  1. En la sección Datos de acción, para accountName:
    - en Tipo seleccione Usar el valor siguiente:
    - en Valor especificar $(query.accountName), el marcador de posición para Accountname.
    No todas las consultas tienen marcadores de posición relevantes o útiles disponibles para su uso con una acción que se creó para una consulta distinta.
    También puede copiar el marcador de posición mediante el icono que aparece junto a la definición del marcador de posición.
3. Haga clic en Agregar para guardar los cambios.
  El panel Agregar acción se cierra y aparece Eliminar de los administradores locales en la sección Acciones para la consulta Usuarios de Active Directory.
Haga clic en Cerrar.
Se cierra el panel configuración de Edge Intelligence.

La acción está ahora disponible para su selección en el menú de opciones () de la consulta Usuarios de Active Directory.

El procedimiento es el mismo para añadir una acción a una alerta, excepto que en el paso 2 la alerta debe estar seleccionada en la pestaña Alertas.
Después de añadir una acción desde el panel de configuración de Edge Intelligence, la acción estará disponible para su selección al configurar la alerta.