Install IT Agent - Windows

[#1]

Use the IT Agent Discovery to identify and track assets that connect to your network. You can install it interactively or silently, depending on your deployment needs.

Prerequisites

• Review the IT Agent requirements

• Review the supported operating systems

Supported operating systems

• Windows 7 SP1 or Windows 8.1, with Extended Security Updates (x64)

• Windows 10, version 1607 or higher (x64)

• Windows 11, version 22000 or higher (x64)

• Windows Server 2012 or higher (Core and Desktop Experience, x64)

Install the agent

Interactive (GUI)

Silent (config file)

Silent (command line)

Silent (msi package)

Deployment script

Ideal for most users when installing on a few devices.

1. In your preferred site, go to Discovery > Systems > Download installers/packages > IT Agent Discovery.

2. Find the exe format and select Download IT Agent installer.

3. Run the downloaded installer.

4. When prompted, select Yes to allow the app to make changes to your device.

5. Read and select I accept the agreement.

6. Choose the installation directory and select Next.

7. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

8. Paste the copied linking code into the installer and select Next.

9. Select Next again to start the installation.

Ideal for repeatable deployments across devices.

1. In your preferred site, go to Discovery > Systems > Download installers/packages > IT Agent Discovery.

2. Find the exe format and select Download IT Agent installer and Download IT Agent silent installation configuration.

3. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

4. On your Windows computer, open the downloaded lansweeperitagentinstallation.cfg file.

5. Replace cloudtokenvalue with your copied linking code. If needed, configure proxy settings by removing the # symbols.

   mode=unattended
   accepteula=1
   path=C:\Program Files\Lansweeper IT Agent Discovery
   cloudtoken=cloudtokenvalue
   #proxyserver=myproxyserver.domain.local
   #proxyport=8080

6. Open an elevated Command Prompt and run the following command, replacing X.X.X with the installer version number:

   Installer version

   The version numbers for your installer can be found in your Lansweeper site. Go to Discovery > Download installers/packages > IT Agent Discovery> Version and locate your installer.

   Lansweeper-IT-agent-discovery-X.X.X-windows-x64-installer.exe --optionfile lansweeperitagentinstallation.cfg

Ideal for scripted installs without editing a .cfg .

1. In your preferred site, go to Discovery > Systems > Download installers/packages > IT Agent Discovery.

2. Find the exe format and select Download IT Agent installer.

3. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

4. Run this command in an elevated Command Prompt, replacing cloudtokenvalue with your copied linking code and X.X.X with the installer version:

   Installer version

   The version numbers for your installer can be found in your Lansweeper site. Go to Discovery > Download installers/packages > IT Agent Discovery > Version and locate your installer.

   Lansweeper-IT-agent-discovery-X.X.X-windows-x64-installer.exe --mode unattended --accepteula 1 --path "C:\Program Files\Lansweeper IT Agent Discovery" --cloudtoken cloudtokenvalue

   Proxy parameters

   To use a proxy, add the parameters --proxyserver proxyserveraddress and --proxyport.

Ideal for large-scale or centrally managed environments that rely on enterprise software distribution.

1. In your preferred site, go to Discovery > Systems > Download installers/packages > IT Agent Discovery.

2. Find the msi format and select Download IT Agent installer.

3. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

4. Run this command in an elevated Command Prompt, replacing cloudtokenvalue with your copied linking code and X.X.X with the installer version:

   Installer version

   The version numbers for your installer can be found in your Lansweeper site. Go to Discovery > Download installers/packages > Network Discovery installer > Version and locate your installer.

   msiexec /i "C:\Path\To\Lansweeper-IT-agent-discovery-X.X.X-windows-x64-installer.msi" /quiet ARGUMENTS="--mode unattended --accepteula 1 --path""C:\Program Files\Lansweeper IT Agent Discovery"" --cloudtoken cloudtokenvalue"

   Proxy parameters

   To use a proxy, add the parameters --proxyserver proxyserveraddress and --proxyport.

1. In your preferred site, go to Discovery > Systems > Download installers/packages > IT Agent Discovery.

2. Copy the following script:

   # ==============================================
   # Lansweeper IT Agent Discovery Silent Installer
   # ==============================================
   
   # --- 1. Set Cloud Token Variable ---
   $CloudToken = "cloudtokenvalue"   # Replace with your linking code
   
   # --- 2. Define Download URLs ---
   $InstallerUrl = "https://download.lansweeper.com/stable/windows/it-agent-discovery/latest"
   $ConfigUrl    = "https://download.lansweeper.com/stable/windows/lansweeper-it-agent-installation-config-stable/latest"
   
   # --- 3. Define Local File Paths ---
   $TempFolder   = "$env:TEMP\LansweeperInstaller"
   $InstallerExe = "$TempFolder\Lansweeper-IT-Agent-Discovery-Installer.exe"
   $ConfigFile   = "$TempFolder\install_config.cfg"
   
   # --- 4. Prepare Temp Folder ---
   if (Test-Path $TempFolder) {
       Remove-Item -Recurse -Force $TempFolder
   }
   New-Item -ItemType Directory -Path $TempFolder | Out-Null
   
   # --- 5. Download Installer and Config ---
   Write-Host "Downloading Lansweeper IT Agent Discovery installer..."
   Invoke-WebRequest -Uri $InstallerUrl -OutFile $InstallerExe
   
   Write-Host "Downloading Lansweeper config file..."
   Invoke-WebRequest -Uri $ConfigUrl -OutFile $ConfigFile
   
   # --- 6. Insert Cloud Token into Config ---
   Write-Host "Updating config file with cloud token..."
   (Get-Content $ConfigFile) -replace "cloudtokenvalue", $CloudToken |
       Set-Content $ConfigFile -Encoding UTF8
   
   # --- 7. Run Silent Install with Config ---
   Write-Host "Running silent installation..."
   Start-Process -FilePath $InstallerExe -ArgumentList "--mode unattended --optionfile `"$ConfigFile`"" -Wait -NoNewWindow
   
   # --- 8. Cleanup Installer ---
   if (Test-Path $InstallerExe) {
       Remove-Item $InstallerExe -Force
       Write-Host "Installer removed."
   }
   
   Write-Host "Lansweeper IT Agent Discovery installation completed."

3. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

4. In the first section of the script, replace cloudtokenvalue with your copied linking code.

5. Save your file as a PowerShell script, for example Install-LSITAgent.ps1.

6. In PowerShell, run a silent installation: --mode unattended --config "install_config.cfg" .

7. Run the PowerShell script with administrative privileges.

Next steps

Now that your IT Agent is installed, you can create a discovery action to specify when discovery should occur.