Synopsis
Removes one or more local agent identity values (ID, LocationID, MAC) from the registry and restarts the services, causing the agent to re-register with the Automate server. When called without parameters, all three values are cleared. If MAC filtering is enabled on the server, the agent will re-register under its original ID.
Syntax
Parameters
Clears the
ID (AgentID) registry value. When the service restarts, the agent will request a new ID from the server.Clears the
LocationID registry value. The agent will re-request its location assignment on next check-in.Clears the
MAC registry value. The agent will re-register its MAC address on next check-in.Overrides the probe-agent safety check. By default, the function refuses to reset an agent that has the Probe role enabled. Specify
-Force to proceed anyway.Skips the post-restart health check. The function exits as soon as the registry values have been removed and the services have been restarted, without waiting for the agent to receive a new ID, LocationID, and MAC from the server.
Shows what would happen if the command runs without actually removing any registry values or restarting services.
Prompts for confirmation before making any changes.
Behavior
- If none of
-ID,-Location, or-MACare specified, all three are reset. - The function reads the current values from
HKLM:\SOFTWARE\LabTech\Serviceand prints the oldID,LocationID, andMACbefore making any changes. - Before clearing the registry values,
Stop-LTServiceis called. After clearing them,Start-LTServiceis called. - Unless
-NoWaitis specified, the function polls for up to 1 minute after the service starts, waiting for the agent to populate newID,LocationID, andMACvalues in the registry. The new values are printed when found. - If the agent is detected as a Probe (
Probe=1in the registry) and-Forceis not specified, the function terminates with an error.
If MAC filtering is enabled on the Automate server, clearing the MAC address and re-registering will associate the new agent record with the same MAC, allowing the server to match the agent to its existing record.