Skip to main content
This page walks you through importing the module and installing a LabTech agent on a machine for the first time. Every command must be run in an Administrator PowerShell session.
The module installs Windows services and writes to HKLM:\SOFTWARE\LabTech. You must run PowerShell as Administrator or every service-management command will throw: “Needs to be ran as Administrator”.
1

Import the module

The fastest way to load the module is to download and execute it directly from the LabTech Consulting shortlink. No file is saved to disk; the module is loaded into the current session only.
(New-Object Net.WebClient).DownloadString('https://bit.ly/LTPoSh') | iex
This command evaluates the module source in-memory. If you need to load it from a local file instead, see the Installation page.
2

Verify the module loaded

Confirm the module is available by pulling the current agent registry information. If the agent is not yet installed, the command returns $null and emits an informational error — that is expected at this stage.
Get-LTServiceInfo
When no agent is installed you will see:
Get-LTServiceInfo : ERROR: Line 154: Unable to find information on LTSvc. Make sure the agent is installed.
That error confirms the module is loaded and working. To verify the module version directly:
(Get-Module | Where-Object { $_.Name -like '*LabTech*' }).Version
3

Install the agent

Call Install-LTService with your server URL, server password, and target location ID. The function downloads the agent MSI from your server, runs the installer, and waits up to three minutes for the agent to register.
Install-LTService -Server 'https://lt.domain.com' `
                  -ServerPassword 'YourServerPassword' `
                  -LocationID 42
ParameterRequiredDescription
-ServerYesURL of your LabTech server. Bare hostnames and http:// are also accepted; https:// is prepended automatically if omitted.
-ServerPasswordYes (or use -InstallerToken)The server password from SELECT SystemPassword FROM config; in the Automate database.
-LocationIDNo (defaults to 1)The numeric location ID the agent should appear under.
-InstallerTokenAlternative to -ServerPasswordA deployment token from the Automate Deployment page, for tokenised MSI installs.
Preview what Install-LTService would do without executing anything:
Install-LTService -Server 'https://lt.domain.com' -ServerPassword 'pass' -LocationID 42 -WhatIf
The installer retries the MSI up to three times if LTService does not appear after the first run. On success:
LabTech has been installed successfully. Agent ID: 1234 LocationID: 42
4

Confirm the install succeeded

After the installer exits, read the agent’s registry values to verify it registered correctly.
Get-LTServiceInfo
Successful output includes the agent ID, server address, and location:
ID            : 1234
LocationID    : 42
Server        : https://lt.domain.com
BasePath      : C:\Windows\LTSVC
ServerVersion : 240.xxx
You can also confirm the Windows services are running:
Get-Service LTService, LTSvcMon | Select-Object Name, Status
Both services should report Running.
5

Restart the agent service

To restart the agent after a configuration change, use Restart-LTService. It stops LTService and LTSvcMon, waits for the Stopped state, then starts both services and waits for Running. After startup it automatically sends a Send Status command so the agent checks in with the server immediately.
Restart-LTService
On success:
Services Restarted successfully.
To stop or start services independently:
Stop-LTService
Start-LTService

​
Troubleshooting

Agent installed but did not register within 3 minutes: The install completes but Get-LTServiceInfo shows no ID. Check that the machine can reach the LabTech server on HTTPS, then restart the agent: 
Restart-LTService
Previous installation remnants detected: Install-LTService automatically calls Uninstall-LTService when it finds leftover files or registry keys under HKLM:\Software\LabTech\Service or in %windir%\LTSVC. To trigger this manually: 
Uninstall-LTService -Server 'https://lt.domain.com'
Reinstall from scratch: Redo-LTService reads the current registry settings, uninstalls the agent, and reinstalls it in one command: 
Redo-LTService
Or supply parameters explicitly: 
Redo-LTService -Server 'https://lt.domain.com' -ServerPassword 'pass' -LocationID 42

Build docs developers (and LLMs) love

Get started for freeTalk to us