Reconfiguring the Agent (BETA)

<< Click to Display Table of Contents >>

Reconfiguring the Agent (BETA)

In order for the optional Agent to perform tasks, it needs to be configured properly on each individual computer. If, for any reason, the Agent is installed but not properly configured you can reconfigure it. (The Agent requires Enterprise mode running Central Server.) For more information, see Agent (BETA). If the Agent has not yet been installed, see Installing the Agent (BETA) or Installing the Agent (BETA) with PowerShell or the CLI.

This section contains the following topics:

Reconfigure the Agent (computer already scanned)

Automatically

PowerShell or CLI

Reconfigure the Agent (computer not scanned)

Automatically

PowerShell or CLI

Confirm Successful Configuration

Reconfigure the Agent (Computer Already Scanned)

For External computers, the Agent can be reconfigured automatically (which can take up to five minutes) or immediately using PowerShell or CLI. The methods listed below are for computers that have already been scanned in PDQ Inventory.

Automatically

To reconfigure the Agent for a computer that has been scanned:

1.Open Windows Explorer on the PDQ Inventory console computer.

2.Go to the directory C:\Program Files (x86)\Admin Arsenal\PDQ Inventory

3.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

4.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.

The Agent is now configured properly.

PowerShell or CLI

To reconfigure the Agent using PowerShell or CLI for a computer that has been scanned:

1.Open Windows Explorer on the PDQ Inventory console computer.

2.Go to the directory C:\Program Files (x86)\Admin Arsenal\PDQ Inventory

3.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.

4.On the target computer, open an elevated PowerShell or Command Prompt (CLI).

5.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)

For External computers, the Agent can be reconfigured automatically (which can take up to five minutes) or immediately using PowerShell or CLI, The methods listed below are for computers that have not yet been scanned in PDQ Inventory.

Automatically

To reconfigure the Agent for 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 (BETA) (or click Computer > View Computer Details (or press Ctrl+O), navigate to the Agent (BETA) 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.Open Windows Explorer on the PDQ Inventory console computer.

4.Go to the directory where the config file is saved, typically C:\Program Files (x86)\Admin Arsenal\PDQ Inventory

5.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

6.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.

PowerShell or CLI

To reconfigure the Agent using PowerShell or CLI for 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 (BETA) (or click Computer > View Computer Details (or press Ctrl+O), navigate to the Agent (BETA) 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.Open Windows Explorer on the PDQ Inventory console computer.

4.Go to the directory where the config file is saved, typically C:\Program Files (x86)\Admin Arsenal\PDQ Inventory

5.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.

6.On the target computer, open an elevated PowerShell or Command Prompt (CLI).

7.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.

Confirm Successful Configuration

To confirm the Agent has been installed and configured, 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.

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 (BETA) 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 installation and status using collections:

1.On the Main Console, expand the Collection Library in the tree.

2.Expand Applications > Utilities > PDQ > PDQ Agent.

This displays all the Agent collections.

3.Select the collection you want to view.

See also

Agent (BETA)

Installing the Agent (BETA)

Installing the Agent (BETA) with PowerShell or CLI

Uninstalling the Agent (BETA)

 

 

 

© 2019 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: 18.0.2.0