Agent Uninstaller (standalone tool)
The PDQ Agent Uninstaller is a troubleshooting tool designed to completely remove the PDQ Connect agent and its component applications.
Where to Download
The latest uninstaller can be downloaded from the link below.
Overview
The PDQ Agent Uninstaller supports removing the following applications:
- PDQ Connect Agent
- PDQ Connect Updater
- PDQ Remote Desktop Agent
- PDQ Remote Desktop Viewer
By default, the tool removes any of the applications listed above that are installed on the device. You can also choose to remove specific applications by using command-line parameters or by manually selecting them when running the tool.
Important: Using the uninstall utility to remove the agent will not delete the device from app.pdq.com. To prevent leaving a stale device, you should manually delete it from the Connect app.
Interactive Mode
The agent uninstaller can be run either interactively in Windows or from the command line. To run the tool interactively, simply double-click on PDQAgentUninstaller.exe to open the main menu.
From the menu, you can:
- Remove all supported components.
- Select specific components to remove.
- View command-line help and available parameters.
Administrative privileges are required to run the uninstaller. If the user does not have local administrator rights, it must be run by an administrator or deployed using a management tool with the necessary permissions.
Command-Line Parameters
The Agent uninstaller also supports command-line operation for use in CMD, PowerShell, scripts and deployment tools.
Note: CLI mode does not run silently by default. If you are running the tool in a script, make sure to specify silent mode using the /s parameter to prevent the installer from hanging while waiting for user input.
Application Selection
| Parameter | Aliases | Application |
|---|---|---|
| /agent | PDQ Connect Agent | |
| /updater | PDQ Connect Updater | |
| /rdagent | /rd, /isl | PDQ Remote Desktop Agent |
| /rdviewer | /viewer | PDQ Remote Desktop Viewer |
Options
| Parameter | Aliases | Description |
|---|---|---|
| /s | /silent, /q, /quiet | Run silently with no prompts or user interaction |
| /audit | Audit Mode — reports what would be removed without making changes | |
| /? | /help, /h | Display help information |
Switches are case-insensitive and support /, -, and -- formats.
Command-Line Examples
# Remove all four components silently
PDQAgentUninstaller.exe /s
# Remove only the Connect Agent and Agent Updater
PDQAgentUninstaller.exe /agent /updater /s
# Remove only the PDQ Remote Desktop Agent
PDQAgentUninstaller.exe /rdagent /s
# Remove only the PDQ Remote Desktop Viewer
PDQAgentUninstaller.exe /rdviewer /s
# Audit all components without removing anything
PDQAgentUninstaller.exe /audit
# Silently audit only the Connect Agent
PDQAgentUninstaller.exe /audit /agent /sAudit Mode
Audit Mode shows what the tool would remove without making any changes to the device. Use it to verify the scope of an uninstall before running it, or to identify any components that may remain from a previous uninstall.
You can launch Audit Mode from the interactive menu by choosing Select Specific Components then Audit Mode, or by running the tool with the /audit command-line parameter.
Log File
When the uninstaller finishes, it creates a log file at:
%SYSTEMROOT%\Temp\PDQConnectAgentUninstall.log
The log includes the same information shown in the console, making it useful for reviewing the results after the tool has run. You can use it to see which applications were detected, what removal actions were taken, any warnings that were generated, and the results of the cleanup process.
Deploying with PDQ Deploy
The Agent Uninstaller can also be deployed remotely using PDQ Deploy. To create a PDQ Deploy package with the uninstaller:
- Copy PDQAgentUninstaller.exe to your PDQ Deploy Repository.
- Create a new package and add an Install step.
- Select PDQAgentUninstaller.exe as the install file.
- Enter the desired command-line parameters in the Parameters field (see examples above).
- Deploy the package to the target devices.
Important: Just like when running the Agent Uninstaller from a script, you must specify the /s parameter when deploying it with PDQ Deploy. Without it, the application will wait for user input, which may cause the deployment to hang or fail to complete successfully.
