How to scan individual Windows computers with the LsPush scanning agent

Lansweeper includes several scanning methods to scan the assets in your network. You can scan the Linux, Unix, Mac and Windows computers, VMware servers and other devices in your network without installing any Lansweeper software on the machines you're scanning. For Windows computers, you can optionally choose to perform your scans with a scanning agent however. Lansweeper's scanning agent is called LsPush.

LsPush is a small executable that, when run on a Windows computer, scans the computer locally. LsPush cannot and does not need to be installed on the computer you're scanning. The LsPush executable must simply be executed on the computer whenever you want to scan the machine. The LsPush scan results can be sent directly to your Lansweeper server for automatic processing or stored in a file, which can be imported into your Lansweeper installation later on. There are many ways to run LsPush on your machines. Basically any process that can run the LsPush executable, preferably with a parameter, can trigger LsPush scans of your machines. LsPush scans can be fully automated for instance by integrating the scanning agent into logon scripts, group policies or scheduled tasks.

This article explains what the most basic way is to scan a Windows computer using LsPush, i.e. by manually running the executable. This scanning approach can be useful if you have a stock computer for instance that you quickly want to scan without fully deploying it in your network.

This article only explains how to perform a basic, manual scan of a single Windows computer using the LsPush scanning agent. There are many other methods to run LsPush on one or more machines in your network, including silent and automated methods. A list of other ways to run LsPush can be found in this knowledge base article.


To scan individual Windows computers with the LsPush scanning agent, do the following:

  1. On the machine hosting your Lansweeper installation, browse to the folder below and copy the LsPush executable contained within.
    Program Files (x86)\Lansweeper\Client
    LsPush.exe in Program Files (x86)\Lansweeper\Client
    When you update your Lansweeper installation, the latest version of the LsPush executable is automatically added to the Client folder on your Lansweeper server. Make sure to use the latest LsPush executable to scan your machines, as scanning with old agents can cause incomplete data to be returned. If you have just updated Lansweeper and are scanning with LsPush in a logon script, group policy or scheduled task, copy the up-to-date LsPush to any folder referenced by your script, policy or task.
  2. Paste the LsPush executable into any folder on the Windows computer you want to scan.
  3. Double-click the LsPush executable to run it. LsPush will perform a full local scan of the machine it's running on, as you can see by the on-screen progress bar. The scan may take half a minute or so to complete. Once the scan has completed, LsPush opens the default email program configured on the computer and attaches the scan results as a text file to a draft email. This is so you can easily send the results to whoever is managing your Lansweeper installation.
    running LsPush manually
    LsPush scan results attached to email
    If there is no default email program configured on the computer, you may see errors similar to the ones below, but you can still find the scan results as a text file in the %localappdata%\Temp\lspush folder on the scanned computer. This folder is automatically opened when you close the error messages below.
    There is no email program associated to perform the requested action. Please install an email program or, if one is already installed, create an association in the Default Programs control panel.
    One or more unspecified errors occurred; no message was sent.
    LsPush files are compressed and hence not human-readable in their raw form. The Lansweeper scanning service decompresses and reads the data when the files are imported.
  4. Without making any changes to the text file generated by LsPush, place it in the folder below on the machine hosting your Lansweeper installation. If your Lansweeper installation is spread out over several machines, you can find the folder below on the machine hosting the Lansweeper Server service, which is the scanning service.
    Program Files (x86)\Lansweeper\Service\import
    importing LsPush scan results
    Do not make any changes to the extension or contents of the file generated by LsPush prior to placing it in the import folder. File changes can cause import failures.
  5. Wait for the text file generated by LsPush to disappear from the import folder, indicating that the import process has completed.
  6. Perform a search for the name of the scanned computer in the web console search bar, which takes you to the machine's Lansweeper webpage. The Scan time tab of the machine's asset page should also indicate an LsPush scan has taken place. If the search bar finds no asset for the scanned computer, the import may have failed for any of the following reasons: you've reached your Lansweeper license's asset limit, your Lansweeper database is full, the Windows computer is excluded from scanning, the text file generated by LsPush was modified by an anti-virus scanner or other program.
    performing a search for a Windows computer
    Last LsPush Scan in Scan Time tab of a Windows computer

Related Articles

Get Started Right Away

Try Lansweeper for Free