Introduction
The Scripts module in the HP Workforce Experience Platform (WXP) allows you to deploy custom PowerShell 5.1 scripts to groups of managed devices. This feature is currently available for Windows 10 and Windows 11 and helps automate routine administrative tasks across your device fleet.
The Scripts feature is currently in Beta. Some advanced capabilities, such as editing and deleting scripts, are planned in future releases.
This article provides a step-by-step to the following topics:
- Accessing Scripts Library, including Adding Script to a Library and Viewing Script details in Library.
- Accessing Scripts Gallery, including Viewing Script Details in Gallery.
- Acessing Assignments, including Creating a New Assignment
Accessing Script Library
- Log in to WXP The Home page is displayed.
- From the left menu, click Remediations > Scripts. The Scripts page is displayed with three tabs:
- Library (default): Displays all available scripts created or uploaded by users.
- Assignments: Links a PowerShell script to one or more device groups for manual or scheduled execution.
- Gallery: Displays curated scripts provided by HP.
- In the Library tab, the following columns are displayed:
| Field | Description |
|---|---|
| Script Name | The name of the script. |
| Version | The version number of the script. |
| Created By | The user who created the script. |
| Synopsis | A brief description of the script. |
| Operation | Indicates whether the script is an Action or Evaluation. |
Optional columns include:
| Field | Description |
|---|---|
| Script ID | A unique identifier assigned to each script. |
| Run As | Indicates the context or user that will run the script. The options are System or User . |
| Host Environment | Specifies whether the script runs in a 32-bit or 64-bit environment. |
| Execution Policy | Determines script execution rules such as Bypass or Client Default. |
Use the gear icon (Column Options) to add columns to remove columns from the default view. Click Reset to default to restore the default view.
Adding a Script to Library
- From the left menu of WXP, click Remediations > Scripts. The Library tab is displayed by default.
- Click Add Script. The Add Script dialog box is displayed.
- In Step 1 of 3, provide the following:
- .ps1 File Upload: Upload the PowerShell 5.1 script file.
- Operation Type: Choose either Action to trigger a change or Evaluation to assess without making any changes.
- In Step 2 of 3, define execution properties:
- Run As: Select System or Logged on User to determine execution context.
- Host Environment: Select 32-bit or 64-bit to match the execution platform of the target devices.
- Execution Policy: Choose Bypass or Client Default. Bypass is not supported on All Signed.
Note: Use Client Default to execute signed scripts using a Trusted Publisher.
- In Step 3 of 3, enter script metadata:
- Script Name: A unique and descriptive name for the script.
- Script Version: The version number.
- Synopsis: A short summary of what the script does.
- Description: Detailed explanation of the script’s purpose.
- Click Add to save the script. A popup displays success or failure.
Note: Scripts must be assigned through the Assignments tab. Script editing is currently not supported.
View Script Details in Library
- From the left menu of WXP, click Remediations > Scripts > Library.
- Click a Script Name to open its details. Three tabs are displayed: Overview (default), Assignments, and Activity.
Overview tab
| Section | Fields |
|---|---|
| Script Information | Synopsis, Description, Created By, Last Modified Date, and Version |
| Execution Properties | Operation Type, Host Environment, Run As, Execution Policy |
| Script Content | Displays the raw PowerShell code. |
Assignments tab
| Field | Description |
|---|---|
| Status | Current assignment status (e.g., Not Scheduled). |
| Synopsis | Purpose of the script in this context. |
| Operation | Action or Evaluation. |
| Assignment Name | Name of the deployment instance. |
| Groups | Device groups assigned to the script. |
Activity tab
| Field | Description |
|---|---|
| Initiated On | Timestamp of script execution. |
| Remediation Name | Name of the execution instance. |
| Operation | Indicates if the execution was an Action or Evaluation. |
| Initiated By | User who triggered the script. |
| Status | Current status (e.g., Completed, In Progress). |
Use the gear icon (Column Options) to add columns to or remove columns from the default view.
Filters and Sorting
- Use the search box in each column to find scripts by Remediation Name, Operation, Initiated By, or Status.
- Sort the results by Initiated On.
Accessing Script Gallery
From the left menu of WXP, click Remediations > Scripts > Gallery. The Gallery tab is displayed, showing HP-curated script templates. The following columns are displayed:
| Field | Description |
|---|---|
| Status | Indicates script availability or status. |
| Last Update | Last modification date. |
| Script Name | Name of the predefined script. |
| Version | Script version number. |
| Created By | Author (HP or internal). |
| Operation Type | Indicates Action or Evaluation type. |
Use the gear icon (Column Options) to add or remove columns.
Viewing Script Details in the Gallery
- From the left menu of WXP, click Remediations > Scripts > Gallery. The Gallery tab is displayed.
- On the Gallery tab, click a Script Name. The script detail page is displayed, showing the following details:
| Section | Fields |
|---|---|
| Script Information | Synopsis, Description, Created By, Last Modified, Version |
| Execution Properties | Operation Type, Host Environment, Architecture, Run As, Execution Policy |
| Script Content | Full PowerShell source code |
To use a Gallery script, create an assignment and define target groups in the workflow.
Accessing Assignments
From the left menu of WXP, click Remediations > Scripts > Assignments. The Assignments tab is displayed, showing the following details
| Field | Description |
|---|---|
| Assignment Name | Name of the script assignment. |
| Script Assigned | Name of the associated script. |
| Target Groups | Device groups assigned to the script. |
| Author | Creator of the assignment. |
| Status | Current assignment status. For example, Scheduled, Not Scheduled. |
Assignments are required to apply scripts from the Library to devices.
Creating a New Assignment
- From the left menu of WXP, click Remediations > Scripts > Assignments. The Assignments tab is displayed.
- On the Assignments tab, click Add. The Add Script Assignment dialog box is displayed, showing Step 1 of 4 to enter the basic details:
-
- Author: Auto-filled with the logged-in user name.
-
- Assignment Name: Enter a meaningful name for the assignment.
-
- Description: Explain the purpose of the script deployment.
-
- Click Next. Step 2 of 4 is displayed to select a Script.
- Choose a script from the list. You can also use the search bar to find the correct script.
- Click Next. Step 3 of 4 is displayed to select target Groups.
- Use checkboxes to select one or more groups.
- Click Next. Step 4 of 4 is displayed for review.
- Review the selected Script and target Groups.
- Click Finish. A popup is displayed indicating success or failure.
The new assignment can be viewed on the Assignments tab with a status of Not Scheduled.
Related Resources
For additional information, refer to the following articles:
- Overview of Remediation
- Overview of Scripts
- Overview of Secrets
- Overview of Policies
- Overview of Activity
Contact Us
If you encounter issues, Create a Support Case or email [email protected].