Jump to content
Welcome to our new Citrix community!
  • How to Migrate GPOs from Microsoft to Citrix WEM


    raydavis22rnd.jpg by Ray Davis, CTA & Jacksonville CUGC Leader

    In this quick post, I will go over how to successfully migrate native group policy objects (GPOs) and inject them into Citrix Workspace Environment Manager (WEM). Many organizations rely heavily on GPO in their current Citrix VDA space. Some often wonder how to put them all in WEM or if it’s a good idea or not. I say it depends on the use case.

    WEM, hands down, will take the login experience and dramatically reduce the login times by simply moving the GPP aspects into WEM. On the computer side of the GPO, I am not 100% sure if the juice is worth the squeeze. Computer GPO applies at machine startup, and it is speedy. But a good use case is where the Citrix Admin doesn’t have rights to GPO to manage them. This will enable them to control these aspects from a Citrix Administrative side by using WEM to apply all GPO from this product.

    I was working with a client to migrate all the current GPOs they had applied the native way. Then, migrate them to WEM. When I speak of the word migrate, I am referring to backing up the GPOs, importing/migrating them into Citrix WEM, and applying them to a subset of VDAs for testing. This ensures that the current production setup is not impacted if something does not apply correctly in the use case here.

    If you need more information, I encourage you to read James Kindon's “Migrating GPO settings to WEM” blog. Migrating GPO settings to WEM | James Kindon (jkindon.com). In this blog, he goes over more examples for different use cases.

    (See also WEM Advanced Guidance - 2023, recently updated by James Kindon.)

    Let's get started migrating GPOs to Citrix WEM:

    1. The first thing is to back up a GPO and store it in a location you can import into WEM.
    2. The example below shows me backing up my AV exclusions.
    1. The GPO must be a ZIP format for WEM to process it.
    1. In these examples, I am using the WEM service. But the process is the same for those who have Citrix WEM on-premises.
    2. Go to DaaS and use either the Web WEM console or Legacy WEM console.
      1. WEB
    3. Select your desired configuration set.
    1. Click on “Group Policy Settings”
    1. Click Import
    1. Browse to the backup of where you store the GPO after it was backed up.
    1. Import the Zip file
    1. Below shows the import of the GPO from Microsoft GPO into WEM.
    1. If you are using the Legacy WEM console, here are some screenshots of the same process.
    1. I already have this GPO; I will select and overwrite in this case. This example shows you how to do it via the legacy console. Then click Start Import,
    1. To see the settings, edit the imported file.
      1. Legacy Console
    1.  It takes the GPO and imports all the Registry settings that contain what the GPO is made up of, such as all the registry settings.
    1. To see the settings, edit the imported file.
      1. WEB Console
    1. Assigning the action.
      1. WEB Console
    1. In this example, I chose everyone, which applies to users and computers. In most production cases, you can do groups or conditions.
    2. **NOTE**

      “You can assign the GPO to different AD groups, just like you assign other actions. If you assign GPOs to an individual user directly, the settings do not take effect. A group can contain users and machines. Machine-level settings take effect if the related machine belongs to the group. User-level settings take effect if the current user belongs to the group.”

    1. Reference for the Legacy Console, for comparison in showing if you do it via the Web console. It will show like this in the Legacy console.
    2. The Priority is how it is applied.
      1. https://docs.citrix.com/en-us/workspace-environment-management/current-release/user-interface-description/actions/group-policy-settings.html#contextualize-group-policy-settings
      1. “Type an integer to specify a priority. The greater the value, the higher the priority. Settings with higher priority are processed later.”
    1. Assigned the action.
      1. Legacy Console
    2. In this example, I chose everyone, which applies to users and computers. In most production cases, you can do groups or conditions.



      “You can assign the GPO to different AD groups, just like you assign other actions. If you assign GPOs to an individual user directly, the settings do not take effect. A group can contain users and machines. Machine-level settings take effect if the related machine belongs to the group. User-level settings take effect if the current user belongs to the group.”

    1. Reference for the WEB Console, for comparison in showing if you do it via the legacy console. It will show like this in the WEB console.
    1. Let’s reboot a VDA and see the results.
    2. I logged in before, as I have this applied already, But I updated it with the new WEM AV exclusion they released in May 2023. The registry will update the list to reflect what I am missing.
    1. Last cache sync
    1. Rebooting now.
    1. GPO were successfully updated.
    1. Before the antimalware was around 47%-50% of CPU.
    1. Event Logs
    2. I can see the GPO proceed, but I am unsure how to show what GPO applied from logs yet. This could be me not knowing where it logs it yet. Perhaps it does, and I am missing it. So, the only thing I can see is that the computer GPO components are processed. (More to this on line 34).
    1. After researching this, I had Sharp Gou reach out and explain to me where these logs are located.


      View log files | Workspace Environment Management 2303 (citrix.com)

    1. Citrix WEM Agent Host Service Debug.log. The log that lets you troubleshoot issues with the Citrix WEM Agent Host Service. By default, this log file is located in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent. To enable logging, be sure to enable Debug Mode for the relevant configuration set on the Administration Console > Advanced Settings > Configuration > Service Options tab. You now will see the GPO processing in that log file. Thank you, Sharp Gou. In this log, you will see the GPO applied and processed.
    1. We can verify in the Windows Defender section (windows) as well for the GPOs.
    1. What happens if I need to remove it? What happens if now?
    2. Go back to the area and unassing it.
    1. Reference for the Legacy Console, for comparison in showing if you do it via the Web console. It will show like this in the Legacy console:
    1. Reboot the VDA again. According to Citrix, if you restart the WEM Agent Host, it will take effect immediately. (Machine Level GPO)
    1. User level
    1. Before:
    1. After: it's empty now:
    Registry editorimage-115.png.80e19e6a749772766f5093e66dcfc12a.png
    1. I will reboot anyway, to show you how vital AV exclusion is needed.
    2. CPU % with Antimalware process.
    1. Processing is slower as well.
    1. Add the GPO back in WEM
    2. The WEM agent processed exceptionally quickly in my testing.
    3. Other questions I get at times: what is the purpose of Migrating vs. Importing?


      a. The Migrate button in the legacy console below allows you to convert user GPPs into a readable XML file that WEM can use in user actions, where Import takes the whole GPO and imports it in. From what I found where you have GPP policies, the migrate option does the trick.  In cases where you have the standard GPO settings, the Import will bring over the settings that make up the ADMX.

    config screen
    1. Example: I have a GPP applying some mapped drive with Item-level targeting on myself.
    2. Loopback is set to replace being I am applying a user policy to the Citrix VDA.
    drive maps

    d. Added more to show you the value of a quick summary of how GPP/loopback can potentially slow logins down. This is not a lousy login, but it’s just a tiny example.

    drive mapsDevices and drives

    e. By adding a couple of drives, it added 1.4-1.6 seconds. Sure, that is not bad. But that is 1.4-1.6 seconds more than I did not have before—another reason why WEM is the go-to here, IMHO.

    WEM code
    1. I will back up the GPO as I did above.
    1. I will unlink the Mapped Drive GPO before importing it for testing.
    2. Now, I will migrate the GPP to an XML format for WEM to understand.
    image-125.png.3ce8bbbd01dfc75211389345ec78b4cc.pngconfiguration screenimage-127.png.15d4847d750c02a5406720128e368989.png
    1. I kept getting the error, and I did not understand why. After messing around for a bit, I discovered that when I create a customer folder for the GUID and zip it. It was not too fond of that.
    2. So, When I backed up the GPO, I only kept the GUID name instead.
    image-128.png.c5a521e709bb56aeafcaf8446037164f.pngfile directoryimage-130.png.4834586949d31f2d045b511467052362.pngimage-131.png.2f532cd5b1e2fdfaa29a970291cbd055.pngimage-132.png.fea15cb20d951296eb5c27fbec09e2c9.png
    1. Now click on Restore.
    config setimage-134.png.2205eafa317cfa69a5097cc97d8dc738.pngimage-135.png.273cf966cce10377be4235d6fcb20a0a.png
    1. You will see the File you named when you converted it from the GPO backup. Also, you will see the Network drive icon light up, ready for it to be selected.

    Now, you will see the Network drive in the actions for the user side.

    user side network
    1. Assign it to the user of your choice. Everyone in my example.
    file directoryimage-142.png.78f120855cb97d2ecae5712a15effdf3.pngimage-143.png.b3a5c8f48d5884597c520b27e723eff9.png
    1. I needed to go into the “Advanced settings > Main Configuration > Check= Process Virtual Drives.”
    config set
    1. I am going to reboot the VDA now. Remember, GPO was unlinked, GPO was backed up, Converted to the WEM XML format, Then WEM XML format, we restored with the Actions, and lastly, it was assigned to a user. (Everyone in this case.)
    file directory
    1. To verify WEM is doing it.
    wem verify
    1. Another way is to put in a description of the actions.
    1. You can let WEM update on its own or refresh the cache.
    2. As you can see below, the Drives that I had in the native GPMC is now applying via WEM.
    filed directory

    I hope you found this helpful in your journey if you are considering this technology. Citrix WEM is an excellent product and keeps improving as time goes on. Thank you, Citrix, for the great tool 😊

    Another option, before WEM could do this, was to use a tool made by Arjan Mensch. It allowed you to convert the GPPs via PowerShell. I still use this today, and it’s another excellent tool to save as an ace in your back pocket. Powershell Module for Citrix WEM – Part 1 – Application actions | msfreaks (wordpress.com)


    Group Policy Settings | Workspace Environment Management 2308 (citrix.com)

    Workspace Environment Management service (citrix.com)


    Agent system Settings around GPO

    Agent | Workspace Environment Management 2308 (citrix.com)
















    User Feedback

    Recommended Comments

    There are no comments to display.

    Create an account or sign in to comment

    You need to be a member in order to leave a comment

    Create an account

    Sign up for a new account in our community. It's easy!

    Register a new account

    Sign in

    Already have an account? Sign in here.

    Sign In Now

  • Create New...