Export (0) Print
Expand All
1 out of 2 rated this helpful - Rate this topic

Deploying the UE-V Agent

Updated: November 1, 2012

Applies To: User Experience Virtualization 1.0

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.

SettingsStoragePath

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)

SettingsTemplateCatalogPath

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

RegisterMSTemplates

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

True | False

Default : True

SyncMethod

Specifies which synchronization method should be used.

OfflineFiles | None

Default : OfflineFiles

SyncTimeoutInMilliseconds

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)

SyncEnabled

Specifies whether UE-V synchronization is enabled or disabled.

True | False

Default : True

MaxPackageSizeInBytes

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

<size>

Default : none (no warning threshold)

CEIPEnabled

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

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.

noteNote
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 /l*v "%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 /l*v "%temp%\UE-VAgentInstaller.log" SettingsStoragePath="\\server\settingsshare\%%username%%"

PowerShell

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 /l*v "%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 /l*v "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\\server\settingsshare\^%username^%

noteNote
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.

See Also

-----
You can learn more about MDOP in the TechNet Library, search for troubleshooting on the TechNet Wiki, or follow us on Facebook or Twitter.
-----
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.