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 del servicio para reiniciar un servicio. La acción utiliza un script de PowerShell, con un marcador de posición para la información recuperada por la consulta. Una vez reiniciado el servicio, se notificará al usuario.

  1. Vaya a Insights > Edge Intelligence, y haga clic en Icono de ajustes en la esquina superior derecha de la página.
    Aparece el panel configuración de Edge Intelligence.

  2. 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 Reiniciar servicio.
    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 ServiceName.

        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.
    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 Reiniciar servicio.
      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
        $ServiceName = "$(var.placeholder)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop

        Si conoce con certeza el texto exacto que debe sustituir a $(var placeholder), puede introducir 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 situada debajo del campo Script ) copie $(action.Name) con Copiar en el portapapeles Este es el marcador de posición correspondiente a la variable ServiceName que creó en el paso 2b.
      5. En el campo Script sustituya $(var placeholder) por el marcador de posición que copió en el paso iv.
        El script debería tener ahora este aspecto:
        Copiar
        $ServiceName = "$(action.ServiceName)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
      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 introduzca, por ejemplo: Se ha reiniciado correctamente el servicio: $(action.ServiceName).

        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:

        El siguiente servicio se ha reiniciado correctamente:
        $(action.ServiceName)

        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.
      Resultado de la configuración. Se enumeran dos tareas en la sección Tareas y tres variables en la sección Variables.

    5. Haga clic en Guardar.
      La acción se guarda y se cierra la página Nueva acción.
  3. En la pestaña Consultas del panel Configuración de Edge Intelligence localice la consulta Estado del servicio 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 la lista desplegable, seleccione Reiniciar servicio, que es el nombre de la acción que creó en los pasos 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 especifique $(query.name), que corresponde al marcador de posición ServiceName.

      Puede copiar un marcador de posición mediante el icono Copiar 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.
  4. Haga clic en Cerrar.
    Se cierra el panel configuración de Edge Intelligence.

La acción Reiniciar servicio ya está disponible:

  1. Ejecute la consulta Estado del servicio.
  2. En la vista de lista de los resultados, localice la fila correspondiente al Nombre del equipo y Nombre del servicio que desee.
    También puede utilizar filtros o parámetros para ello.
  3. Abra el menú de opciones ( Icono menú Opciones ) de la fila seleccionada y seleccione Reiniciar servicio.
    1. La acción reinicia el servicio y actualiza los resultados de la consulta Estado del servicio.
    2. La notificación creada en el paso 2d se muestra al usuario final.

Si selecciona el menú de acciones a nivel de consulta (resaltado en rojo en la siguiente imagen) en lugar del menú de acciones a nivel de registro resaltado en verde), Edge Intelligence aplicará la acción a todos los registros incluidos en los resultados de la consulta. En función de los parámetros definidos en la consulta, esto podría hacer que se reiniciaran todos los servicios de todos los dispositivos de su entorno. Utilice las acciones a nivel de consulta con precaución y valide siempre las acciones personalizadas nuevas en un entorno de prueba o laboratorio antes de desplegarlas en producción.

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.

  1. Vaya a Insights > Edge Intelligence y abra la consulta Estado del servicio (situada en la categoría Inventario).
    Se mostrará el widget de la consulta Estado del servicio.
  2. Utilice el conmutador Alterne el icono de la vista para cambiar a la vista de lista.
  3. Abra el menú de opciones (Icono menú Opciones) y seleccione Gestionar.
    Aparece el panel Administrar acciones para la consulta del estado del servicio, con una lista de las acciones vinculadas.
  4. 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: Reiniciar servicio.
    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
        $ServiceName = "$(var.placeholder)'" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
      2. En el campo Script, seleccione $(var.placeholder) y, en la sección Marcadores de posición disponible, haga clic en el marcador de posición Programa.
        Se introduce el marcador de posición y el script debería tener ahora este aspecto:
        Copiar
        $ServiceName ="$(query.name)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop

        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 vuelve a mostrarse el panel Administrar acciones para consultas de Estado del servicio. La nueva acción aparece en Acciones vinculadas.
  5. Haga clic en Cerrar.
    El panel Administrar acciones para la consulta Estado del servicio se cierra.

La Acción rápida: Reiniciar servicio ya está disponible.