通过

部署 UE-V Agent

  • 项目

应用到: User Experience Virtualization 1.0

Microsoft User Experience Virtualization (UE-V) Agent 必须在使用 UE-V 漫游应用程序和 Windows 设置的每台计算机上运行。 单个安装程序文件 AgentSetup.exe 会在 32 位和 64 位操作系统上安装 UE-V Agent。 UE-V Agent 的命令行参数如下所示：

AgentSetup.exe 命令行参数

命令行参数 定义 注意

/help、/h 或 /？

显示 AgentSetup.exe 使用方法对话框。

SettingsStoragePath

指明定义设置存储位置的通用命名约定 (UNC) 路径。

接受 %username% 或 %computername% 环境变量。 脚本可能需要转义的变量。

默认值： <无>（Active Directory 用户主页）

SettingsTemplateCatalogPath

指明通用命名约定 (UNC) 路径，以定义在其中检查新设置位置模板的位置。

仅自定义设置位置模板需要

RegisterMSTemplates

指定是否应该在安装过程中注册默认的 Microsoft 模板。

真 | 假

默认值： 真

SyncMethod

指定应该使用的同步方法。

OfflineFiles | 无

默认值： OfflineFiles

SyncTimeoutInMilliseconds

指定从设置存储位置检索用户设置时计算机在超时之前等待的毫秒数。

默认值： 2000 毫秒

（最多等待 2 秒）

SyncEnabled

指定是启用还是禁用 UE-V 同步。

真 | 假

默认值： 真

MaxPackageSizeInBytes

指定在 UE-V Agent 报告文件超出阈值时的设置包文件大小字节数。

<大小>

默认值： 无（无警告阈值）

CEIPEnabled

指定用于参加客户体验改善计划的设置。 如果设置为“真”，则会将安装程序信息上载到 Microsoft 客户体验改善计划站点。 如果设置为“假”，则不会上载任何信息。

真 | 假

默认值： 假

在安装过程中，SettingsStoragePath 命令行参数为设置值指定设置存储位置。 可以在部署 UE-V Agent 之前定义设置存储位置。 如果未定义设置存储位置，则 UE-V 将 Active Directory 用户主目录用作设置存储位置。 如果你在安装过程中指定 SettingsStoragePath 配置并且将 %username% 用作值的一部分，这将会在用户登录到的所有计算机或会话上漫游相同的用户设置体验。 如果你指定 %username%\%computername% 变量作为 SettingsStoragePath 值的一部分，这将会保留每台计算机的设置体验。

已为包含合并的 32 位和 64 位安装程序在内的 UE-V Agent 安装提供了特定于体系结构的 Windows Installer (.msi) 文件。 AgentSetupx86.msi 或 AgentSetupx64.msi 安装文件小于 AgentSetup.exe 文件并且可能会简化代理部署。 Windows Installer (.msi) 安装支持 AgentSetup.exe 安装程序的命令行参数。

备注

在安装或卸载 UE-V Agent 的过程中，你可以使用 AgentSetup.exe 文件或 AgentSetup<arch>.msi 文件，但不能两者都使用。 必须使用同一文件卸载 UE-V Agent，因为安装 UE-V Agent 使用的是此文件。

请确保在安装 UE-V Agent 时使用正确的变量格式。 下表为使用 AgentSetup.exe 或 Windows Installer (.msi) 安装文件提供了部署选项的示例。

部署类型 部署说明 示例

命令提示符

如果通过命令提示符安装 UE-V Agent，请使用 %^username% 变量格式。 如果由于设置存储路径中的空格的缘故而需要引号，请使用批脚本文件进行部署。

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%

批脚本

利用批脚本文件安装 UE-V Agent 时，请使用 %%username%% 变量格式。 如果你使用此安装方法，则必须使用 %% 字符对变量进行转义。 如果没有此字符，则脚本会在安装时而不是在运行时展开用户名变量，并使 UE-V 将单一设置存储位置用于所有用户。

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

利用 PowerShell 提示符或 PowerShell 脚本安装 UE-V Agent 时，请使用 %username% 变量格式。

& 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%

电子软件分发，比如 Configuration Manager 软件部署

使用 Configuration Manager 安装 UE-V Agent 时，请使用 ^%username^% 变量格式。

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^%

备注

安装 U-EV Agent 需要管理员权限，并且需要先重启计算机，然后才能运行 UE-V Agent。

网络共享中的 UE-V Agent 部署方法

可以使用以下方法来部署 UE-V Agent：

  • 一个可以安装 Windows Installer (.msi) 文件的电子软件分发 (ESD) 解决方案。

  • 一个引用集中存储在共享上的 Windows Installer (.msi) 文件的安装脚本。

  • 在计算机上手动运行安装程序。

要从网络共享部署 UE-V Agent，请使用以下步骤：

从网络共享安装和配置 UE-V Agent

  1. 将 UE-V Agent 安装文件 (AgentSetup.exe) 安排在用户具有“读取”权限的网络共享上。

  2. 将脚本部署到安装 UE-V Agent 的用户计算机。 该脚本应该指定设置存储位置。

更新 UE-V Agent

UE-V Agent 软件的更新将通过 Microsoft 更新来提供。 在 UE-V Agent 升级过程中，可能会更新用于通用 Microsoft 应用程序和 Windows 设置的设置位置模板默认组。可以使用企业软件分发 (ESD) 基础结构部署 UE-V Agent 更新。

另请参阅

任务

部署 UE-V 1.0 的设置存储位置
安装 UE-V Generator
部署 UE-V Agent

概念

UE-V 1.0 的支持配置

其他资源

部署 UE-V 1.0

-----
你可以在 TechNet 库中了解有关 MDOP 的详细信息、在 TechNet Wiki 上搜索疑难解答，或者在 Facebook 或 Twitter 上了解我们的最新信息。
-----