Skip to main content

​
Synopsis

Performs a full reinstall of the LabTech (ConnectWise Automate) agent by combining Uninstall-LTService and Install-LTService in a single operation, automatically reading current settings from the registry.

​
Description

Redo-LTService is a convenience wrapper that orchestrates a complete agent reinstall:
  1. Reads current agent settings (server URL, location ID) from the registry via Get-LTServiceInfo.
  2. If the agent is not currently installed, falls back to Get-LTServiceInfoBackup to recover settings from a prior backup.
  3. Optionally runs New-LTServiceBackup if -Backup is specified.
  4. Calls Uninstall-LTService with the gathered server address.
  5. Waits 20 seconds for the uninstall to settle.
  6. Calls Install-LTService with the gathered (or overridden) settings.
If required settings cannot be found automatically, the function prompts interactively for the server URL and LocationID. Also available as the alias ReInstall-LTService.
Redo-LTService must be run in a PowerShell session with Administrator privileges.Probe agent protection: If the current agent is detected as a probe, the reinstall is blocked unless -Force is specified.

​
Syntax

# Deployment parameter set (ServerPassword)
Redo-LTService [[-Server] <String[]>] [[-ServerPassword] <String>] [[-LocationID] <String>]
    [-Backup] [-Hide] [[-Rename] <String>] [-SkipDotNet] [-Force] [-WhatIf] [-Confirm]
    [<CommonParameters>]

# InstallerToken parameter set
Redo-LTService [[-Server] <String[]>] [-InstallerToken <String>] [[-LocationID] <String>]
    [-Backup] [-Hide] [[-Rename] <String>] [-SkipDotNet] [-Force] [-WhatIf] [-Confirm]
    [<CommonParameters>]

​
Parameters

​
Server
String[]
The URL to the LabTech/Automate server. Used for both the uninstall and reinstall steps.If not provided, the function attempts to read the server address from the registry via Get-LTServiceInfo. If the agent is not installed, it tries Get-LTServiceInfoBackup. If neither source is available, the function prompts interactively.Accepts pipeline input by property name and by value.Example: https://lt.domain.com
​
ServerPassword
String
The system password agents use to authenticate with the server.Retrieve this value from the server database with:
SELECT SystemPassword FROM config;
Alias: Password. Accepts pipeline input by property name. Mutually exclusive with -InstallerToken.
​
InstallerToken
String
An installer token for customized MSI downloads via Deployment.aspx. Use as an alternative to -ServerPassword.Pattern: [0-9a-z]+ (lowercase alphanumeric only).Mutually exclusive with -ServerPassword.
​
LocationID
String
The Location ID the agent should be placed into after reinstall.If not provided, the function reads the current LocationID from the registry. If that also fails, it prompts interactively. Defaults to 1 if nothing is found.
​
Backup
SwitchParameter
If specified, runs New-LTServiceBackup before the uninstall step, preserving current agent settings for later recovery.
​
Hide
SwitchParameter
If specified, passes -Hide to Install-LTService to hide the agent entry in Add/Remove Programs after reinstall.
​
Rename
String
If provided, passes -Rename to Install-LTService to rename the agent entry in Add/Remove Programs to the specified string after reinstall.
​
SkipDotNet
SwitchParameter
Skips the .NET Framework 3.5 and .NET 2.0 prerequisite checks during reinstall. Passed through to Install-LTService.
​
Force
SwitchParameter
Allows the operation to proceed on a probe agent. Without this switch, probe agents are protected from reinstall.
​
WhatIf
SwitchParameter
Shows what actions would be performed without actually executing them.
​
Confirm
SwitchParameter
Prompts for confirmation before executing each significant action.

​
Examples

Reinstall using settings from the registry: 
Redo-LTService
Reads the server address and LocationID from the registry, uninstalls the current agent, and reinstalls it with the same settings.
Reinstall with explicit server, password, and location: 
Redo-LTService -Server https://lt.domain.com -Password sQWZzEDYKFFnTT0yP56vgA== -LocationID 42
Uses the provided parameters instead of reading from the registry. Useful when the registry is inaccessible or you want to move the agent to a different location.

​
Notes

  • This function is also available as the alias ReInstall-LTService.
  • A 20-second delay is introduced between the uninstall and install steps to allow services and file handles to fully release.
  • The server password is redacted in all verbose/output messages during execution.
  • -Force is implicitly passed to Uninstall-LTService and Install-LTService internally during the redo operation.

Build docs developers (and LLMs) love

Get started for freeTalk to us