VDI Configuration: registry value VdiCollectionName (Configuration)UserHKCU\Software\Policies\Microsoft\UEV\Agent\Configuration

Policy ID: ConfigureVdi
Scope: Computer Configuration, User Configuration
Supported on: At least Windows Server 2008 R2 or Windows 7
Source: Administrative Templates (.admx) for Windows 11 2026 Update (26H2) (version 1.0)
Category: Windows Components › Microsoft User Experience Virtualization

This policy setting configures the synchronization of User Experience Virtualization (UE-V) rollback information for computers running in a non-persistent, pooled VDI environment. UE-V settings rollback data and checkpoints are normally stored only on the local computer. With this policy setting enabled, the rollback information is copied to the settings storage location when the user logs off or shuts down their VDI session. Enable this setting to register a VDI-specific settings location template and restore data on computers in pooled VDI environments that reset to a clean state on logout. With this policy enabled you can roll settings back to the state when UE-V was installed or to “last-known-good” configurations. Only enable this policy setting on computers running in a non-persistent VDI environment. The VDI Collection Name defines the name of the virtual desktop collection containing the virtual computers.
If you enable this policy setting, the UE-V rollback state is copied to the settings storage location on logout and restored on login.
If you disable this policy setting, no UE-V rollback state is copied to the settings storage location.
If you do not configure this policy, no UE-V rollback state is copied to the settings storage location.

See the full description on the Group Policy page ›

Registry

VdiState

REG_DWORDComputerUser

…\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettingsHKLM\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings
HKCU\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings

Enabled value: 1
Disabled value: 0

Apply with .reg · CMD · PowerShell

ComputerMachine-wide setting

.reg

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings]

; Options (use only one)
; Enabled
"VdiState"=dword:00000001
; Disabled
"VdiState"=dword:00000000

CMD

:: Options (use only one)

:: Enabled
reg add "HKLM\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings" /v "VdiState" /t REG_DWORD /d 1 /f
:: Disabled
reg add "HKLM\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings" /v "VdiState" /t REG_DWORD /d 0 /f

PowerShell

# Common: create the key
New-Item -Path 'HKLM:\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings' -Force | Out-Null

# Options (use only one)
# Enabled
New-ItemProperty -Path 'HKLM:\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings' -Name 'VdiState' -PropertyType DWord -Value 1 -Force | Out-Null
# Disabled
New-ItemProperty -Path 'HKLM:\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings' -Name 'VdiState' -PropertyType DWord -Value 0 -Force | Out-Null

UserPer-account setting

.reg

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings]

; Options (use only one)
; Enabled
"VdiState"=dword:00000001
; Disabled
"VdiState"=dword:00000000

CMD

:: Options (use only one)

:: Enabled
reg add "HKCU\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings" /v "VdiState" /t REG_DWORD /d 1 /f
:: Disabled
reg add "HKCU\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings" /v "VdiState" /t REG_DWORD /d 0 /f

PowerShell

# Common: create the key
New-Item -Path 'HKCU:\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings' -Force | Out-Null

# Options (use only one)
# Enabled
New-ItemProperty -Path 'HKCU:\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings' -Name 'VdiState' -PropertyType DWord -Value 1 -Force | Out-Null
# Disabled
New-ItemProperty -Path 'HKCU:\Software\Policies\Microsoft\UEV\Agent\Configuration\WindowsSettings' -Name 'VdiState' -PropertyType DWord -Value 0 -Force | Out-Null

VdiCollectionName

REG_EXPAND_SZUserComputer

…\Software\Policies\Microsoft\UEV\Agent\ConfigurationHKCU\Software\Policies\Microsoft\UEV\Agent\Configuration Current key
HKLM\Software\Policies\Microsoft\UEV\Agent\Configuration

Enabled value: Depends on the option value
Element: VDI Collection Name:
Value type: REG_EXPAND_SZ
Required: true
Expandable string (REG_EXPAND_SZ): true

Apply with .reg · CMD · PowerShell

UserPer-account setting

.reg

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Policies\Microsoft\UEV\Agent\Configuration]

; Value names and types follow the ADMX. Replace <enter value> below with your own data
; hex(2) and hex(7) data must be written as hexadecimal (UTF-16LE)
"VdiCollectionName"=hex(2):<enter value>

CMD

:: Value names and types follow the ADMX. Replace <enter value> below with your own data

reg add "HKCU\Software\Policies\Microsoft\UEV\Agent\Configuration" /v "VdiCollectionName" /t REG_EXPAND_SZ /d "<enter value>" /f

PowerShell

# Value names and types follow the ADMX. Replace <enter value> below with your own data

New-Item -Path 'HKCU:\Software\Policies\Microsoft\UEV\Agent\Configuration' -Force | Out-Null
New-ItemProperty -Path 'HKCU:\Software\Policies\Microsoft\UEV\Agent\Configuration' -Name 'VdiCollectionName' -PropertyType ExpandString -Value '<enter value>' -Force | Out-Null

ComputerMachine-wide setting

.reg

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\UEV\Agent\Configuration]

; Value names and types follow the ADMX. Replace <enter value> below with your own data
; hex(2) and hex(7) data must be written as hexadecimal (UTF-16LE)
"VdiCollectionName"=hex(2):<enter value>

CMD

:: Value names and types follow the ADMX. Replace <enter value> below with your own data

reg add "HKLM\Software\Policies\Microsoft\UEV\Agent\Configuration" /v "VdiCollectionName" /t REG_EXPAND_SZ /d "<enter value>" /f

PowerShell

# Value names and types follow the ADMX. Replace <enter value> below with your own data

New-Item -Path 'HKLM:\Software\Policies\Microsoft\UEV\Agent\Configuration' -Force | Out-Null
New-ItemProperty -Path 'HKLM:\Software\Policies\Microsoft\UEV\Agent\Configuration' -Name 'VdiCollectionName' -PropertyType ExpandString -Value '<enter value>' -Force | Out-Null