Run IT Agent Discovery Portable

Lansweeper IT Agent Discovery Portable runs on Windows without requiring installation. It allows on-demand local discovery without credentials, making it an efficient solution for scanning specific or hard-to-reach assets.

IT Agent Discovery vs. IT Agent Discovery Portable

IT Agent Discovery and IT Agent Discovery Portable both collect detailed inventory data from remote or offline devices, but they differ in how they’re deployed and used.

In short:

• IT Agent Discovery gives you continuous visibility of off‑network or roaming endpoints.

• IT Agent Discovery Portable provides a flexible, one‑time way to audit unmanaged or short‑term systems.

Prerequisites

Before continuing, make sure:

• You have an existing Network Discovery installation in your environment.

• The required connections are open, and your Windows system meets the supported OS requirements.

Prepare your environment

1. In your site, select Discovery > systems > Download installers/packages.

2. Under IT Agent Discovery, select both:

   • Download IT Agent Portable

   • Download IT Agent Portable configuration

3. On the computer hosting, navigate to your Network Discovery Hub.

4. In the hub, go to Settings > Data Transfer > IT Agent Portable code(s).

5. Select Enable file import.

6. Enter a name for the import folder. The default is::

   • Windows: C:\Program Files\Lansweeper Network Discovery\hub\import

   • Linux/macOS: ./import

7. Select Generate key, then copy the key.

8. Select Save File Import Settings > OK.

Run IT Agent Discovery Portable and save results to a file

Run IT Agent Discovery Portable from a directory that provides elevated privileges for best performance.

Execute on a single machine

1. Open an elevated PowerShell command prompt.

2. Extract the contents of the downloaded package:

   tar -xf C:\Users\%USERNAME%\Downloads\Lansweeper.IT.Agent.Portable.zip C:\Temp\Lansweeper-IT-Agent-Portable

3. Start the local scan. Replace fileimportkey with the key you copied earlier:

   C:\Temp\Lansweeper-IT-Agent-Portable\Lansweeper-IT-agent-portable-windows-x64.exe scan --file C:\Temp\Lansweeper-IT-Agent-Portable\discoveryresult-%COMPUTERNAME%.data --key fileimportkey

Deploy via logon script (Active Directory)

Run the IT Agent Portable on all Windows domain computers at logon.

1. Copy Lansweeper.IT.Agent.Portable.zip to your NETLOGON share (default: C:\WINDOWS\SYSVOL\domain\scripts).

2. Open an elevated PowerShell command prompt.

3. Extract the contents of the ZIP file. Replace DomainController01.domain.local with your domain controller name:

   Expand-Archive -Force \\DomainController01.domain.local\NETLOGON\Lansweeper.IT.Agent.Portable.zipC:\Temp\Lansweeper-IT-Agent-Portable

4. Run the scan, replacing fileimportkey with your copied key:

   C:\Temp\Lansweeper-IT-Agent-Portable\Lansweeper-IT-agent-portable-windows-x64.exe scan --file C:\Temp\Lansweeper-IT-Agent-Portable\discoveryresult-%COMPUTERNAME%.data --key fileimportkey

Post-execution steps

1. After a successful run, copy the discovery result file:

   C:\Temp\Lansweeper-IT-Agent-Portable\discoveryresult-%COMPUTERNAME%.data

2. On the Network Discovery Hub machine, navigate to the import folder:

   C:\Program Files\Lansweeper Network Discovery\hub\Import

3. Paste the .data file into this folder. The hub automatically syncs it with your site.

4. In your site, go to Assets to confirm the asset details have been updated.

Run IT Agent Discovery Portable and send results directly to a Network Discovery Hub

Run IT Agent Discovery Portable with elevated privileges for best results. This method sends discovery data directly to the Hub without needing a manual import.

Method 1: Run directly with Hub URI

1. Ensure the device can connect to your Network Discovery Hub (https://mynetworkdiscoveryhub.domain.local:59525 by default).

2. Open an elevated PowerShell command prompt.

3. Extract the ZIP package:

   Expand-Archive -Force C:\Users\%USERNAME%\Downloads\Lansweeper.IT.Agent.Portable.zip C:\Temp\Lansweeper-IT-Agent-Portable

4. Start the scan, replacing the Hub URL and key as appropriate:

   C:\Temp\Lansweeper-IT-Agent-Portable\Lansweeper-IT-agent-portable-windows-x64.exe scan -h https://mynetworkdiscoveryhub.domain.local:59525 --key fileimportkey

Method 2: Use the configuration file

1. Ensure the asset can access your Network Discovery Hub (https://mynetworkdiscoveryhub.domain.local:59525 by default).

2. Open an elevated PowerShell command prompt and extract the package:

   Expand-Archive -Force C:\Users\%USERNAME%\Downloads\Lansweeper.IT.Agent.Portable.zip C:\Temp\Lansweeper-IT-Agent-Portable

3. Open the downloaded configuration file (scanoptions.json) and update it to include your values:

   {
     "ScanOptions": {
       "Key": "IT Agent Portable key from your Network Discovery Hub",
       "File": "optional: path where discovery output is saved, e.g. discoveryresult.data",
       "HubUri": "optional: your Network Discovery Hub URI, e.g. https://mynetworkdiscoveryhub.domain.local:59525"
     }
   }

4. Run the scan:

   C:\Temp\Lansweeper-IT-Agent-Portable\Lansweeper-IT-agent-portable-windows-x64.exe scan