Command-line utility for installing and uninstalling the FrameworX Windows services from scripts.
Reference → Installation Folders and Utilities → TManageServices CLI
New in 10.1.5. TManageServices.exe is now script-friendly with proper exit codes, unattended-mode detection, and a /silent flag for unattended automation pipelines.
Location under review. Final placement pending the next doc pass.
TManageServices.exe ships in the FrameworX utilities folder and wraps the install, uninstall, and start logic for every Windows service delivered by the product.
Use it directly from PowerShell, SCCM, Intune, Ansible, or any other automation pipeline. The Designer Runtime Startup tab calls the same utility through its AutoStartup button.
Syntax
TManageServices.exe <command> [options]
Running the utility with no arguments, /?, /help, --help, or -h prints the full help text and exits with code 0.
All service install and uninstall commands require elevated privileges. Launch the shell as Administrator.
Commands
TStartup
| Command | Effect |
|---|---|
/installtstartup /solution:"<path>" [/profile:<n>] | Installs TStartup as TStartup-<SolutionName> pointing at the named solution file. |
/uninstalltstartup /solution:"<name>" | Removes the TStartup service bound to the named solution. |
Other Services
| Command | Effect |
|---|---|
/installtwebservices / /uninstalltwebservices | Installs or removes TWebServices. |
/installtsecuregateway / /uninstalltsecuregateway | Installs or removes TSecureGateway. |
/installthardkey / /uninstallthardkey | Installs or removes THardkey (license daemon). |
/installtmqttbroker / /uninstalltmqttbroker | Installs or removes TMQTTBroker. |
/installruntimemcphttp / /uninstallruntimemcphttp | Installs or removes the .NET 10 RuntimeMCPHttp service. The command line uses dotnet plus the service DLL under net10.0. |
/removeallservices | Uninstalls every FrameworX service in one call. |
/installModbusRTUSim | Registers the ModbusRTU Simulator under HKLM\SOFTWARE\Adroit Technologies on first use. |
Options
| Option | Description |
|---|---|
/silent, /unattended, /quiet | Force unattended mode. The utility skips the "Press Enter to continue" prompt on error and always returns to the caller. |
/solution:"<value>" | Required for /installtstartup and /uninstalltstartup. Accepts a solution file path on install and a solution name on uninstall. |
/profile:<n> | Optional TStartup profile index. |
/?, /help, --help, -h | Print the help text and exit with code 0. |
When stdin is redirected (piped input from a script), the utility treats the session as unattended automatically, even without an explicit /silent flag.
The /silent, /unattended, and /quiet flags never appear in the registered service ImagePath. All other arguments pass through to the service install step.
Exit Codes
| Code | Meaning |
|---|---|
0 | All requested operations succeeded. |
N | Number of failed operations in the invocation. The utility aggregates failures across TSecureGateway, TStartup, and the TWebServices / THardkey / TMQTTBroker / RuntimeMCPHttp loop. |
In PowerShell, read $LASTEXITCODE after the call to branch your pipeline.
Examples
PowerShell Install
& "C:\Program Files\Tatsoft\FrameworX\fx-10\Utilities\TManageServices.exe" `
/installtstartup `
/solution:"C:\Solutions\Plant1.tproj" `
/silent
if ($LASTEXITCODE -ne 0) { throw "TStartup install failed with $LASTEXITCODE errors." }
Uninstall a Single Service
TManageServices.exe /uninstalltstartup /solution:"Plant1" /silent
Remove Every FrameworX Service
TManageServices.exe /removeallservices /silent
Capture Help to a File
TManageServices.exe /? | Out-File help.txt
Interactive vs Unattended
| Mode | Behavior on Error |
|---|---|
Interactive (no /silent, stdin not redirected) | Prints Press Enter to continue... and waits. |
Unattended (/silent present or stdin redirected) | Exits immediately with a non-zero code equal to the number of failures. |
In this section...