Skip to main content
Version: 25.4

Deploy FlexxAgent via group policy (GPO)

FlexxAgent can be deployed on Windows using group policies (GPO). You need access to the agent installation package, which can be downloaded from the Flexxible portal.

Deploying

  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: Make sure that, apart from the executable, the line includes the necessary installation parameters, such as the proxy, if needed.

  1. Save the file for later use.
  2. Run the group policy management console in a domain controller that has remote computer management tools installed.
  3. Create a new group policy within the group policy container.

0depgpo

  1. Give the new policy a name. 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. Select PowerShell Scripts in it. 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 that was created at the beginning and paste it into the network folder for storing Group Policy scripts.

4depgpo

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

5depgpo

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

Verification

To validate the installation of FlexxAgent within a domain machine, a device in the domain should be restarted 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 initial run 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 seen in detail in the file C:\Windows\Temp\FlexxAgentInstallation.log.

8depgpo