In order for the optional Agent to perform tasks, it needs to be installed on each individual computer. The Agent can be installed on computers in your network within the PDQ Inventory Console and manually to those that are not on your network. (The Agent requires Enterprise mode running Central Server.) For more information, see Agent.
This section contains the following topics:
•Install within the PDQ Inventory Console
•Install Manually (computer already scanned)
•Install Manually (computer not scanned)
•Confirm Successful Installation
•Reconfigure the Agent (computer already scanned)
•Reconfigure the Agent (computer not scanned)
Install Within the PDQ Inventory Console
For an Internal computer that is connected to your network, the Agent can be installed directly through PDQ Inventory. This installation is done silently without scripting, manual configuration, or interruption to the end user. You can either install to multiple computers at once, or install to one computer at a time. Both methods are listed below:
To install the Agent through PDQ Inventory to multiple Internal computers:
1.The computers must first be added to PDQ Inventory. For assistance, see Adding Computers.
2.On the Main Console window, select the All Computers page in the tree, or open a collection page.
3.Select the computer(s) that will receive the Agent.
4.On the Main Console toolbar, click Computer > Install Agent (or right-click and select Install Agent).
This launches a silent installation on the selected computers.
5.To view the installation status, click the Customize this grid button 
(upper left corner) or right-click the column header and select Edit Columns.
6.In the Hidden Columns, select Agent Status and move it to the Visible Columns.
7.Click Close.
This adds the column to the Main Console window, which will display Installing 
.
NOTE: It is normal to see it briefly display Not Installed before displaying the Agent Status.
To install the Agent through PDQ Inventory to one Internal computer:
1.Add the computer to PDQ Inventory. For assistance, see Adding Computers.
2.On the Main Console window, select the All Computers page in the tree, or open a collection page.
3.Select the computer, then click Computer > View Computer Details (or press Ctrl+O or double-click it).
This opens the Computer window.
4.Select the Agent 
page.
5.Click Install Agent (or click Computer > Install Agent on the toolbar).
This launches a silent installation on the selected computer. The Agent page indicates the installation is in progress with a waiting icon .
NOTE: It is normal to see it briefly display Not Installed before displaying the Agent Status.
Install Manually (Computer Already Scanned)
For External computers that are not on your network, but have been scanned, the Agent will need to be installed manually. With this method, the configuration file is not specific to an individual computer.
To install the Agent manually to a scanned computer:
1.Add the Computer to PDQ Inventory. For assistance, see Adding Computers.
2.Scan the computer once if it has not already been scanned.
NOTE: If the computer has not been scanned, use the Install the Agent Manually (Computer Not Scanned) method.
3.Open Windows Explorer on the PDQ Inventory console computer.
4.Go to the directory C:\Program Files (x86)\Admin Arsenal\PDQ Inventory
5.Copy AgentInstaller.exe and AgentInstaller.Config.xml to the target computer within the same folder.
6.Install with the GUI using step 7 or skip to step 8 to install with the CLI or PowerShell
7.Install using the GUI:
a.On the target computer, double-click AgentInstaller.exe
b.On the PDQ Inventory Agent Setup window, follow the prompts.
c.Once installed, click Finish to exit the Setup Wizard.
8.Install using PowerShell or CLI:
a.On the target computer, open an elevated PowerShell or Command Prompt (CLI).
b.Within either PowerShell or CLI, navigate to the folder where both files were saved.
c.Execute the installer and config file with the following command: AgentInstaller.exe /S /Config AgentInstaller.Config.xml
The Agent is now installed and configured.
Install Manually (Computer Not Scanned)
For External computers that are not on your network, and have never been scanned, the Agent will need to be installed manually. The method below allows you to perform the installation and apply the config file at the same time.
To install the Agent manually to a computer that has not yet been scanned:
1.Add the Computer to PDQ Inventory. For assistance, see Adding Computers.
2.On the Main Console, select the All Computers page in the tree, or open a collection page.
3.Select a computer, then click Computer > Agent Manual Install File (or click Computer > View Computer Details (or press Ctrl+O), navigate to the Agent page and click Agent Manual Install File).
This prompts you to save the config file.
NOTE: The config file is specific to the selected computer and is named accordingly. For example, Matt-Laptop.Config.xml
4.Open Windows Explorer on the PDQ Inventory console computer.
5.Go to the directory where the config file is saved, typically C:\Program Files (x86)\Admin Arsenal\PDQ Inventory
6.Copy AgentInstaller.exe and <ComputerName>.Config.xml to the target computer within the same folder.
7.Install with the GUI using step 8 or skip to step 9 to install with the CLI or PowerShell.
8.Install using the GUI:
a.On the target computer, rename AgentInstaller.exe to <ComputerName>.exe
b.Double-click <ComputerName>.exe
c.On the PDQ Inventory Agent Setup window, follow the prompts.
d.Once installed, click Finish to exit the Setup Wizard.
9.Install using PowerShell or CLI:
a.On the target computer, open an elevated PowerShell or Command Prompt (CLI).
b.Within either PowerShell or CLI, navigate to the folder where both files were saved.
c.Execute the installer and config file with the following command: AgentInstaller.exe /S /Config <ComputerName>.Config.xml
The Agent is now installed and configured.
Confirm Successful Installation
To confirm the Agent has been installed, per computer:
1.Select a computer, then click Computer > View Computer Details (or press Ctrl+O or double-click it).
This opens the Computer window.
2.Select the Agent page.
3.The Status field will display Internal, External, or Unavailable. If the Agent has not been installed, this field will display Not Installed.
4.The Version field will also display the version of the Agent. If the Agent has not been installed, this field will remain blank.
To confirm the Agent has been installed, on multiple computers:
1.On the Main Console, select the All Computers page in the tree, or open a collection page.
2.Click the Customize this grid button (upper left corner) or right-click the column header and select Edit Columns.
3.In the Hidden Columns, select Agent Status and Agent Version and move them to the Visible Columns.
4.(Optional) Rearrange the column order.
NOTE: The column Agent Last Seen can also be moved to the Visible Columns.
5.Click Close.
This adds the selected columns to every collection page.
6.The Agent Status column will display Internal or External if it is installed. If the Agent has not been installed, this field will display Not Installed. If the Agent is installed but unable to communicate, this column will display Unavailable.
7.The Agent Version column will display the version of the Agent installed on the computer. If the Agent has not been installed, this field will remain blank.
Reconfigure the Agent (Computer Already Scanned)
To reconfigure the Agent on a computer that has been scanned:
1.You can reconfigure it automatically using step 2 or skip to step 3 to use PowerShell or CLI:
2.Automatically
a.Open Windows Explorer on the PDQ Inventory console computer.
b.Go to the directory C:\Program Files (x86)\Admin Arsenal\PDQ Inventory
c.Copy AgentInstaller.Config.xml to the target computer in either %ProgramData%\Admin Arsenal\PDQ Inventory Agent or C:\Program Files (x86)\Admin Arsenal\PDQ Inventory Agent
d.Wait for the AgentInstaller.Config.xml file to convert to AgentInstaller.Config.xml.bak
NOTE: This can take up to five minutes as the Agent only checks for config files during a heartbeat.
e.Open Windows Explorer on the PDQ Inventory console computer.
f.Go to the directory C:\Program Files (x86)\Admin Arsenal\PDQ Inventory
g.Copy AgentInstaller.Config.xml to the target computer in any folder.
NOTE: If the file is saved to either %ProgramData%\Admin Arsenal\PDQ Inventory Agent or C:\Program Files (x86)\Admin Arsenal\PDQ Inventory Agent the file will automatically convert and could cause your script to error.
h.On the target computer, open an elevated PowerShell or Command Prompt (CLI).
i.Execute with the following command: ”C:\Program Files (x86)\Admin Arsenal\PDQ Inventory Agent\PDQInventoryAgent.exe” /Config AgentInstaller.Config.xml
The Agent is now configured properly.
Reconfigure the Agent (Computer Not Scanned)
To reconfigure the Agent manually to a computer that has not yet been scanned:
1.On the Main Console, select the All Computers page in the tree, or open a collection page.
2.Select a computer, then click Computer > Agent Manual Install File (or click Computer > View Computer Details (or press Ctrl+O), navigate to the Agent page and click Agent Manual Install File).
This prompts you to save the Config file.
NOTE: The config file is specific to the selected computer and is named accordingly. For example, Matt-Laptop.Config.xml
3.You can reconfigure the Agent automatically using step 4 or skip to step 5 to use PowerShell or CLI:
4.Automatically
a.Open Windows Explorer on the PDQ Inventory console computer.
b.Go to the directory where the config file is saved, typically C:\Program Files (x86)\Admin Arsenal\PDQ Inventory
c.Copy <ComputerName>.Config.xml to the target computer in either %ProgramData%\Admin Arsenal\PDQ Inventory Agent or C:\Program Files (x86)\Admin Arsenal\PDQ Inventory Agent
d.Wait for the <ComputerName>.Config.xml file to convert to <ComputerName>.Config.xml.bak
NOTE: This can take up to five minutes as the Agent only checks for config files during a heartbeat.
a.Open Windows Explorer on the PDQ Inventory console computer.
b.Go to the directory where the config file is saved, typically C:\Program Files (x86)\Admin Arsenal\PDQ Inventory
c.Copy <ComputerName>.Config.xml to the target computer in any folder.
NOTE: If the file is saved to either %ProgramData%\Admin Arsenal\PDQ Inventory Agent or C:\Program Files (x86)\Admin Arsenal\PDQ Inventory Agent the file will automatically convert and could cause your script to error.
d.On the target computer, open an elevated PowerShell or Command Prompt (CLI).
e.Execute with the following command: ”C:\Program Files (x86)\Admin Arsenal\PDQ Inventory Agent\PDQInventoryAgent.exe” /Config <ComputerName>.Config.xml
The Agent is now configured properly.
Uninstall the Agent
To uninstall the Internal Agent:
1.On the Main Console, select the All Computers page in the tree, or open a collection page.
2.Select one or more computers and right-click, then click Uninstall Agent (or click Computer > Uninstall Agent).
The Agent Status column will display Uninstalling.
WARNING: Uninstalling from the Applications page of the Computer window does uninstall the Agent from the target computer, however, PDQ Inventory will still display the Agent as Unavailable and all scans will be stuck in a pending state. To remedy this, follow steps 1 and 2 above.
See also
© 2018 PDQ.com Corporation. All rights reserved.
PDQ.com is a trademark of PDQ.com Corporation. All other product and company names are the property of their respective owners.
Help Version: 16.0.3.0