Configuring Amazon WorkSpaces Registration Code Automatically

Here at Idea 11 we work with our customers to deploy Amazon WorkSpaces. A lot of WorkSpaces.

In an enterprise, one annoying aspect of the client is the Registration Code. This code is used to tell the WorkSpace client where to connect.

Now obviously just telling the end users to enter this code isn’t the most seamless user experience we could want and usually results in a few helpdesk calls.

So this is how you can configure this code automatically for your end users.


Stored in the user profile (%userprofile%\appdata\Local\Amazon Web Services\Amazon WorkSpaces\registrationCache.json on Windows 10) is registrationCache.json

This file contains the settings for the registrationCode.

The easiest way to get this file configured with what you need is to configure the registration code in your client and take a copy of the file.


Now there’s lots of ways you can deploy out this file (login scripts, SCCM, Group Policy, etc) but i’m going to cover how I do it with Group Policy.

Please modify these steps as you need for your use case, and ALWAYS test before you deploy into production with change management approval.

  1. Put the file somewhere that is read only accessible on the network by everybody (I’m going to use sysvol)
  2. Create a Group Policy Object (or add the below settings to an existing policy)
  3. Under User Configuration > Preferences > Windows Settings > Files > (Right Click) New > File
  4.  Now lets configure some settings:
    1. Under the General Tab
      1. Action: Replace (This is up to you but in our deployments we want to be able to change this file when required)
      2. Source File: Where you are storing your registrationCache.json
      3. Destination File: %userprofile%\appdata\Local\Amazon Web Services\Amazon WorkSpaces\registrationCache.json (This is tested on Windows 10, you may need to find the correct location for your file)
    2. User the Common Tab
      1. Enable : Run in logged-on user’s security context
      2. (Optional) Enable: Remove this item when it is no longer applied
  5. Link this Group Policy Object into your OU structure where required.
  6. Tell your helpdesk what you’ve deployed and relax.

Need some help with Amazon Web Services? Idea 11 is an Advanced Consulting Partner with AWS helping customers with their journey to and inside the cloud. Get in contact with us here.