Introduction

The Windows Install PowerShell Script for RMM/MDM script can be used with SuperOps RMM to programmatically install the Field Effect MDR agent.

The script requires two inputs to be passed via your RMM variables:

1. Field Effect MDR Portal API token
2. The client name as it appears in the Field Effect MDR Portal

The API token must be created in the MDR portal following the instructions in our Help Center: Create an API Key. 

The Portal account associated with the token must have appropriate permissions for the script to work properly. Contact support@fieldeffect.com to limit access for your chosen account only to the agent installer API. 

To configure the script in SuperOps 

1. Navigate to Modules > Scripts, click the +Script icon and paste the provided MDR PowerShell script
2. Set the scripting language to PowerShell and set it to run as root/system user. 
3. Under Placeholder Variables, establish the client name variable:
   1. Enter client as the variable name and select the "Client name" field in the selector
      
      

SuperOps has no method to create a secure global variable for the MDR API token. You may decide to: 
    (a) hardcode the token in the body of the script; or 
    (b) create a custom field for the token in SuperOps.

4. Establish the MDR API token in SuperOps  
   • Option a) Hardcode the token value in the script:
     1. Locate the line around 99 in the PowerShell script where the $api_token token is set:

     2. ...
        param (
          [string]$api_token,
        ...

     2. Edit the line to add your API token string as the default value:  

     3. [string]$api_token = "<<< PASTE TOKEN HERE >>>",

     3. Save the modified script.
   • Option b) Create a custom field for the token:
     1. Go to Settings > Advanced Configuration > Manage Fields > Client fields and create a new custom field (e.g. MDR API Token).
     2. Populate that field's value on each client's record under the client profile. 
     3. In the script editor, return to "Add placeholder variables"
     4. Enter api_token as the variable name and select the "MDR API Token" field in the selector