Statistics Retention Days

If the WorkSpace Performance Monitor Agent has been deployed to the WorkSpaces, it will be reporting back to the server key metric statistics periodically as defined in the Group Policy (see section in the ‘WorkSpaces Manager Installation Guide’ on ‘Installing the WorkSpaces Performance Monitor Agent’). In a large estate, this will create millions of rows within the database over a period. The number of days that are retained within the database can be specified here. If the number of days is too high on a large estate (e.g., 60) then it will have an impact on queries of statistics and increased disk space usage. For smaller estates, you can set this to 30 days and monitor from there.

WorkSpace Service Update Frequency (mins)

This will automatically update the local database with up-to-date information on this period. 15 minutes is sufficient for most cases, but you would not want to do this on, for example, a 1-minute period on a very large WorkSpaces and user estate. If you need to do a manual update for any reason, you can do this in the Update section of the portal.

Portal URL

Enter your portal URL here. e.g.

Multiple Account

This enables management of WorkSpaces across multiple AWS accounts. Please refer to Multi-Account section of this document for configuration instructions

Multiple Domains

If you are using a multi-domain forest, you can add multiple domains that host your user accounts. Therefore, their WorkSpaces can be managed, searched, and reported on.

Password Expiry Emails

If this is chosen, users will receive a notification email two weeks prior to their password expiring. This can be turned on\off whenever and is not required to complete the Portal configuration at this stage.

User Change Password

Enables the portal to give the user the option to change its password in AD.

User Restore

Enables the Self-Service function for a user to restore their WorkSpace to a last known healthy state. Automatic snapshots for use when restoring a WorkSpace are scheduled every 12 hours. If the WorkSpace is healthy, snapshots of both the root volume and user volume are created around the same time. If the WorkSpace is unhealthy, these snapshots are not created.

If needed, a user can restore a WorkSpace to its last known healthy state. This recreates both the root volume and user volume, based on the most recent snapshots of these volumes that were created when the WorkSpace was healthy.

User Rebuild

Enables the Self-Service function for a user to rebuild their WorkSpace and notifies user by email of the action.
The system is refreshed with the most recent image of the bundle that the WorkSpace was created from. Any applications that were installed, or system settings that were changed after the WorkSpace was created, are lost.

The user volume (for Microsoft Windows, the D drive; for Linux, /home) is recreated from the most recent snapshot. The current contents of the user volume are overwritten.
Automatic snapshots for use when rebuilding a WorkSpace are scheduled every 12 hours. If the WorkSpace is healthy, a snapshot of the user volume is created. If the WorkSpace is unhealthy, the snapshot is not created. The primary elastic network interface is recreated. The WorkSpace receives a new private IP address.

Disable Scheduler

This quickly disables ALL automation of the WSM Appliance.

Activity Reporting

This enabled\disables the sending of a daily report on user login, logoff, idle times and when activity was resumed. The report is sent at 3am each morning. An example report is shown below:

Email For Report

The email of the person\group that receives the Activity report.

Auto Delete

You can set up WSM to automatically delete unused workspaces after a defined period of days.

Auto Delete Days

This value is the number of days a WorkSpace should be considered for deletion (e.g., 45 or 60 days).

Safety Days Before Termination

This value is the number of days a user will be given to inform their Service Desk or IT Function that they still require the WorkSpace before deletion.
For example, if Auto-delete was set for 60 days. On the 60th day of the WorkSpace being unused, the user that is associated with the WorkSpace will receive an email informing them that their WorkSpace is to be deleted in (Safety days VALUE) with the request for them to contact support remove the Autodeletion request. After the safety days value and if autodeletion is not removed.

Auto Provision

Turns on Auto-Provisioning of WorkSpaces via Active Directory groups. For more information on this click here.
If Auto-Provision is enabled, the service will poll the Active Directory groups every 15 minutes for new members.
Removing a user from the AD group will not terminate the WorkSpace. This functionality can be obtained in conjunction with Auto-Delete.

Auto Provision Frequency

Allows the choice of auto-provisioning period. This checks the AD groups in your Auto- Provisioning profiles at specific time periods. If it finds a user in an AD group that does not have a WorkSpace, it auto-provisions one for them based on the Auto-Provisioning settings that you have specified. The field allows 0-59 minutes, but anything more than 60 becomes an hourly check.

Unhealthy Reboot

If this option is enabled the service will check for any WorkSpaces with a status of “Unhealthy” every 10 minutes. Any WorkSpaces found in this state will have their status re-evaluated and if still found to be “Unhealthy” they will be rebooted. If after a reboot the status remains at “Unhealthy” the WorkSpace running mode will be set to “Auto-Stop” (if not already) and the WorkSpace Stopped. Once Stopped the WorkSpace will be Started again and its original running mode restored. This action can initiate a migration from the underlying physical host.
If the WorkSpace remains in an “Unhealthy” state an error is recorded on the admin dashboard.

Fixed Tag Values

Enables the Fixed Tags function in ‘Options’

Use Global AutoStop Time

Sets a global time for auto-stop all the WorkSpaces in this mode.

Auto Stop Timeout

Sets the number of hours before an idle WorkSpaces is stopped.

Alternate Email Tag

Enables the Alternate Email Tags function in ‘Options’.

Integrates with WSUS

Enables the integration with the Microsoft Patching services called Windows Servicew Update Server (WSUS).


WSUS uses port 8530 by default, but it can be changed on IIS. It is not recommended.


If WSUS is configured to use HTTPS, then this option needs to be set. Also, port changes to 8531.

Use System Proxy

If WSM needs to use a proxy, this feature must be enabled.

Proxy Address

When the proxy is enabled, an address in HTTPS://address:port format is required.


Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Post Comment