Introducción
El módulo Scripts de HP Workforce Experience Platform (WXP) le permite implementar scripts personalizados de PowerShell 5.1 en grupos de dispositivos gestionados. Esta característica está disponible actualmente para Windows 10 y Windows 11 y ayuda a automatizar las tareas administrativas rutinarias en toda la flota de dispositivos.
Nota:
La función Scripts se encuentra actualmente en versión beta. Algunas capacidades avanzadas, como la edición y eliminación de scripts, están previstas en futuras versiones.
En este artículo se proporciona un paso a paso de los siguientes temas:
Acceso a la biblioteca de scripts, incluida la adición de scripts a una biblioteca y la visualización de detalles de scripts en la biblioteca.
Acceso a la Galería de scripts, incluida la visualización de detalles de scripts en la Galería.
Acceso a las tareas, incluida la creación de una nueva tarea
Acceso a la biblioteca de scripts
Inicie sesión en WXP Se muestra la página de inicio .
En el menú de la izquierda, haga clic en Correcciones > scripts. La página Scripts se muestra con tres pestañas:
Biblioteca (predeterminada): muestra todos los scripts disponibles creados o cargados por los usuarios.
Asignaciones: vincula un script de PowerShell a uno o varios grupos de dispositivos para su ejecución manual o programada.
Galería: muestra scripts seleccionados proporcionados por HP.
En la pestaña Biblioteca , se muestran las siguientes columnas:
Campo | Descripción |
|---|---|
Nombre del script | El nombre del script. |
Versión | El número de versión del script. |
Creado por | El usuario que creó el script. |
Sinopsis | Una breve descripción del guión. |
Operación | Indica si el script es una acción o una evaluación. |
Las columnas opcionales incluyen:
Campo | Descripción |
|---|---|
Script ID | Un identificador único asignado a cada script. |
Ejecutar como | Indica el contexto o el usuario que ejecutará el script. Las opciones son Sistema o Usuario . |
Entorno de host | Especifica si el script se ejecuta en un entorno de 32 bits o de 64 bits. |
Política de Ejecución | Determina las reglas de ejecución de scripts, como Omitir o Predeterminado del cliente. |
Utilice el icono de engranaje (Opciones de columna) para agregar columnas y eliminar columnas de la vista predeterminada. Haga clic en Restablecer valores predeterminados para restaurar la vista predeterminada.
Adición de un script a la biblioteca
En el menú de la izquierda de WXP, haga clic en Correcciones > scripts. La pestaña Biblioteca se muestra de forma predeterminada.
Haga clic en Agregar script. Aparecerá el cuadro de diálogo Agregar guión .
En el paso 1 de 3, proporcione lo siguiente:
Carga de archivos .ps1: cargue el archivo de script de PowerShell 5.1.
Tipo de operación: elija Acción para desencadenar un cambio o Evaluación para evaluar sin realizar ningún cambio.
En el paso 2 de 3, defina las propiedades de ejecución:
Ejecutar como: seleccione Sistema o Usuario que ha iniciado sesión para determinar el contexto de ejecución.
Entorno de host: seleccione 32 bits o 64 bits para que coincida con la plataforma de ejecución de los dispositivos de destino.
Política de ejecución: elija Omitir o Cliente predeterminado. La omisión no se admite en Todos los firmados.
Nota: Utilice el valor predeterminado del cliente para ejecutar scripts firmados mediante un publicador de confianza.
En el paso 3 de 3, introduzca los metadatos del script:
Nombre del script: Un nombre único y descriptivo para el script.
Versión del script: el número de versión.
Sinopsis: Un breve resumen de lo que hace el guión.
Descripción: Explicación detallada del propósito del guión.
Haga clic en Agregar para guardar el script. Una ventana emergente muestra el éxito o el error.
Nota: Los scripts deben asignarse a través de la pestaña Asignaciones . Actualmente no se admite la edición de scripts.
Compatibilidad con parámetros en scripts
Los scripts de WXP admiten la adición de parámetros de entrada a los scripts de PowerShell. Esta función ayuda a clientes y socios a crear scripts personalizables y reutilizables en toda su flota.
Para asignar parámetros en un script:
En Scripts Overview, vaya a Parameters y haga clic en Add Parameter.
Introduzca el nombre, el tipo y el valor del parámetro. Tenga en cuenta que:
Se admiten hasta cinco parámetros.
Los tipos admitidos son String, Integer, Boolean y Switch.
Haga clic en Save.
La vista Scripts muestra todos los parámetros configurados en el script. Los parámetros deben especificarse aquí antes de crear una asignación. Una vez creada, el asistente de asignación muestra una página adicional que le solicita confirmar o reemplazar cualquier valor predeterminado especificado para sus parámetros.
Ver detalles del script en la biblioteca
En el menú de la izquierda de WXP, haga clic en Correcciones > scripts > biblioteca.
Haga clic en el nombre de un script para abrir sus detalles. Se muestran tres pestañas: Información general (predeterminada), Tareas y Actividad.
Pestaña Información general
Sección | Campos |
|---|---|
Información del script | Sinopsis, descripción, creado por, fecha de la última modificación y versión |
Propiedades de ejecución | Tipo de operación, Entorno de host, Ejecutar como, Política de ejecución |
Contenido del guión | Muestra el código de PowerShell sin procesar. |
Pestaña Asignaciones
Campo | Descripción |
|---|---|
Estado | Estado actual de la asignación (por ejemplo, No programado). |
Sinopsis | Propósito del script en este contexto. |
Operación | Acción o evaluación. |
Nombre de la tarea | Nombre de la instancia de implementación. |
Grupos | Grupos de dispositivos asignados al script. |
Pestaña Actividad
Campo | Descripción |
|---|---|
Iniciado el | Marca de tiempo de la ejecución del script. |
Nombre de la corrección | Nombre de la instancia de ejecución. |
Operación | Indica si la ejecución fue una acción o una evaluación. |
Iniciado por | Usuario que activó el script. |
Estado | Estado actual (por ejemplo, Completado, En curso). |
Utilice el icono de engranaje (Opciones de columna) para agregar o eliminar columnas de la vista predeterminada.
Filtros y clasificación
Use el cuadro de búsqueda de cada columna para buscar scripts por Nombre de corrección, Operación, Iniciado por o Estado.
Ordene los resultados por Iniciado el.
Acceso a la Galería de scripts
En el menú de la izquierda de WXP, haga clic en Correcciones > Scripts > Galería. Se muestra la pestaña Galería , que muestra plantillas de scripts seleccionadas por HP. Se muestran las siguientes columnas:
Campo | Descripción |
|---|---|
Estado | Indica la disponibilidad o el estado del script. |
Última actualización | Fecha de la última modificación. |
Nombre del script | Nombre del script predefinido. |
Versión | Número de versión del script. |
Creado por | Autor (HP o interno). |
Tipo de operación | Indica el tipo de acción o evaluación. |
Utilice el icono de engranaje (Opciones de columna) para agregar o eliminar columnas.
Visualización de los detalles del script en la galería
En el menú de la izquierda de WXP, haga clic en Correcciones > Scripts > Galería. Se muestra la pestaña Galería .
En la pestaña Galería, haga clic en un nombre de script. Se muestra la página de detalles del script, que muestra los siguientes detalles:
Sección | Campos |
|---|---|
Información del script | Sinopsis, Descripción, Creado por, Última modificación, Versión |
Propiedades de ejecución | Tipo de operación, Entorno de host, Arquitectura, Ejecutar como, Política de ejecución |
Contenido del guión | Código fuente completo de PowerShell |
Nota:
Para utilizar un script de Galería, cree una tarea y defina los grupos de destino en el flujo de trabajo.
Acceso a las tareas
En el menú de la izquierda de WXP, haga clic en Correcciones > scripts > asignaciones. Se muestra la pestaña Asignaciones , que muestra los siguientes detalles
Campo | Descripción |
|---|---|
Nombre de la tarea | Nombre de la asignación de guión. |
Script asignado | Nombre del script asociado. |
Grupos destinatarios | Grupos de dispositivos asignados al script. |
Autor | Creador del encargo. |
Estado | Estado actual de la asignación. Por ejemplo, Programado, No programado. |
Las tareas son necesarias para aplicar scripts de la biblioteca a los dispositivos.
Creación de una nueva asignación
En el menú de la izquierda de WXP, haga clic en Correcciones > scripts > asignaciones. Se muestra la pestaña Asignaciones .
En la pestaña Asignaciones , haga clic en Agregar. Se muestra el cuadro de diálogo Agregar asignación de script , que muestra el paso 1 de 4 para introducir los detalles básicos:
Autor: Se rellena automáticamente con el nombre de usuario que ha iniciado sesión.
Nombre de la tarea: introduzca un nombre descriptivo para la tarea.
Descripción: Explique el propósito de la implementación del script.
Haga clic en Siguiente. Se muestra el paso 2 de 4 para seleccionar un script.
Elija un script de la lista. También puede usar la barra de búsqueda para encontrar el script correcto.
Haga clic en Siguiente. Se muestra el paso 3 de 4 para seleccionar los grupos objetivo.
Utilice las casillas de verificación para seleccionar uno o más grupos.
Haga clic en Siguiente. Se muestra el paso 4 de 4 para su revisión.
Revise el script seleccionado y los grupos de destino.
Haga clic en Finalizar. Se muestra una ventana emergente que indica que se ha realizado correctamente o que se ha producido un error.
La nueva tarea se puede ver en la pestaña Asignaciones con un estado de No programado.
Ejecución de una asignación
En el menú izquierdo de WXP, haga clic en Remediations > Scripts > Assignments. Se muestra la pestaña Assignments.
En la pestaña Assignments, haga clic en un Assignment Name para acceder a la página Assignment Details.
En la página Assignment Details, puede ejecutar una asignación inmediatamente haciendo clic en el botón Run en la esquina superior derecha, o bien desplazarse hasta la parte inferior de la página y hacer clic en Add Schedule para programar la ejecución de la asignación una sola vez o de forma recurrente.
Contáctenos
Si tiene problemas, cree un caso de soporte o envíe un correo electrónico support@wxp.hp.com.