Introduction:

The QP Agent can be deployed through Kaseya VSA with minimal interaction after the initial setup is completed. The following steps will walk you through how to create and assign variables for a Kaseya Group ID and call for those variables so you can deploy a scripted installation.

Setup

There are two variables that are required for the Quickpass Agent deploy, the Install Token and the AgentID. Kaseya VSA allows you to create variables that contain the string value of the Install Token (applied tenant wide) and the AgentID (unique per QP Customer).

NOTE: To find the AgentID for each QP Customer, run the Customer report from the QP Dashboard and reference the AgentID column for each Customer name in the exported CSV. 

KB article - https://support.getquickpass.com/hc/en-us/articles/360061942274-Export-Customers-List-Status-and-Agent-ID-s

Kaseya Configuration

Assigning Script Variables

1. Navigate to the Kaseya VSA
2. Navigate to Agent Procedures > Manage Procedures > Schedule/Create
3. Create folder structure as desired for your Kaseya tenant
   1. i.e. Shared > New Folder: [QPInst]
4. Click Manage Files
   1. Shared Files > Upload a file
      1. Download the QPInstall.ps1 script attached to this article and upload here (the script does not require manual modification) > close out the window
5. Click Manage Variables
   1. Input the Install Token value from your QP tenant to the Set Variable Value field
   2. Name it installToken
   3. Set Public
   4. Select All (or select all of the groups that contain machines you plan to deploy the QP agent to)
   5. Apply
   6. To confirm, click the Select Variable dropdown and see the variable value displayed for the selected groups.
6. Click the Select Variable dropdown and click <New Variable>
   1. Name it agentID
   2. Set Public
   3. Select a desired group that corresponds to a QP Customer and set the Variable Value to be the AgentID for that QP Customer
   4. Apply
   5. Repeat for each desired group that corresponds to a QP Customer, filling in the Variable Value with each Customers's unique AgentID according to the Customer report exported during the setup.
   6. Confirm by clicking the Select Variable dropdown and click the agentID variable, it should show a different variable value for the groups selected (example below)

Creating Kaseya Agent Procedure (Script)

1. Return to Agent Procedures > Manage Procedures > Schedule/Create
2. Select the desired folder to store the procedure in, and click New Procedure
   1. Assign a name and select the save location for the procedure
3. In the body, type writeFile and click on the 'writeFile' statement prompt.
   1. Click into the first quote box and then click the Spyglass icon to select the QPInstall.ps1 file that was uploaded earlier
   2. In the second quote box, edit the text to "C:\QPInstall.ps1"
   3. NOTE: When this procedure is ran, the QPInstall.ps1 file that was uploaded to the Kaseya server will be pushed to the target machine at the root of the C$ drive as C:\QPInstall.ps1. You may change the target location that the script is pushed to and ran from if you are comfortable and desire to do so, just make sure to edit line 2 of the Procedure to reflect the new location of the QPInstall.ps1 file
4. On a new line in the body, type executePowershell and click on the 'executePowershell' statement prompt
   1. Leave the first quote box empty
   2. In the second quote box enter the following code exactly as shown

   3. cd C:\ ; .\QPInstall.ps1 '<installToken>' '<agentID>'

      FOR EU TENANTS: Add the -EU parameter at the end of the code (example below)

   4. cd C:\ ; .\QPInstall.ps1 '<installToken>' '<agentID>' -EU

5.  Click the 'false' and change to 'true'
6. If you would like additional logging, you may add the following statement as a new line 
   1. Save the procedure

NOTE: If you would like to understand the theory of this Agent Procedure, please review the attached document QPInstall Agent Procedure Overview.txt

Run the Agent Procedure

1. Return to Agent Procedures > Manage Procedures > Schedule/Create
2. Select the Procedure on the left side folder structure
3. Select the desired target machine(s)
4. Click Run Now, then click Submit 
5. To confirm the procedure ran successfully, go to Agent Procedures > Agent Procedure Status
6. Select the desired machine
7. Review the logs
   1. A successful install will look similar to the follow. To confirm further, remote into a target machine and confirm that the Quickpass Agent service is running and/or confirm the Agent has populated in the QP Customers Agent tab