SupportAssist for Business PCs Administrator Guide

PDF

Creating remediation rules using Custom Workflow scripts

Prerequisites

  • You must be signed in to TechDirect as a Connect and manage administrator or Connect and manage technician.
  • PCs must have an active ProSupport Plus or ProSupport Flex for Client service plan.
  • To avoid issues with proxy connections, the PCs must connect to RaaS.
  • The PC should run SupportAssist version 4.5.2 or higher.
  • .NET Desktop Runtime version 8.0.x. See Microsoft .NET 8.0.

About this task

Remediation rules help identify and remediate issues within your PC fleet proactively. You can remediate the PCs by uploading diagnostic and remediation scripts to detect and resolve any issues that have occurred on the PC.

Steps

  1. From the TechDirect dashboard, go to Connect and manage > Manage PC fleet > Connect and manage PCs > Manage > Remediation rules.
    The Remediation rules page is displayed.
  2. Click Create a rule.
    The Create a rule page is displayed.
  3. In the Build workflow section, enter a name for your rule in the Name your rule field.
  4. In the Select workflow type section, choose Custom Workflow.
  5. Click Next.
  6. On the right side, in the Skills and scripts library use the search bar to find the skills you want to add.
  7. Drag and drop the Start event to the main workflow area.
    This process initiates your custom workflow.
  8. Drag and drop the PowerShell block into the workflow area where you want the skill to be performed and to configure the PowerShell skills, perform the following steps:
    1. Click the PowerShell skill block in the workflow area to open its properties on the right side of the screen.
    2. On the Input field, click the drop-down menu and select the appropriate input for the PowerShell script.
    3. If the execution of the PowerShell skill requires approval, click under the Requires Approval section, click the drop-down menu and, select the appropriate approval requirement.
    4. On the User Context, click the drop-down menu and select the appropriate user context for which the skill runs.
  9. Click Upload a PowerShell script, if the specific script is not available in the library, select your script from your local system, assign it a name for reference, and click Upload.
    NOTE:Ensure that the PowerShell script you want to upload is saved in the .PS1 format. Ensure that the file size does not exceed the maximum limit of 2 MB.
    The system automatically signs the script using Dell certificates to validate its authenticity.
  10. Select and drag the necessary skills and scripts from the skills library to your workflow. Some of the following available options to include:
    • Product Owned actions:
      • Disable Remote Desktop
      • Enable ICMP Inbound
      • Disable ICMP Inbound
      • Enable Remote Desktop
      • Enable USB Storage
      • Disable USB Storage
      • Dell Power Config
      • Disable File Print and Share
      • Enable File Print and Share
      • Disable Hibernation
      • Disable Hibernation on AC
      • Disable Sleep on AC
      • Disable Camera
      • Enable Camera
      • Enable Hibernation
      • Enable Hibernation on AC
      • Enable Sleep on AC
      NOTE:Arrange all the above skills in the desired order based on your workflow requirements.
  11. In the Rule type and schedule section, choose the occurrence and frequency at which a rule should be performed:
      • Scheduled—runs at specific intervals. You need to specify the frequency and time (AM or PM).
      • Telemetry—telemetry parameter allows users to set performance rules based on specific metric.
      • Run Once Now—runs immediately.
  12. If you choose Scheduled, a drop-down menu appears to select the frequency daily or weekly, and then you select the specific time (AM or PM) for execution.
  13. Click Next .
  14. In the Assign section, choose the sites or groups to which you want to assign this rule. You can filter or search for specific sites or groups.
    NOTE:The Sites & groups list displays only PCs that have an active ProSupport Plus or ProSupport Flex for Client service plan.
  15. Click Create rule to finalize, or you can choose to Save draft if you need to make further modifications later.
    The remediation rule is saved and is displayed on the Remediation rules page.
    NOTE:By default, the remediation rule is not applied to a new site or groups that are created after the creation of the remediation rule. You must edit the remediation rule to include PCs in the new site or group, to the rule. See Update a remediation rule.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\