A2D Agent massive distribution with GPO


The purpose of this document is to explain how to distribute the A2DAgent with or without proxy authentication through the use of an Active Directory group policy (GPO).


Installation types

The installation of the agent depends exclusively on the internet connection that has the Endpoint where it is to be installed, then the different types of configuration supported are listed:

  • A2DAgent (without Proxy)
  • A2DAgent (with Proxy)
  • A2DAgent (with Proxy Authentication)

Note:   If the Internet connection with authenticated proxy is used, this User Proxy will be used for all A2DAgent communications.


Requisites


Download and copy A2DAgent

 

Login at https://admin.apps2digital.com/

 

In the “Choose the customer” portal, select “Customer Name” and press click. 

  • In the “Endpoint Agent” box, select “Download” and press click. 
  • The file will automatically download in the folder chosen by the user.

 

Once the file has been downloaded from the Internet, it is locked. Go to the file properties and select the checkbox “Unblock” to unlock it.  

Copy the downloaded exe file to the shared folder with reading permissions. In this example, shared folder is \\flx.local\netlogon.


Create GPO Distribute A2D Agent

Create GPO in Domain Controller with the name “Distribute A2D Agent”

- Open group policy Management

- Go to Group Policy Object. Click “New” and set the name


Create Registry Keys (GPO)

 

Edit the “Distribute A2D Agent” policy and go to User Configuration\Preferences\Windows Settings\Registry


New Registry Item

 

Depending on the type of internet connection of the endpoint, the necessary registration keys will be created:

A2DAgent without Proxy: Create CustomerSID 

A2DAgent with Proxy: Create CustomerSID, ProxyUri 

A2DAgent with Proxy Authentication: Create CustomerSID, ProxyUri, ProxyUser, and ProxyPassword 

Check the following article if you have doubts about registry entries.


-Example for creating the Registry Key


Create script to launch A2DAgent

Create a script with the name LaunchA2DAgent.ps1 with the following content:

$exefile = Join-Path $env:TEMP "Apps2Digital-Installer.exe"

# Wait for session startup
Start-sleep -Seconds 30
Start-Process $exefile 

 

Copy the Script in \\flx.local\SYSVOL\flx.local\scripts\LaunchA2DAgent.ps1 (“flx.local” is the example above)


Copy Setup in Temporary User folder (GPO)

Edit the “Distribute A2D Agent” policy and go to User Configuration\Preferences\Windows Settings\Files\Logon, and create a newly copied file.


Assign script to LaunchA2DAgent in Logon (GPO)

Edit the “Distribute A2D Agent” policy and go to User Configuration\Policies\Windows Settings\Scripts (Logon/Logoff)\Logon, and create new Powershell Scripts


If GPO is linked in Organization Unit (OU) with only Computer objects, remember to configure loopback processing setting.

The setting is located on Computer Configuration > Policies > Administrative Templates > System > Group Policy > Configure user Group Policy loopback processing mode.


The GPO will be applied when you log in again.

Was this article helpful?

Can't find what you're looking for?

Contact Support