Deploy PDQ Detect Agent for Windows using PDQ Connect

Introduction

PDQ Connect can be used to deploy applications as custom packages to endpoints with an internet connection which have your Connect agent installed. Below, you'll find instructions for how to create a custom package to deploy the PDQ Detect agent using Connect.

Download the Detect Agent for Windows installer

1. Log into the PDQ Detect Management Portal at https://detect.pdq.com.
2. On the left bar, click Scan Surface.
3. On the top menu, click Agent-based Surface.
   • If Agent-based Surface does not appear here, you may need to enable this feature.
     1. Browse to Settings | Client Settings.
     2. Locate the Installation Mode, and select Enable Agent-based.
     3. Click Just enable the features.
     4. You can then return to Scan Surface and click Agent-based Surface.
4. Switch to the Setup agents tab.
   • On the Use Detect Agents to gain more insights on your organization's internal security page, on the right side, you will see two important pieces of information which you will need to set up each endpoint:
     
     • 🌐Detect Agent Management URL: https://detect.pdq.com
     • 🔑Detect Agent Token (a unique alphanumeric token which your Internal Scanner VM will use to communicate with your PDQ Detect environment)
5. Under the Windows logo, click Get | Download MSI Installer.
6. Save the .msi file to a new, empty folder. 
   

Create a package in PDQ Connect

1. Log into PDQ Connect at https://app.pdq.com.
2. On the left bar, click Packages.
3. In the top right corner, click Create package.
4. Enter a Name and Version for the package.
   
5. Click Add install step.
6. On the Install step page, click Attach installer. Browse to the Detect Agent installer MSI you saved above, and click Open. The file will upload.
   
7. When the upload is complete, enter the following under Arguments, making sure to include the correct values for your Detect Management URL (https://detect.pdq.com) and Detect Agent Token.
   /i "FootprintAgentInstaller.msi" /qn /L*V "output.log" SERVER_URL="https://detect.pdq.com" TOKEN="112233445566aabbccddeeffgg"
   
8. Click Save.

Deploy the package

1. Log into PDQ Connect at https://app.pdq.com.
2. On the left bar, click Devices.
3. Select one or more devices or groups, and then click Deploy in the top right corner.
4. In the Create deployment window, search for the package you've created, and then select it.
   
5. Click Deploy.
   For more detailed deployment instructions and options in Connect, see Deploying Packages.
6. After you deploy the Application Pack and it has installed successfully onto an endpoint, you can view the deployed agent(s) in PDQ Detect under Scan Surface | Agent-based Surface | Deployed agents.