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
-
Create a PowerShell
script
calledInstall.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.
- Save the file for later use.
- Run the Group Policy Management Console on a domain controller that has the Remote Server Administration Tools installed.
- Create a new Group Policy Object within the Group Policy container.
- Give a name to the new policy. Choose one that is meaningful.
- Right-click on the group policy and select
Edit
. - Expand the tree
Computer Configuration
->Windows Settings
and selectScripts (Startup/Shutdown)
- A dialog will appear in a new window. In it, select
PowerShell Scripts
. Next, click on theShow Files…
button
-
The network folder where the scripts for the group policy are stored will open.
-
Copy the file
Install.ps1
created at the beginning and paste it into the network storage folder for the group policy scripts.
- Now you can close the Windows Explorer that provided access to the folder with the Group Policy scripts.
- The startup script properties modal window will reappear. Click the
Add…
button. - A file selection dialog will appear. Find the script to use by clicking the
Browse…
button. - 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. - Once the file is selected, choose
Ok
to close the dialog. The file will appear in the configuration modal window. - Select
OK
to close this window. You will return to the Group Policy editor. This window can be closed. - 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
.
- 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:
After a few minutes, you will see the new device registered in the Workspaces module and in the Workspaces
view of the Portal.
The installation log can be viewed in detail in the file C:\Windows\Temp\FlexxAgentInstallation.log
.