Skip to main content

Deploy Quickpass Agent using Connectwise Automate

  • Updated

Introduction

This KB is designed to get you on your way to deploying the Quickpass Agent to your Customers' systems via the Connectwise Automate Solution.

 

Prerequisites

 

Method 1:
Automate Scripting Implementation

1. Download the Deploy Quickpass Server Agent Automate script here, or at the bottom of the page in Attachments.

2. Open Connectwise Control > System > General > Import > XML Expansion > import the downloaded file.

The XML will import as 'Deploy Quickpass Server Agent' to the following location:

  • Automation > Scripts > Software

3. Navigate to Automation > Scripts > View Scripts > search for the newly imported script, move to a new folder if desired.

4. Open the import script.

5. Select Globals and Parameters tab.

6. In the Parameters window, add a parameter called 'agentID' with a blank value

7. Click the installToken variable > assign the variable value the Install Token from your QP tenant > click Save.

  • QP Dashboard > Settings > copy Install Token.

8. Leave the agentID parameter blank - DO NOT populate a value here. 

9. Review the Automate script in the Script Editor and adjust if desired regarding script logging and ticketing.

10. Click Save in the bottom right corner.

11. In Connectwise Control client or Web App, navigate to the desired machine(s) and deploy the Automate script

12. When the script is selected to run, the user will be prompted to populate the agentID parameter value.


Use the Agent ID according to the desired QP Customer you wish to deploy the QP Agent to:

  • QP Dashboard > Customers > Find the desired customer > Right click 3 dot icon > Copy Agent ID

13. If you need to push the script to a different QP Customer, run the script again and populate the agentID parameter value to be the Agent ID value for the desired QP Customer (see step No. 4).

14. Repeat as needed.

 

Method 2:
Powershell Implementation

1. Navigate to Automation. Here, you can add a script and place it in a folder of your choice.

2. Fill out the required fields under the Script Editor and hit Next.

3. Click Global Variables

  • Create two variables named installToken and agentID
  • Assign the installToken value the Install Token from your QP tenant
    • QP Dashboard > Settings > Copy Install Token
  • DO NOT ASSIGN a value to the agentID variable - leave this blank.
  • Click Save

4. Click Parameters

  • Create a parameter named agentID - leave this blank.

When the script is selected to run, the user will be prompted to populate the agentID parameter value, which will then be assigned to the agentID variable.

Use the Agent ID according to the desired QP Customer you wish to deploy the QP Agent to:

  • QP Dashboard > Customers > Find the desired customer > Right click 3 dot icon > Copy Agent ID

5. In the Editor tab, Select Execute Script, drag into the right open space and this will open up to add the PowerShell script. Copy and paste the script from PowerShell Script for Agent Installation – CyberQP (getquickpass.com)

 

 

6. After pasting the script, edit the highlighted above with the @installToken@ and @agentID@ variables as seen below.

7. Add the variables as parameters to the Script Parameters field as shown below (You may type '@' and have an autofill window select the desired variable)

8. Ensure Script Credentials is set to Admin and hit the Save button

NOTE: In some instances, Script Credentials need to be set as 'Local Agent'

9. This can now be pushed against the machines for your client.

10. If you need to push the script to a different QP Customer, run the script again and populate the agentID parameter value to be the Agent ID value for the desired QP Customer (see step No. 4).

11. Repeat as needed.


Next Steps

Additional Connectwise Automate Quickpass monitoring articles

 

 

 

Related articles

Comments

0 comments

Please sign in to leave a comment.