Skip to content

How to Configure User Profile Disks for an RDS Collection Print

  • 0

User Profile Disks keep an RDS user’s profile in a VHDX file on a shared storage location and attach it when that user signs in to a collection. The design can preserve settings across session hosts, but it also makes storage availability and permissions part of every successful sign-in.

Check whether User Profile Disks fit this collection

Confirm the supported profile approach for the installed Windows Server and application versions before changing a production collection. User Profile Disks are scoped to a collection; they are not a universal replacement for every roaming-profile or profile-container design. Review whether another supported profile solution better matches your environment.

Use a pilot collection or a small test group first. Inventory existing local profiles and application data, then define how they will be migrated and how you will return to the original profile arrangement. Enabling the feature does not perform a complete migration of existing user data.

Prepare protected shared storage

Create a dedicated SMB share with sufficient capacity, reliable backups and the required permissions for the session-host computer accounts. Follow the profile-disk security design rather than granting broad access to everyone. Users should not be able to open or modify another user’s profile disk.

Record the path, collection, Connection Broker and session-host names. The example below uses a placeholder UNC path; it must point to your own approved storage. Test name resolution and SMB connectivity from every host in the collection. A successful test from the administrator’s workstation is insufficient.

Enable the profile-disk configuration

Perform the change when test users are signed out. From an RDS management host, confirm that you are targeting the intended Connection Broker and collection, then enable the setting with an approved maximum disk size. The size below is an example, not a recommendation for every workload.

Get-RDSessionCollection -ConnectionBroker 'broker.corp.example'
Set-RDSessionCollectionConfiguration -CollectionName 'Business Apps' -ConnectionBroker 'broker.corp.example' -EnableUserProfileDisk -DiskPath '\\files01\RDSProfiles' -MaxUserProfileDiskSizeGB 20

Verify a complete user session

Sign in as a pilot user, create a harmless test setting and sign out fully. Confirm that the VHDX is created in the expected location and that the setting remains after a subsequent sign-in. Test the other session hosts as well as the first one. Watch for temporary-profile messages and profile-related events, and verify that sign-out releases the disk normally.

Inspect the collection settings with the RDS management tools and monitor share capacity, file-server health and sign-in latency. An oversized maximum does not reserve storage for every user; a small configured limit can still interrupt users when a profile fills.

Troubleshoot storage and profile locks

If sign-in uses a temporary profile, check permissions for the session-host account, available space and access to the UNC path. Check for an existing user session or an attached VHDX before treating the file as abandoned. Do not delete a disk or force-detach it while a session might still be using it.

Back up profiles through a supported process and test recovery on an isolated copy. Profile storage is user data; a VM snapshot or a successful file-copy job alone does not prove that every profile can be restored consistently.

Rollback

Sign users out and preserve the profile disks before disabling the feature for the collection. Restore the previous profile configuration and migrate required user data deliberately. Keep the old disks until users have validated the replacement profiles and the retention period has been agreed.

The Microsoft RDS collection configuration reference describes the EnableUserProfileDisk, DiskPath and maximum-size parameters. Choose the documentation version appropriate to the RDS management module you use.


Was this answer helpful?

« Back