Installing the Agent (BETA) with PowerShell or CLI

<< Click to Display Table of Contents >>

Installing the Agent (BETA) with PowerShell or CLI

In order for the optional Agent to perform tasks, it needs to be installed on each individual computer. The Agent can be installed using PowerShell or the CLI, within the PDQ Inventory Console, or using the Setup Wizard. This chapter covers installations using PowerShell or CLI. For the PDQ Inventory Console or the Setup Wizard, see Installing the Agent (BETA). (The Agent requires Enterprise mode running Central Server.) For more information, see Agent (BETA).

If the Agent has already be installed, see Reconfiguring the Agent (BETA).

This section contains the following topics:

Installation for External Computers using PowerShell or CLI

Computer Already Scanned

Computer Not Scanned

Confirm Successful Installation

Installation for External Computers using PowerShell or CLI

For External computers that are not on your network, the Agent will need to be installed and configured using PowerShell or the CLI. The installation differs depending on whether or not the computer has previously been scanned. Both methods are listed here.

Computers Already Scanned

When the computer has already been scanned, the configuration file can be generic.

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 Computers 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.On the target computer, open an elevated PowerShell or Command Prompt (CLI).

7.Within either PowerShell or CLI, navigate to the folder where both files were saved.

8.Execute the installer and config file with the following command: AgentInstaller.exe /S /Config AgentInstaller.Config.xml

The Agent is now installed and configured.

Computers Not Scanned

When the computer has not been scanned, the configuration file must be specific to the individual computer.

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

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.On the target computer, open an elevated PowerShell or Command Prompt (CLI).

8.Within either PowerShell or CLI, navigate to the folder where both files were saved.

9.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, 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)

Reconfiguring the Agent (BETA)

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