Skip to main content
Version: 24.5

Deployment of FlexxAgent with Group Policy (GPO)

FlexxAgent can be deployed using Group Policy in Windows (GPOs). For this, you need access to the agent installation package, which can be downloaded from the Flexxible portal.

Deployment

  1. Create a PowerShell script called Install.ps1 with the following content:

    Start-Process Path to the file\FlexxAgent-Installer.exe

    Example: Start-Process C:\Temp\FlexxAgent-Installer\FlexxAgent-Installer.exe

Note: Ensure that, besides the executable, the line includes the necessary parameters for the installation, such as the proxy if needed.

  1. Save the file for later use.
  2. Run the Group Policy Management Console on a domain controller that has the Remote Server Administration Tools installed.
  3. Create a new Group Policy Object within the Group Policy container.

0depgpo

  1. Give a name to the new policy. Choose one that is meaningful.
  2. Right-click on the group policy and select Edit.
  3. Expand the tree Computer Configuration -> Windows Settings and select Scripts (Startup/Shutdown)

1depgpo

  1. A dialog will appear in a new window. In it, select PowerShell Scripts. Next, click on the Show Files… button

2depgpo

  1. The network folder where the scripts for the group policy are stored will open. 3depgpo

  2. Copy the file Install.ps1 created at the beginning and paste it into the network storage folder for the group policy scripts.

4depgpo

  1. Now you can close the Windows Explorer that provided access to the folder with the Group Policy scripts.
  2. The startup script properties modal window will reappear. Click the Add… button.
  3. A file selection dialog will appear. Find the script to use by clicking the Browse… button.
  4. The previous path will open, where the file created at the beginning of the procedure will be located. Double-click it or select it and click the Open button.
  5. Once the file is selected, choose Ok to close the dialog. The file will appear in the configuration modal window.
  6. Select OK to close this window. You will return to the Group Policy editor. This window can be closed.
  7. Find the branch of the organization within the domain controller where the computers you want to install FlexxAgent on are located. Select the branch and right-click on it. Select Link an Existing GPO.

5depgpo

  1. A selection dialog will appear where you will select the policy previously created. Once selected, click OK.

Verification

To validate the installation of FlexxAgent on a domain machine, you must restart a machine in the domain so that the Group Policy takes effect. After the restart, access the application event log and you will see several events generated during the installation and first execution of FlexxAgent, including:

6depgpo

After a few minutes, you will see the new device registered in the Workspaces module and in the Workspaces view of the Portal.

7depgpo

The installation log can be viewed in detail in the file C:\Windows\Temp\FlexxAgentInstallation.log.

8depgpo