Skip to main content

Deploy QuickPass Agent

Summary​

This script installs the QuickPass Agent on Windows machines where it is not already installed. The QuickPass EDF must be selected, and the QuickPass Agent ID EDF should be populated with the specified CustomerID at the client level. Additionally, the System Property QuickpassInstallToken must be filled with the installation token to ensure the script installs the agent successfully.

Sample Run​

Sample Run

Global Parameters​

NameRequiredExampleDescription
Ticket_On_FailureFalse1Fill it as '1' if you would like to receive a ticket on failure; otherwise, leave it blank or set it to '0'.
TicketCreationCategoryFalse298Mention the ticket creation category to direct the tickets to the right board in Manage

User Parameter​

NameRequiredExampleDescription
Set_EnvironmentFalse1Running the script with the user parameter Set_Environment as 1 will import the System Property QuickpassInstallToken needed for the script. Note: Set to 1 for first-time implementation.

System Property​

NameRequiredExampleDescription
QuickpassInstallTokenTrued7ksgi-yh67-kdsh77-jd888It must be filled with the installation token to initiate the QuickPass Agent installation

Extra Data Fields​

EDF NameLevelTypeDescription
QuickPassClientCheckBoxCheck it if you would like to enable the client for QuickPass Deployment
QuickPass Agent IDClientTextFieldPopulate it with the specified CustomerID at the client level to initiate the installation on targeted client machines
Exclude from QuickPass DeploymentLocationCheckBoxCheck it if you would like to exclude a location from QuickPass Deployment
Exclude from QuickPass DeploymentComputerCheckBoxCheck it if you would like to exclude a computer from QuickPass Deployment

  • The QuickPass EDF must be selected, and the QuickPass Agent ID EDF should be populated with the specified CustomerID at the client level to initiate the installation on targeted client machines.
    QuickPass Agent ID
    For more information on how to fetch the QuickPass Agent ID, refer to the document Export Customers List, Status and Agent IDs – CyberQP (getquickpass.com).

  • The System Property QuickpassInstallToken must be filled with the installation token to initiate the QuickPass Agent installation.
    QuickpassInstallToken
    The QuickPass Installation Token can be fetched from the Quickpass Dashboard. Navigate to the Settings Menu and then to the Admin Login Details section. Click the COPY button for the Install Token.

  • Select the location-level EDF Exclude from QuickPass Deployment to exclude the desired location from receiving the QuickPass agent deployment.
    Exclude from QuickPass Deployment

  • Select the computer-level EDF Exclude from QuickPass Deployment to exclude the desired machine from receiving the QuickPass agent deployment.
    Exclude from QuickPass Deployment

Output​

  • Script Logs
  • Ticketing

Ticketing​

Subject: QuickPass Agent Installation Failed on %ComputerName%(%ComputerID%)

Ticket Body: Failed to install QuickPass Agent on %computername% at %clientname%. Here are the results returned from the installer: %shellresult%

The PC information is outlined below:
PC Name: %computername%
Last Login: %lastuser%
PC Model: @biosname@
OS: %os%
S/N OF PC: @biosver@

When the script fails to download the installer:

QuickPass Agent failed to download on %computername% at %clientname%. Please ensure that the computer can reach the download URL [https://storage.googleapis.com/qp-installer/production/Quickpass-Agent-Setup.exe](https://storage.googleapis.com/qp-installer/production/Quickpass-Agent-Setup.exe)

The PC information is outlined below:
PC Name: %computername%
Last Login: %lastuser%
PC Model: @biosname@
OS: %os%
S/N OF PC: @biosver@