Introduction

This is a guide to show you how to use an App Bundle to deploy the Quickpass Agent to your devices, via Microsoft Intune.

Prerequisites

• Customers created in the Quickpass Dashboard
  • via ITGlue
  • via Hudu
  • via ConnectWise Manage
  • Manual Creation
• Ensure that you have reviewed and understand the Install Token and Agent ID Values
  https://support.getquickpass.com/hc/en-us/articles/360061942274-Export-Customers-List-Status-and-Agent-ID-s
• Review the Scripted Agent Installation KB Article to understand what each Powershell Parameter will do
  https://support.getquickpass.com/hc/en-us/articles/4413576799639-Scripted-Agent-Installation

Implementation

There are two main steps in the process, which will be detailed below.

1. Create App Bundle

2. Upload App and Configure Deployment

1. Create your App Bundle

We need use the Microsoft Win32 Content Prep Tool (Download Here) to bundle our installer, and some install/uninstall commands into a .intunewin file, which is deployable using Intune.

After downloading the tool, you'll need to download your Agent installer from your Quickpass Dashboard.

Next, we'll make a simple folder structure, as seen below.

The Quickpass-Agent-Setup.exe file should go in the Input folder, along with a couple of .CMD files we'll create in the next steps. The .CMD Files contain some simple commands; one for installation, and one for uninstallation, which will be separate files. To create the installation file, open Notepad and paste in the following, while swapping in your CustomerID and AgentID. The CustomerID and AgentID need to be in quotes.

@ECHO OFF
SET SOURCE=%~dp0
SET SOURCE=%SOURCE:~0,-1%

Quickpass-Agent-Setup.exe /quiet INSTALLTOKEN="<Install Token>" CUSTOMERID="<Customer ID>" MSA=1 /NORESTART

Save the file, and upon saving, change the file extension to .cmd. You may be asked if you want to do this, and required to confirm. Save this file in the Input folder.

For the uninstall .CMD file, open a new file in Notepad, and paste in the following.

@ECHO OFF
SET SOURCE=%~dp0
SET SOURCE=%SOURCE:~0,-1%

Quickpass-Agent-Setup.exe /quiet /uninstall

Save the file, and upon saving, change the file extension to .cmd. You may be asked if you want to do this, and required to confirm. Save this file in the Input folder as well.

With these complete, your Input folder should look like this:

We can now run the Win32 Content Prep Tool (IntuneWinAppUtil.exe) to create our bundle. When you launch the tool, you will be prompted for a few pieces of information, one line at a time: Source Folder, Setup File, Output Folder, and Catalog Folder. Fill in the appropriate file paths, and enter "n" for the catalog folder option. After running this app, your Quickpass-Agent-Setup.intunewin file will be saved in your Output folder. Your app bundle is complete, and ready to deploy in Intune.

2. Upload App and Configure Deployment

Now, we need to upload our app bundle and set up the deployment. In the Intune Admin portal, select Apps on the left side. Then, under "By Platform," select Windows.

Click the + button to add a new app.

For App Type, select Windows App (Win32), then click Select at the bottom of the page.

Click the Select App Package File button, then click the Folder icon to upload your .intunewin your app bundle, then click OK.

On the App information page, you can name your app, enter publisher information, categorize, and even add a logo. Below is an example of how to set things up. After you've entered App information, click Next at the bottom of the page.

In the Program section, we need to reference the .CMD files we created earlier, then click Next.

In the Requirements section, you need to select your OS architecture (64-bit), and a minimum OS version, then click Next.

For Detection rules, select Manually configure detection rules, Then click Add.

For the Rule Type, select Registry. The Key path is:

HKEY_LOCAL_MACHINE\SOFTWARE\Quickpass Software\Quickpass Server Agent

Value name should be "InstallPath" and Detection method should be set to "Value Exists". Click OK and then Next.

We do not need to set Dependencies or Supersedence for this installation, but they are available if you need them.

In Assignments , use the Required section to Assign the app to whichever security groups or users need the installation. You may also set it to Add all devices. In the example, I used a security group called Intune-Quickpass. Click Next.

In Review + Create, review your app configuration, then click Create.

Your Quickpass Agent should now deploy to the assigned machines in Intune. Give Intune some time to process the changes, and then take a look at your Quickpass Dashboard, in the Agents section. You should see devices start showing up on the list.