Deploying the UE-V Agent

The Microsoft User Experience Virtualization (UE-V) agent must run on each computer that uses UE-V to roam application and Windows settings. A single installer file, AgentSetup.exe, installs the UE-V agent on both 32-bit and 64-bit operating systems. The command-line parameters of the UE-V Agent are the following:

AgentSetup.exe command-line parameters

Command-line parameter Definition Notes

/help or /h or /?

Displays the AgentSetup.exe usage dialog.


Indicates the Universal Naming Convention (UNC) path that defines where settings are stored.

%username% or %computername% environment variables are accepted. Scripting may require escaped variables.

Default: <none> (Active Directory user home)


Indicates the Universal Naming Convention (UNC) path that defines the location that was checked for new settings location templates.

Only required for custom settings location templates


Specifies whether the default Microsoft templates should be registered during installation.

True | False

Default: True


Specifies which synchronization method should be used.

OfflineFiles | None

Default: OfflineFiles


Specifies the number of milliseconds that the computer waits before timeout when it retrieves user settings from the settings storage location.

Default: 2000 milliseconds

(wait up to 2 seconds)


Specifies whether UE-V synchronization is enabled or disabled.

True | False

Default: True


Specifies a settings package file size in bytes when the UE-V agent reports that files exceed the threshold.


Default: none (no warning threshold)


Specifies the setting for participation in the Customer Experience Improvement program. If set to true, then installer information is uploaded to the Microsoft Customer Experience Improvement Program site. If set to false, then no information is uploaded.

True | False

Default: False

On Windows 7: True

During installation, the SettingsStoragePath command-line parameter specifies the settings storage location for the settings values. A settings storage location can be defined before deploying the UE-V Agent. If no settings storage location is defined, then UE-V uses the Active Directory user Home Directory as the settings storage location. When you specify the SettingsStoragePath configuration during setup and use the %username% as part of the value, this will roam the same user settings experience on all computers or sessions that a user logs into. If you specify the %username%\%computername% variables as part of the SettingsStoragePath value, this will preserve the settings experience for each computer.

Architecture-specific Windows Installer (.msi) files are provided for the UE-V agent installation in addition to the combined 32-bit and 64-bit installer. The AgentSetupx86.msi or AgentSetupx64.msi install files are smaller than the AgentSetup.exe file and might streamline the agent deployments. The command-line parameters for the AgentSetup.exe installer are supported for the Windows Installer (.msi) installation.

Note   During UE-V agent installation or uninstallation you can either use the AgentSetup.exe file or the AgentSetup<arch>.msi file, but not both. The same file must be used to uninstall the UE-V Agent as it was used to install the UE-V Agent.

Be sure to use the correct variable format when you install the UE-V agent. The following table provides examples of deployment options for using the AgentSetup.exe or the Windows Installer (.msi) installation files.

Deployment type Deployment description Example

Command prompt

When you install the UE-V agent from a command prompt, use the %^username% variable format. If quotation marks are needed because of spaces in the settings storage path, use a batch script file for deployment.

AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%^username%

msiexec.exe /i "<path to msi file>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%^username%

Batch script

When you install the UE-V Agent from a batch script file, use the %%username%% variable format. If you use this install method, you must escape the variable with the %% characters. Without this character, the script expands the username variable at install time, rather than at run time, causing UE-V to use a single settings storage location for all users.

AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath="\server\settingsshare%%username%%"

msiexec.exe /i "<path to msi file>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath="\server\settingsshare%%username%%"


When you install the UE-V agent from a PowerShell prompt or PowerShell script, use the %username% variable format.

& AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%username%

& msiexec.exe /i "<path to msi file>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%username%

Electronic software distribution, such as deployment of Configuration Manager Software Deployment)

When you install the UE-V Agent with Configuration Manager, use the ^%username^% variable format.

AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare^%username^%

msiexec.exe /i "<path to msi file>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare^%username^%

Note   The installation of the U-EV Agent requires Administrator rights and the computer will require a restart before the UE-V agent can run.

UE-V Agent deployment methods from a network share

You can use the following methods to deploy the UE-V agent:

  • An electronic software distribution (ESD) solution that can install a Windows Installer (.msi) file.

  • An installation script that references the Windows Installer (.msi) file that is stored centrally on a share.

  • Manually running the installation program on the computer.

To deploy the UE-V agent from a network share, use the following steps:

To install and configure the UE-V Agent from a network share

  1. Stage the UE-V agent installation file (AgentSetup.exe) on a network share to which users have “read” permission.

  2. Deploy a script to user computers that installs the UE-V agent. The script should specify the settings storage location.

Update the UE-V Agent

Updates for the UE-V agent software will be provided through Microsoft Update. During a UE-V agent upgrade, the default group of settings location templates for common Microsoft applications and Windows settings may be updated. UE-V agent updates can be deployed by using Enterprise Software Distribution (ESD) infrastructure.

Deploying UE-V 1.0

Supported Configurations for UE-V 1.0

Deploying the Settings Storage Location for UE-V 1.0

Installing the UE-V Generator

Deploy the User Experience Virtualization Agent