How to Deploy the Windows Agent

Overview

The BoolDesk Agent is a lightweight software client that runs on your organization's computers. Once installed, it automatically communicates with the BoolDesk server to report hardware specifications, installed software, and system status. Installing the agent is the primary way to populate your asset inventory with accurate, real-time data.

Step-by-Step Guide

1. Access the Agent Download Menu

To find the installation script, you can use the Quick Action menu from anywhere in the platform.

• Click the plus icon (+) (1) located in the top header of the application.

• From the quick create menu, locate the agent section on the right side.

• Click on Windows Agent (2).

2. Copy the Installation Script

A "Windows Agent – Setup Script" window will appear. This window provides a pre-configured PowerShell script that handles the entire installation process, including downloading the installer and connecting it to your specific BoolDesk instance with the correct tokens.

• Review the Script: The script includes your specific API URLs (AGENTAPIEXTERNALBASEURL, etc.), your ENROLLMENTTOKEN, and your unique TENANTID.

• Copy: Click the copy icon in the top right corner of the black code block to copy the full command to your clipboard.

3. Run the Script on the Target Machine

To complete the installation:

1. Log in to the Windows computer you want to manage.

2. Open PowerShell as an Administrator.

3. Paste the command you copied in the previous step.

4. Press Enter to run it.

The script will automatically download the BoolDeskAgent.msi file, install it silently, and register the computer in your BoolDesk inventory.