UDI 参考
此参考提供了有关 UDI 的详细信息，并包括以下主题：
UDI 概念中所述 的 UDI 概念
OSDResults 参考中所述的 OSDResults
以用户为中心的应用安装程序，如以用户为中心的应用安装程序参考中所述
UDI 阶段参考中所述的 UDI 阶段
UDI 任务参考中所述的 UDI 任务
UDI 验证程序参考中所述的 UDI 验证程序
UDI 向导页 参考中所述的 UDI 向导页
后续部分将讨论其中每个参考主题。
UDI 概念
本节包含有助于描述 UDI、UDI 向导和 UDI 向导Designer的概念。
显示名称
显示名称用于为 UDI 向导Designer页库中的向导页提供用户友好的描述性名称。 页面库中每个向导页的显示名称以蓝色文本显示，并在 UDI 向导Designer的“流”选项卡上显示。
向页面库添加页面时，必须提供显示名称。 将向导页添加到页面库后，无法更改显示名称。
Flow
“流”选项卡在 UDI 向导Designer中显示 UDI 阶段中的向导页列表。 可以使用“ 流 ”选项卡执行以下任务：
通过将页面从页面库拖动到 UDI 阶段，将向导页从页面库添加到 UDI 阶段。
从 UDI 阶段中删除向导页。
更改 UDI 阶段中的向导页序列。
页面库
页面库包含当前在 UDI 向导Designer加载的所有页面。 加载 UDI 向导配置文件时，配置文件中定义的所有向导页都会显示给页面库。 页面库按页面类型按字母顺序显示向导页。 特定页面类型的每个实例都列在页面类型下。
例如，对于不同的阶段，可能需要两个不同的 WelcomePage 向导页。 两个 WelcomePage 向导页将在 UDI 向导Designer页面库中的 WelcomePage 向导页类型下列出。
此外，页库中的每个向导页实例都指示在阶段流中使用向导页的次数。 将鼠标悬停在页面库中的向导页上时，将显示向导页的缩略图以及包含该页面的阶段。
页面名称
页面名称用于唯一标识 UDI 向导Designer页库中的向导页。 页面名称是 UDI 阶段引用的名称，以便 UDI 向导知道在特定 UDI 阶段中显示的向导页。 向页面库添加页面时，必须提供页面名称。 将向导页添加到页面库后，无法更改页面名称。 在 UDI 向导Designer中，页面名称以较小的非粗体文本显示在页面库中每个向导页的底部。
预留媒体部署
预留媒体支持是 Configuration Manager 中的一项作系统部署功能，允许管理员在预配过程之前将预留可启动媒体和作系统映像复制并应用到硬盘。 此工作可以减少网络流量和预配过程所需的时间。 预留媒体可以部署为制造过程的一部分，也可以部署在未连接到Configuration Manager环境的企业过渡中心。
有关预留媒体部署的详细信息，请参阅以下资源：
阶段组
使用阶段组对 UDI 向导中的一个或多个阶段进行分组Designer。 UDI 阶段组与 MDT 部署方案松散相关，但两者之间没有一对一关联。
阶段
阶段是 MDT 部署方案使用的 UDI 向导配置文件中所有页面的子集。 使用 UDI 向导任务序列步骤启动 UDI 向导 时， /stage 参数指定要运行的阶段，后者又指定要使用的页面集。 通过在功能区上的“预览向导”组中选择“预览”，可以预览向导页在阶段中的显示方式。 可以在多个 MDT 部署方案中使用 UDI 阶段，即使 UDI 向导Designer中只定义了一次 UDI 阶段。 例如，可以在 MDT 新计算机和替换计算机部署方案中使用 NewComputer 阶段。
任务
UDI 任务 是在向导页上运行以执行特定功能的软件。 在某些情况下，这些任务用于验证目标计算机是否已准备好进行部署。 其他任务可用于执行部署步骤，例如复制配置或结果文件。
注意
如果任一任务以警告或错误完成状态完成，则会禁用运行任务向导页上的“ 下一步 ”按钮。
UDI 包括多个内置任务，可用于执行部署所需的大部分任务。 有关 UDI 内置任务的详细信息，请参阅 内置 UDI 任务。
Shell Execute 内置 UDI 任务允许运行可从命令行启动的任何软件 (脚本) ，例如 Visual Basic 或 Windows PowerShell 脚本。 此功能允许使用熟悉的脚本语言创建任务。 有关详细信息，请参阅 Shell 执行任务。
如果你的要求超出了脚本编写范围，则可以编写自定义 UDI 任务。 UDI 任务 是用 C++ 编写并实现 ITask 接口的 DLL。 将 DLL 注册到 UDI 向导Designer任务库，方法是创建 UDI 向导Designer配置 (.config) 文件，并将其放置在 installation_folder\Bin\Config 文件夹 (其中installation_folder是安装 MDT) 的文件夹。 有关开发自定义 UDI 任务的详细信息，请参阅 用户驱动安装开发人员指南中的“创建自定义 UDI 任务”部分。
UDI 任务序列
使用以下特定于 UDI 的 MDT 任务序列模板之一创建 UDI 任务序列，这些模板在任务序列中的相应步骤运行 UDI 向导：
User-Driven 安装任务序列。 此任务序列模板用于“新建计算机”、“刷新计算机”和“替换计算机 MDT”部署方案。
User-Driven 安装替换任务序列。 此任务序列模板是替换计算机部署方案中两步过程的第一步，用于捕获用户状态迁移数据。 两步流程中的第二步是 User-Driven 安装任务序列任务序列模板，用于部署目标应用程序和作系统，并还原该过程第一步期间保存的用户状态迁移数据。
有关 UDI 任务序列模板的详细信息，请参阅 MDT 文档中使用Microsoft部署工具包中的“标识 MDT 中的 UDI 任务序列模板”部分。 有关这些组件的详细信息，请参阅 MDT 文档中的“标识 UDI 部署过程组件”部分，该文档 使用 MDT 附带的 Microsoft Deployment Toolkit。
UDI 向导
UDI 向导提供用于收集 UDI 任务序列使用的部署设置的 UI。 UDI 向导作为 UDI 任务序列的一部分启动，并收集自定义 Windows 客户端作系统和应用程序部署所需的配置信息。 向导页从 UDI 向导配置文件读取其配置设置，该文件使用 UDI 向导Designer进行自定义。
UDI 向导由 使用 UDI 任务序列模板创建的任务序列中的 UDI 向导任务序列步骤启动。 UDI 向导任务序列步骤运行 UDIWizard.wsf 脚本，该脚本反过来又启动 UDI 向导 (OSDSetupWizard.exe) 。 表 9 列出了 UDI 向导命令行参数，并提供了每个参数的简要说明。
表 9. UDI 向导 Command-Line 参数
| 参数 | 说明 |
|---|---|
| /预览 | 允许通过启用“ 下一步 ”按钮预览向导的当前配置，这允许你在无需有效输入的情况下从一页移动到一页。 |
| /xml | 指定 UDI 向导配置文件的名称。 UDIWizard.wsf 脚本自动将此参数设置为 OSDSetupWizard.xml 文件，该文件存储在任务序列存储日志文件的文件夹中。 此参数默认为 config.xml 文件。 此参数的语法如下 (其中 <full_path> 是 .xml 文件的完全限定路径，包括文件名和扩展名) ：/xml:<full_path> |
| /阶段 | 指定要运行的 UDI 阶段的名称。 UDIWizard.wsf 脚本自动将此参数设置为适当的阶段，如 UDI 阶段参考中所述。 此参数默认为 UDI 向导配置文件中的第一个阶段。 此参数的语法如下 (其中 <stage_name> 为要) 运行的阶段的名称：/stage:<stage_name>注意： stage_name>的值<区分大小写。 |
| /现场 | 以区域设置标识符的形式指定 UDI 向导中使用的语言， (LCID) （用数值表示）。 有关可用 LCID 的列表，请参阅 由 Microsoft 分配的区域设置 ID。 你将使用此列表来标识要使用的语言，然后提供相应的 LCID。 此参数的语法如下 (其中 <locale_id> 是要在) 使用的 LCID 的数值：/locale:<locale_id> |
UDI 向导应用程序配置文件
ApplicationPage 向导页配置 UDI 向导应用程序配置文件，该文件维护要安装的软件列表。 此文件包含使用 UDI 向导Designer添加的每个Configuration Manager应用程序或程序和包的条目。
此文件与 UDI 向导配置文件同名，但扩展名.app。 例如，如果 UDI 向导配置文件名为 Config.xml， 则相应的 UDI 向导应用程序配置文件将为 Config.xml.app。 此文件是 UDI 向导配置文件的配套文件。
UDI 向导配置文件
UDI 向导读取 UDI 向导配置文件，以确定要显示的向导页、向导页的顺序、向导页上控件的任何默认值，以及控件是启用或禁用的。 此文件包含 UDI 向导中显示的、使用 UDI 向导Designer配置的所有配置设置。
单独的配置文件（UDI 向导应用程序配置文件）用于配置要安装在目标计算机上的应用程序。
UDI 向导Designer
UDI 向导Designer是为 UDI 支持的不同部署方案自定义向导页的主要工具。 UDI 向导Designer所做的更改将保存在 UDI 向导配置文件中，并最终反映在 UDI 向导中的用户体验中。 执行部署的用户将仅看到使用 UDI 向导Designer选择和配置的 UDI 向导中的向导页。
尽管 UDI 向导将使用默认的 UDI 向导配置文件运行，但不会正确配置向导页。 建议使用 UDI 向导Designer配置 UDI 向导用户体验。
注意
若要Designer运行 UDI 向导，必须在 Configuration Manager 中具有适当的权限才能访问包、应用程序或映像等对象。
验证程序
使用 UDI 验证程序来帮助确保在 UDI 向导的向导页上的文本字段中输入正确的信息。 UDI 包括多个内置验证程序，可帮助你对用于输入文本的字段执行典型验证，例如防止用户输入无效字符并确保字段不为空。 当验证程序检测到文本框中的无效条目时，向导页上会显示一条消息，并禁用“ 下一步 ”按钮，直到解决所有无效条目。
UDI 包括内置验证程序，可用于执行部署所需的大部分验证。 有关 UDI 内置验证程序的详细信息，请参阅 内置 UDI 验证程序。
如果要求超出了内置 UDI 验证程序，则可以编写自定义 UDI 验证程序。 UDI 验证程序 是用实现 IValidator 接口的C++编写的 DLL。 将 DLL 注册到 UDI 向导Designer验证程序库，方法是创建 UDI 向导Designer配置 (.config) 文件，并将其放置在 installation_folder\Bin\Config 文件夹中， (其中installation_folder是安装 MDT) 的文件夹。 有关开发自定义 UDI 任务的详细信息，请参阅 MDT 文档 用户驱动安装开发人员指南中的“创建自定义 UDI 验证程序”部分。
向导页
使用向导页在 UDI 向导中收集配置信息。 使用 UDI 向导Designer配置 UDI 向导页。 配置设置存储在 UDI 向导配置文件中，并在 UDI 向导中初始化页面时由向导页读取。
向导页存储在向导页库中，可以在一个或多个 UDI 阶段中使用。 通过此设计，可以针对所有阶段配置在阶段之间共享一次的向导页，从而大大减少所需的工作量和更新向导页面配置的复杂性。
UDI 包括内置向导页和向导页编辑器，这些编辑器通常足以满足大多数部署的需求。 有关内置向导页的详细信息，请参阅 内置 UDI 向导页。
如果要求超出了内置 UDI 向导页和相应的向导页编辑器，则可以编写自定义 UDI 向导页和向导页编辑器。 UDI 向导页实现为 UDI 向导读取的 DLL。 向导页编辑器是在 Visual Studio 中使用 C++创建的。
有关开发自定义 UDI 向导页的详细信息，请参阅 MDT 文档 用户驱动安装开发人员指南中的“创建自定义 UDI 向导页”部分。
向导页编辑器
使用向导页编辑器在 UDI 向导Designer配置向导页。 向导页编辑器更新 UDI 向导配置文件中的向导页配置设置;UDI 包括每个内置向导页的内置向导页编辑器。 有关内置向导页和向导页编辑器的详细信息，请参阅 内置 UDI 向导页。
如果要求超出了内置 UDI 向导页和相应的向导页编辑器，则可以编写自定义 UDI 向导页和向导页编辑器。 UDI 向导页编辑器实现为 UDI 向导Designer读取的 DLL。 使用创建向导页编辑器：
Microsoft Prism 版本 4.0
Microsoft Unity 应用程序块 (Unity) 2.1 版
有关开发自定义 UDI 向导页编辑器的详细信息，请参阅 MDT 文档 用户驱动安装开发人员指南中的“创建自定义向导页编辑器”部分。
OSDResults 参考
OSDResults 是 UDI 的一部分，它显示使用 UDI 执行的部署的结果。 OSDResults 显示“ 部署完成 ”对话框。 首次启动目标计算机时，WINDOWS 登录之前会显示 OSDResults。 在首次登录之前，用户可以使用 OSDResults 和“ 部署完成 ”对话框中的信息来确定部署过程的完成状态和计算机的配置。 此外， OSDResults 中的信息可用于排查部署过程中遇到的任何问题。
可以使用 OSDResults.exe.config 文件为 OSDResults 配置一些用户界面元素，该文件位于 MDT 文件Configuration Manager包中的 Tools\OSDResults 中。 表 10 列出了 OSDResults.exe.config 文件中的配置设置。
表 10. OSDResults.exe.config 文件中的配置设置
| 设置 | 说明 |
|---|---|
| headerImagePath | 此设置允许指定 OSDResults 对话框标头中显示的 .bmp 文件的完全限定路径或相对路径。 此设置的默认值如下所示： images\UDI_Wizard_Banner.bmp |
| backgroundWallpaper | 此设置允许指定在 OSDResults 对话框中显示为壁纸的 .jpg 文件的完全限定路径或相对路径。 此设置的默认值如下所示： images\Wallpaper.jpg |
| welcomeText | 此设置允许指定欢迎用户的文本，并提供有关部署过程的信息。 它显示在 “OSDResults ”对话框中。 |
| completedText | 此设置允许指定指示部署过程是否完成的文本。 它显示在 “OSDResults ”对话框中。 |
| timeoutMinutes | 此设置允许指定在自动显示 Windows 登录屏幕之前显示 OSDResults 对话框的时间长度。 此设置的值以分钟为单位指定。 此设置的默认值为零 (0) ，这表示 OSDResults 对话框将无限期显示，直到手动关闭。 |
下面是 OSDResults 功能在 UDI 中工作原理的高级过程：
任务序列在目标计算机上运行。
任务序列基于以下某个UDI 任务序列模板：
用户驱动的安装任务序列。 此任务序列模板用于 MDT 新计算机、刷新计算机和替换计算机 MDT 部署方案。
用户驱动的安装替换任务序列。 此任务序列模板是 MDT 替换计算机部署方案中两步过程的第一步，用于捕获用户状态迁移数据。 两步流程中的第二步是使用 用户驱动安装任务序列 任务序列模板的 MDT 新计算机部署方案，该模板用于部署目标应用程序和作系统，并还原过程第一步期间保存的用户状态迁移数据
有关 的详细信息：
UDI 任务序列模板，请参阅 MDT 文档中使用Microsoft部署工具包的“标识 MDT 中的 UDI 任务序列模板”部分
MDT 部署方案和 UDI 阶段之间的关系，请参阅 UDI 阶段参考
在任务序列期间，任务序列变量提供的配置设置以及 UDI 向导中用户输入的配置设置保存在目标计算机上的 %DEPLOYROOT%\Tools\OSDResults 文件夹中 (其中 %DEPLOYROOT% 是 MDT 文件本地缓存在目标计算机上的文件夹的根) 。
在任务序列的 OSD 结果和品牌 组中，将运行影响 OSDResults 的以下任务序列步骤：
缓存 OSD 结果。 此任务序列步骤将 %DEPLOYROOT%\Tools\OSDResults 文件夹的内容复制到目标计算机上的 %WINDIR%\UDI 文件夹。 这可确保在任务序列完成后保留 OSDResults 文件夹的内容。
运行 OSD 结果。 此任务序列步骤将目标计算机配置为在计算机首次启动时运行 OSDResults 。
目标计算机首次启动，OSDResults.exe 在 Windows 登录屏幕之前运行。
将显示“部署完成”对话框中的“欢迎”选项卡。 “ 欢迎 ”选项卡提供有关部署的有用信息，并在发现部署问题时提供联系信息。
查看“ 部署摘要 ”和“ 已安装的应用程序 ”选项卡上的信息，验证是否已正确安装作系统和应用程序。 完成查看这些表后，选择“ 启动 Windows ”以首次登录到 Windows 7。
注意
Configuration Manager应用程序不显示在“已安装的应用程序”选项卡上。用户首次登录到目标计算机后，将检测到Configuration Manager应用程序。
将显示 Windows 登录屏幕，登录过程会正常进行。
AppInstall.exe 在用户首次登录到目标计算机时运行。 有关此过程的详细信息，请参阅 以用户为中心的应用安装程序参考。
User-Centric 应用安装程序参考
UDI 中的 User-Centric 应用安装程序功能用于将 UDI 部署过程中安装的任何应用程序报告到 Configuration Manager 中的应用程序目录功能。 User-Centric 应用安装程序功能在 UDI 向导的“ApplicationatonPage”向导页上选择的应用程序与向用户播发的任何可选Configuration Manager应用程序之间提供链接。
有关 Configuration Manager 中的应用程序目录功能的详细信息，请参阅 Configuration Manager 中的应用程序管理。
下面是应用安装功能在 UDI 中工作原理的高级过程：
Configuration Manager应用程序是在 Configuration Manager 中创建的。
有关创建和管理Configuration Manager应用程序的详细信息，请参阅以下资源：
将创建Configuration Manager用户集合，并将用户添加到集合。
有关创建和管理用户集合以及将用户添加到集合的详细信息，请参阅以下资源：
Configuration Manager应用程序部署到用户集合。
有关如何将应用程序部署到用户集合的详细信息，请参阅如何在 Configuration Manager 中部署应用程序。
Configuration Manager应用程序可在 ApplicationatonPage 向导页上使用 UDI 向导Designer。
有关如何在 ApplicationatonPage 向导页上提供Configuration Manager应用程序的详细信息，请参阅 MDT 文档“User-Driven 安装快速入门指南”中的“步骤 5-11：自定义目标计算机的 UDI 向导配置文件”部分。
UDA 是使用以下方法之一配置的：
在配置管理器控制台 (有关在Configuration Manager控制台中配置 UDA 的详细信息，请参阅如何在 Configuration Manager 中管理用户设备相关性.)
在 UDI 向导的 UDAPage 向导页上。 有关 UDAPage 向导页的详细信息，请参阅 UDAPage。
配置 UDA 后，指定的用户帐户将成为目标计算机的主要用户。
注意
在新计算机部署方案中，只能由 UDI 配置 UDA。 无法在“刷新计算机”或“替换计算机”部署方案中配置它。
任务序列将运行，用户将在 UDI 向导的“ApplicatonPage”向导页上选择Configuration Manager应用程序。
UDI 向导在任务序列的预安装组中的 UDI 向导任务序列步骤中运行。 当用户在“ApplicatonPage”向导页上选择Configuration Manager应用程序时，向导页将为每个所选应用程序创建单独的任务序列变量。
有关在 UDI 向导的“ApplicationatonPage”向导页上选择Configuration Manager应用程序的详细信息，请参阅 MDT 文档“User-Driven 安装快速入门指南”中的“步骤 6-4：使用任务序列可启动媒体启动目标计算机”部分。
任务序列安装上一步中选择的Configuration Manager应用程序。
使用任务序列中的“安装应用程序”组中的以下任务序列步骤安装Configuration Manager应用程序：
将列表转换为两位数字
安装应用程序
在首次启动目标作系统之前，任务序列在 OSD 结果和品牌 组中执行以下任务：
将用于 OSDResults.exe 的信息复制到 缓存 OSD 结果 任务序列步骤中目标计算机上的 %WINDIR%\UDI 文件夹
记录在目标计算机上的注册表中为Configuration Manager应用程序创建的步骤 6 中创建的任务序列变量：将品牌设置为 Reg，将品牌设置为 Reg x64 任务序列步骤
任务序列变量保存在注册表中的以下位置：
HKEY_LOCAL_MACHINE\Software\Microsoft\MPSD\OSD
将目标作系统配置为在运行 OSD 结果 任务序列步骤中的 Windows 登录屏幕之前启动计算机时自动运行 OSDResults.exe
将目标作系统配置为在用户首次在“ 运行 OSD 结果 ”任务序列步骤中首次登录到计算机时自动运行 AppInstall.exe
在目标作系统上配置任务，以从部署之日起一个月内删除 %WINDIR%\UDI 文件夹
目标计算机已启动，OSDResults.exe 运行。
有关 OSDResults.exe 的详细信息，请参阅 OSDResults 参考。
用户登录到目标计算机，AppInstall.exe 自动启动。
AppInstall 检查当前登录的用户是否是在 UDA 中配置的主要用户。
主要用户是定期使用设备的用户，并被视为设备的所有者或所有者之一。
如果当前登录的用户为：
不是主要用户，则 AppInstall.exe 停止
然后，主用户 AppInstall.exe 读取步骤 8 中保存的注册表项，以确定安装了哪些应用程序
AppIntaller 连接到 Configuration Manager并使用以下步骤读取应用程序目录：
AppInstall 将在启动后等待 5 分钟，以允许Configuration Manager策略可用。
5 分钟后，AppInstall 尝试连接到应用程序目录。
如果 AppInstall 无法连接，它将等待一段时间，然后再尝试再次连接。
AppInstall 在退出之前最多尝试连接五次。
可以使用位于 MDT 文件Configuration Manager包中的 Tools\OSDResults 文件夹中的 AppInstall.exe.config 文件配置 AppInstall 的连接超时延迟和重试次数。 表 11 列出了 AppInstall.exe.config 文件中的配置设置。
表 11. AppInstall.exe.config 文件中的配置设置
| 设置 | 说明 |
|---|---|
| timeoutMinutes | 此设置允许指定 AppInstall 在超时之前等待来自Configuration Manager应用程序目录的响应的时间长度。该值以分钟为单位指定。 此设置的默认值为 5。 |
| delayTimer | 此设置允许指定 AppInstall 在尝试连接到Configuration Manager应用程序目录之前等待的时间长度。 该值以分钟为单位进行指定。 此设置的默认值为 5。 |
AppInstall 将注册表中发现的应用程序列表与当前登录用户的配置管理器应用程序目录中可用的应用程序列表进行比较。
如果在注册表中发现了应用程序：
在应用程序目录中可用，然后 AppInstall.exe 映射应用程序，并将应用程序标识为注册表和应用程序目录中的现有应用程序。 下一步中将使用这些应用程序。
在应用程序目录中不可用，则 AppInstall.exe 不会创建映射。 下一步中不会使用这些应用程序。
AppInstall 使用 Configuration Manager API 来启动映射应用程序的安装。
此步骤中使用的应用程序已在上一步中映射。 也就是说，它们都列在注册表中，并在应用程序目录中找到。
作为安装过程的一部分，Configuration Manager检测应用程序是否已安装。
由于已安装应用程序，因此Configuration Manager记录应用程序已成功部署到该用户，并且该应用程序将在该用户的软件中心列出。 Configuration Manager开始管理和监视该用户的应用程序。
1 个月后，在步骤 8 中的目标计算机上创建的任务将运行并删除 %WINDIR%\UDI 文件夹。
文件夹保留 1 个月，以便主要用户有机会登录并运行 AppInstall.exe。
UDI 阶段参考
MDT 部署方案使用一个或多个 UDI 阶段。 MDT 部署方案中使用的每个 UDI 阶段将在 MDT 部署方案上下文的后续部分中讨论。 在某些 MDT 部署方案中，仅使用一个阶段。 在其他 MDT 部署方案中，方案内使用了多个阶段。 有关 MDT 部署方案的详细信息，请参阅 MDT 文档中使用Microsoft部署工具包中的“标识部署方案”部分。
表 12 列出了 MDT 部署方案，并简要介绍了每种部署方案、如何选择每个方案以及在每个部署方案中使用哪些 UDI 阶段。 MDT 根据用于创建任务序列的 MDT 任务序列模板以及任务序列的启动方式自动确定要使用的 MDT 部署方案。
MDT 部署方案中使用的每个 UDI 阶段将在 MDT 部署方案上下文的后续部分中讨论。 在某些 MDT 部署方案中，仅使用一个阶段。 在其他 MDT 部署方案中，方案内使用了多个阶段。 有关 MDT 部署方案的详细信息，请参阅 MDT 文档中使用Microsoft部署工具包中的“标识部署方案”部分。
表 12. MDT 部署方案和 UDI 阶段
| 应用场景 | 说明 |
|---|---|
| 新建计算机 | 在以下情况下，适用于 UDI 的 MDT 会自动选择此方案： - 使用 User-Driven 安装任务序列任务序列模板创建播发的任务序列 - 使用 PXE 启动、任务序列启动媒体或 NEWCOMPUTER 的预留媒体在 Windows PE 中启动任务序列。预留阶段 此方案可用于传统部署或预留媒体部署，如Configuration Manager中支持的那样。 使用以下 UDI 阶段运行 UDI 向导，以支持每种类型的部署： - NEWCOMPUTER 阶段。 当作系统映像存储在分发点上时，将在 用户驱动的安装任务序列 任务序列中使用此阶段运行 UDI 向导。 有关详细信息，请参阅 NEWCOMPUTER 阶段。 - NEWCOMPUTER。预留阶段。 当作系统映像存储在目标计算机上的本地磁盘 (预留) 时，将在 用户驱动的安装任务序列 任务序列中使用此阶段运行 UDI 向导。 有关详细信息，请参阅 NEWCOMPUTER。预留阶段。 |
| 刷新计算机 | 在以下情况下，适用于 UDI 的 MDT 会自动选择此方案： - 使用 User-Driven 安装任务序列任务序列模板创建播发的任务序列 - 在目标计算机上的现有 Windows作系统中启动任务序列， (不在 Windows PE) - 使用 REFRESH 阶段运行 UDI 向导以支持此部署方案。 有关详细信息，请参阅 REFRESH Stage。 |
| 替换计算机 | 此方案包括现有计算机和替换计算机。 将按以下过程中所述，在每台计算机上创建并运行单独的任务序列： - 在现有计算机上。 在以下情况下，适用于 UDI 的 MDT 会自动选择方案的这一部分： - 使用 User-Driven 安装替换任务序列任务序列任务序列模板创建播发的任务序列 在目标计算机上的现有 Windows作系统中启动任务序列， (不在 Windows PE) UDI 向导通过以下 UDI 阶段运行，以支持此部署方案： - REPLACE 阶段。 此阶段在现有 Windows作系统中运行，并从 Windows 中捕获配置信息。 - 取代。WinPE 阶段。 此阶段在 Windows PE 中运行，并完成从现有计算机捕获配置信息，例如，运行 USMT 和捕获用户状态迁移数据。 用户状态捕获到网络共享文件夹或本地 U 盘。 有关 REPLACE 和 REPLACE 的详细信息。WinPE 阶段，请参阅 REPLACE 和 REPLACE。WinPE 阶段。 - 在替换计算机上。 该方案的这一部分与新计算机方案相同，只是还原了在上一步中捕获的用户状态。 在以下情况下，适用于 UDI 的 MDT 会自动选择方案的这一部分： - 使用 User-Driven 安装任务序列任务序列模板创建播发的任务序列 - 使用 PXE 启动、任务序列启动媒体或 NEWCOMPUTER 的预留媒体在 Windows PE 中启动任务序列。预留阶段。 该方案的这一部分可以用于传统部署或预留媒体部署，如Configuration Manager中支持的那样。 作为方案的这一部分的一部分，用户状态迁移数据将还原。 UDI 向导使用以下 UDI 阶段运行，以支持每种类型的部署： - NEWCOMPUTER 阶段。 当作系统映像存储在分发点上时，将在 用户驱动的安装任务序列 任务序列中使用此阶段运行 UDI 向导。 有关详细信息，请参阅 NEWCOMPUTER 阶段。 - NEWCOMPUTER。预留阶段。 当作系统映像存储在目标计算机上的本地磁盘 (预留) 时，将在 用户驱动的安装任务序列 任务序列中使用此阶段运行 UDI 向导。 有关详细信息，请参阅 NEWCOMPUTER。预留阶段。 |
NEWCOMPUTER 阶段
图 1 演示了如何在使用 User-Driven 安装任务序列任务序列模板创建的任务序列中使用 NEWCOMPUTER 阶段。 调用 NEWCOMPUTER 阶段的任务序列与 NEWCOMPUTER 之间的主要区别。预留阶段是调用 NEWCOMPUTER 的任务序列。预留阶段不会运行 “应用作系统映像 ”任务序列步骤，因为作系统映像已位于目标计算机上。
图 SEQ 图 \* 阿拉伯语 1。 NEWCOMPUTER 阶段的进程流
NEWCOMPUTER。预留阶段
图 2 演示了 NEWCOMPUTER 的高级流程流。使用 User-Driven 安装任务序列任务序列模板创建的任务序列中的预留阶段。 调用 NEWCOMPUTER 阶段的任务序列与 NEWCOMPUTER 之间的主要区别。预留阶段是调用 NEWCOMPUTER 的任务序列。预留阶段不会运行 “应用作系统映像 ”任务序列步骤，因为作系统映像已位于目标计算机上。
图 2. NEWCOMPUTER 的进程流。预留阶段
REFRESH 阶段
图 3 演示了使用 User-Driven 安装任务序列任务序列模板创建的任务序列中 REFRESH 阶段的高级流程流。
图 SEQ 图 \* 阿拉伯语 3。 REFRESH 阶段的进程流
REPLACE 和 REPLACE。WinPE 阶段
图 4 演示了 REPLACE 和 REPLACE 的高级流程流。使用 User-Driven 安装替换任务序列模板创建的任务序列中的 WinPE 阶段。
图 4. REPLACE 和 REPLACE 的进程流。WinPE 阶段
UDI 任务参考
UDI 任务 是在执行特定功能的向导页上运行的软件。 在某些情况下，这些任务用于验证目标计算机是否已准备好进行部署。 其他任务可用于执行部署步骤，例如复制配置或结果文件。
注意
如果任一任务以警告或错误完成状态完成，则会禁用运行任务向导页上的“ 下一步 ”按钮。
此参考包括：
UDI 任务概述，如 UDI 任务概述中所述
UDI 任务配置设置的说明，如 UDI 任务配置设置中所述
对随 MDT 提供的内置 UDI 验证程序的说明，如内置 UDI 任务中所述
UDI 任务概述
UDI 任务允许你在目标计算机上运行有助于部署过程的软件。 UDI 包括多个内置任务，可帮助你执行常见任务，例如确保目标计算机不在电池上运行，并且已连接到有线网络连接。
除了内置 UDI 任务，还可以使用 UDI 软件开发工具包 (SDK) 创建自定义 UDI 任务。 有关使用 UDI SDK 创建自定义 UDI 任务的详细信息，请参阅 用户驱动安装开发人员指南。
UDI 任务配置设置
使用 UDI 向导Designer管理任务。 可以在 UDI 向导Designer中添加任务、删除任务和编辑任务的配置。 任务的配置设置存储在 UDI 向导配置文件中，并在显示包含任务的向导页时由 UDI 向导读取。
UTI 任务具有一些对所有 UDI 任务通用的配置设置，如表 13 中所列。 有关特定于每个 UDI 任务的配置设置，请参阅 内置 UDI 任务中的相应部分。
表 13. 所有 UDI 任务通用的配置设置
| 任务 | 说明 |
|---|---|
| 位图文件名 | 此参数指定用于指示任务类型的图形。 |
| 显示名称 | 这将指定任务的名称，该名称在运行任务时显示在向导页上。 |
| 退出代码值 | 这将指定任务的可能返回代码的列表。 列表中存在每个可能的返回代码的项。 |
| 错误代码值 | 这指定任务 (引发) 可能遇到的意外异常的列表。 列表中存在每个可能的异常的项。 |
内置 UDI 任务
表 14 列出了内置 UDI 任务。 后续部分将讨论每个内置 UDI 任务。
表 14. 内置 UDI 任务
| 任务 | 说明 |
|---|---|
| 交流电源检查 | 此 UDI 任务用于标识目标计算机是否连接到交流电源，而不仅仅是连接到电池。 |
| 应用程序发现 | 此 UDI 任务用于发现安装在目标计算机上的应用程序。 |
| CheckSMSFolderOnUSB | 此 UDI 任务用于确定_SMSTaskSequence文件夹是否位于目标计算机上的 U 盘上。 |
| 复制文件任务 | 当 UDI 向导在目标计算机上运行时，此 UDI 任务用于复制文件。 |
| Shell 执行任务 | 此 UDI 任务用于运行可从命令行启动的软件。 |
| 有线网络检查 | 此 UDI 任务用于标识目标计算机是否连接到有线网络，而不是使用无线网络连接。 |
交流电源检查
使用此 UDI 任务来确定目标计算机是否连接到交流电源。 此任务仅使用所有 UDI 任务通用的参数。 有关这些参数的详细信息，请参阅 UDI 任务配置设置。
表 15 列出了 交流电源检查 任务生成的错误和退出代码。
表 15. 交流电源检查任务的错误和退出代码
| 退出或错误代码 | 值 | 状态 |
|---|---|---|
| Exit | 0 | 成功，指示目标计算机已插入交流电源 |
| Exit | \* | 错误，指示目标计算机未插入交流电源 |
应用程序发现
使用此 UDI 任务发现安装在目标计算机上的应用程序。
表 16 列出了 应用程序发现 任务使用的参数。
表 16. 应用程序发现任务使用的参数
| 任务 | 说明 |
|---|---|
| Readcfg | 此参数指定具有要发现的任务的应用程序列表的.app文件位置的完全限定路径或相对路径。 .app文件包含用户可从中选择的可用软件项列表。 应用程序发现任务读取.app文件，并确定是否安装了其中任何软件项。 如果安装了软件项，该项将添加到 Writecfg 参数中指定的文件中。 确保此参数使用与 ApplicationPage 向导页相同的位置和文件名。 |
| Writecfg | 此参数指定包含任务发现的应用程序列表的 .xml 文件位置的完全限定路径或相对路径。 |
| Log | 此参数指定此任务生成的日志文件位置的完全限定路径或相对路径。 日志文件的文件名AppDiscovery.log。 |
除了表 16 中的参数外，此任务还使用所有 UDI 任务共有的参数。 有关这些常见参数的详细信息，请参阅 UDI 任务配置设置。
表 17 列出了 应用程序发现 任务生成的错误和退出代码。
表 17. 应用程序发现任务的错误和退出代码
| 退出或错误代码 | 值 | 状态和说明 |
|---|---|---|
| Exit | 0 | 成功，表示任务已成功扫描应用程序 |
| Exit | \* | 警告，指示由于某些未知原因而无法运行应用程序发现引擎 |
| Exit | 1 | 警告，指示应用程序发现引擎遇到一个或多个警告 |
| Exit | 16777216 | 警告，指示初始化应用程序发现引擎时遇到严重问题 |
| Exit | 33554432 | 警告，指示处理应用程序主列表时遇到严重问题 |
CheckSMSFolderOnUSB
使用此 UDI 任务确定_SMSTaskSequence文件夹是否位于目标计算机上的 USB 驱动器上。 默认情况下，Configuration Manager任务序列程序将 _SMSTaskSequence 文件夹放置在可用磁盘空间最多的驱动器上。 如果删除 U 盘，这可能会导致部署过程中稍后出现问题。
此任务检查文件夹是否位于 U 盘上，并阻止部署继续（如果是）。 此任务仅使用所有 UDI 任务通用的参数。 有关这些参数的详细信息，请参阅 UDI 任务配置设置。
如果_SMSTaskSequence文件夹位于 U 盘上，则此任务会失败，并阻止部署继续。 若要解决此问题并执行部署，请完成以下步骤：
在启动任务序列之前，断开 U 盘与目标计算机的连接。
启动任务序列。
等待 UDI 向导启动。
连接 U 盘。
完成 UDI 向导。
表 18 列出了 CheckSMSFolderOnUSB 任务生成的错误和退出代码。
表 18. CheckSMSFolderOnUSB 任务的错误和退出代码
| 退出或错误代码 | 值 | 状态 |
|---|---|---|
| Exit | 0 | 成功，指示 _SMSTaskSequence 文件夹不位于 U 盘上，部署可以继续。 |
| Exit | \* | 错误，指示 _SMSTaskSequence 文件夹位于 U 盘上，部署无法继续。 |
复制文件任务
当 UDI 向导在目标计算机上运行时，使用此 UDI 任务复制文件。
表 19 列出了 复制文件 任务使用的参数。
表 19. 复制文件任务使用的参数
| 任务 | 说明 |
|---|---|
| Source | 此参数指定源文件的完全限定路径或相对路径，其中可以包含通配符，以便使用单个任务复制多个文件。 |
| 目标 | 此参数指定目标文件不带文件名的完全限定路径或相对路径。 |
除了表 19 中的参数外，此任务还使用所有 UDI 任务通用的参数。 有关这些参数的详细信息，请参阅 UDI 任务配置设置。
表 20 列出了 复制文件 任务生成的错误和退出代码。
表 20. 复制文件任务的错误和退出代码
| 退出或错误代码 | 值 | 状态和说明 |
|---|---|---|
| Exit | 0 | 成功，表示复制过程成功 |
| Exit | \* | 错误，指示复制过程失败 |
| 错误 | -1 | 错误，指示复制过程失败 |
Shell 执行任务
使用此 UDI 任务运行可从命令行启动的软件。
表 21 列出了 Shell 执行 任务使用的参数。
表 21. Shell 执行任务使用的参数
| 任务 | 说明 |
|---|---|
| Filename | 此参数指定要运行的命令的完全限定路径或相对路径。 |
| 参数 | 此参数指定运行命令时将提供的命令行参数。 |
除了表 21 中的参数外，此任务还使用所有 UDI 任务共有的参数。 有关这些参数的详细信息，请参阅 UDI 任务配置设置。
还可以使用 Shell 执行 任务运行设计为在 cscript.exe 中运行的自定义 Visual Basic 脚本。 若要运行 Visual Basic 脚本，请执行以下步骤：
在 Filename 参数中键入以下文本：
%windir%\system32\cscript.exe在 Parameters 参数中键入 Visual Basic 脚本文件 (.vbs 文件) 的名称，包括脚本的任何命令行参数。
例如，若要运行名为 SelfTest.vbs 且参数值为 Debug 的 Visual Basic 脚本，请键入以下 (其中 script_path 是 SelfTest.vbs 文件) 的完全限定路径：
<script_path>\SelfTest.vbs Debug表 22 列出了 Shell 执行 任务生成的常见错误和退出代码。
注意
基于 Shell 执行 任务的每个特定任务都有一组唯一的错误和退出代码。 请检查使用此任务运行的软件的返回代码。
表 22. Shell 执行任务的常见错误和退出代码
| 退出或错误代码 | 值 | 状态和说明 |
|---|---|---|
| Exit | 0 | 成功，表示任务已成功完成 |
| Exit | \* | 错误，指示任务失败 |
有线网络检查
使用此 UDI 任务可以确定目标计算机是否连接到有线网络，而不是使用无线网络连接。 此任务仅使用所有 UDI 任务通用的参数。 有关这些参数的详细信息，请参阅 UDI 任务配置设置。
表 23 列出了 有线网络检查 任务生成的常见错误和退出代码。
表 23. 有线网络检查任务的错误和退出代码
| 退出或错误代码 | 值 | 状态和说明 |
|---|---|---|
| Exit | 0 | 成功，指示目标计算机已连接到有线网络 |
| Exit | \* | 错误，指示目标计算机未连接到有线网络 |
UDI 验证程序参考
UDI 验证程序用于验证在向导页上的文本字段中输入的值。 当 UDI 验证程序检测到无效条目时，将显示向导页面底部遇到的第一个错误的消息。 解决第一个验证错误后，将显示下一个验证错误消息（如果有）。 此过程会一直持续到所有验证错误得到解决。 在解决向导页上的所有验证错误之前， 禁用“下一步 ”按钮。
此参考包括：
UDI 验证程序概述，如 UDI 验证程序概述中所述
与 MDT 一起提供的内置 UDI 验证程序的说明，如内置 UDI 验证程序中所述
UDI 验证程序概述
UDI 验证程序用于帮助确保用户在 UDI 向导的向导页上的文本字段中提供正确的信息。 UDI 包括多个内置验证程序，可帮助你对用于输入文本的字段执行典型验证，例如防止用户输入无效字符或确保字段不为空。
除了内置的 UDI 验证程序，还可以使用 UDI SDK 创建自定义 UDI 验证程序。 有关使用 UDI SDK 创建自定义 UDI 验证程序的详细信息，请参阅 MDT 文档 用户驱动的安装开发人员指南。
内置 UDI 验证程序
表 24 列出了内置的 UDI 验证程序。 后续部分将讨论每个内置验证程序。 当验证程序检测到文本框中的无效条目时，向导页上会显示一条消息，并禁用“ 下一步 ”按钮，直到解决所有无效条目。
表 24. 内置 UDI 验证程序
| 验证程序 | 说明 |
|---|---|
| InvalidChars | 此验证程序标识已从配置的列表中输入的任何无效字符。 |
| NamedPattern | 此验证程序有助于确保文本遵循预定义模式。 |
| NonEmpty | 此验证程序用于要求字段中的文本。 |
| RegEx | 通过此验证程序，可以确保文本与指定为验证器的一部分的正则表达式匹配。 |
InvalidChars
此验证程序可防止用户输入特定字符。 “ 消息 ”框允许输入在文本字段包含任何无效字符时显示的消息。 “ 无效字符 ”框允许输入被视为无效的字符。 输入字符之间不带空格。
NamedPattern
此验证程序有助于确保文本遵循预定义模式。 “ 消息 ”框允许输入在文本字段与命名模式不匹配时显示的消息。 “命名模式”框允许输入预定义模式的名称，并且必须是“用户名”、“ComputerName”或“工作组”。 名称不区分大小写。
NonEmpty
使用此验证程序需要字段中的文本。 “ 消息 ”框允许输入在文本字段为空时显示的消息。
RegEx
通过此验证程序，可以确保文本与指定为验证器的一部分的正则表达式匹配。 “ 消息 ”框允许输入文本字段与正则表达式不匹配时显示的消息。 “ 正则表达式 ”框允许输入用于验证的正则表达式。 有关如何为此验证程序生成正则表达式的详细信息，请参阅 TR1 正则表达式。
UDI 向导页参考
将 UDI 向导页添加到 UDI 向导Designer页库中的阶段。 UDI 向导页显示在 UDI 向导中。
此参考包括：
UDI 向导页概述，如 UDI 向导页概述中所述
与 MDT 一起提供的内置 UDI 向导页的说明，如内置 UDI 向导页中所述
UDI 向导页概述
向导页显示在 UDI 向导 中，并收集完成部署过程所需的信息。 在 Visual Studio 中使用 C++ 创建向导页。 自定义向导页实现为 UDI 向导读取的 DLL。
每个内置 UDI 向导页都有相应的 UDI 向导页编辑器，可用于在 UDI 向导Designer配置向导页。
除了内置的 UDI 向导页，还可以使用 UDI SDK 创建自定义 UDI 向导页。 有关使用 UDI SDK 创建自定义 UDI 向导页的详细信息，请参阅 MDT 文档 用户驱动的安装开发人员指南。
每个向导页都可以引用以下类型的变量：
任务序列变量
内存变量
环境变量
可以通过使用百分比符号 (%) （如 %OSDImageIndex% ）来引用任务序列和环境变量。可以通过使用美元符号 ($) （如 $VolumeArchitecture$）将变量括起来来引用内存 变量。
注意
如果任务序列变量和环境变量具有相同的名称，则任务序列变量优先于环境变量。
表 25 列出了 UDI 向导启动时设置的内存变量、变量的说明，以及 UDI 向导在启动期间是读取还是写入变量。
表 25. 启动时由 UDI 向导设置的内存变量及其说明
| "变量" | Read | Write |
|---|---|---|
|
LogPath 指定 UDI 向导日志文件的完全限定路径。 可以将此变量设置为以下值之一： - _SMSTSLogPath 任务序列变量中的值 - 如果未设置 _SMSTSLogPath 任务序列变量，则为 %TEMP% 环境变量的值 |
否 | 是 |
|
WizardConfigFilename 指定当前正在使用的 UDI 向导配置文件的名称。 ApplicationPage 向导页读取此变量的值，以查找相应的.app文件，其中包含应用程序列表。 例如，如果 UDI 向导配置文件名为 config.xml， 则向导页将查找相应的.app文件 (config.xml.app) 。 |
否 | 是 |
内置 UDI 向导页
表 26 列出了内置 UDI 向导页。 后续部分将讨论每个内置 UDI 向导页。
表 26. 内置向导页及其说明
| 向导页面 | 说明 |
|---|---|
| AdminAccounts | 使用此向导页可设置本地管理员帐户的密码，并将其他用户添加到目标计算机上的本地管理员组。 |
| ApplicationPage | 使用此向导页可以配置可在安装过程中安装的应用程序列表。 这些应用程序可以包括来自 Configuration Manager 的应用程序或包和程序。 |
| BitLockerPage | 使用此向导页为目标计算机配置 BitLocker 设置。 |
| ComputerPage | 使用此向导页可以配置目标计算机的计算机名称、要加入的域或工作组，以及加入域时要使用的凭据。 |
| ConfigScanPage | 使用此向导页可以运行 UDI 任务，这些任务扫描目标计算机的配置，以确定目标计算机是否已准备好部署作系统映像。 这种准备情况包括拥有足够的系统资源，并确保正确安装和配置任何必备软件。 |
| LanguagePage | 使用此向导页可以确定应安装的语言包、目标作系统的默认语言、键盘区域设置以及计算机的物理位置所在时区。 |
| ProgressPage | 使用此向导页可以运行从目标计算机捕获用户状态迁移数据的 UDI 任务。 |
| RebootPage | 使用此向导页可通知用户目标计算机将重启。 可以使用 UDI 向导Designer配置通知消息。 |
| SummaryPage | 使用此向导页可通知用户在运行 UDI 向导时选择的配置选项。 此向导页上显示的配置信息会自动从其他向导页收集。 其他向导页上的某些字段允许使用 UDI 向导Designer配置在此向导页上显示的描述文字 (标签) 。 |
| UDAPage | 使用此向导页在目标计算机和指定用户之间配置 UDA。 通过定义计算机和用户之间的相关性，可以自动安装部署到用户的软件。 UDA 功能仅在 Configuration Manager 和 UDI 新计算机方案中可用。 |
| UserStatePage | 使用此向导页配置用于捕获或还原用户状态迁移数据的设置。 此向导页允许用户选择用于捕获用户状态迁移或从中还原用户状态迁移数据的位置。 |
| VolumePage | 使用此向导页可在将部署作系统的目标计算机上配置磁盘卷的设置。 这些设置包括选择目标作系统、选择目标驱动器、选择任何 Windows 安装，以及确定是否应在部署过程中格式化目标驱动器。 |
| WelcomePage | 使用此向导页可向用户提供有关 UDI 向导和部署过程的信息。 可以使用 UDI 向导Designer配置通知消息。 |
AdminAccounts
使用此向导页可设置本地管理员帐户的密码，并将其他用户添加到目标计算机上的本地管理员组。
任务序列变量
表 27 列出了 AdminAccounts 任务序列变量以及说明，并确定该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 27. AdminAccounts 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
OSDAddAdmin 指定要添加到目标计算机上的本地管理员组的其他用户名的列表。 |
是 | 是 | 是 |
|
OSDLocalAdminPassword 指定目标计算机上的本地内置管理员帐户的密码。 |
是 | 是 | 是 |
ApplicationPage
使用此向导页可以配置可在安装过程中安装的应用程序软件列表。 这些应用程序可以包括来自 Configuration Manager 的应用程序或包和程序。
注意
如果应用程序显示为已禁用，则应用程序可能需要管理员批准，但尚未获得批准。 如果为应用程序选择了“如果用户请求此应用程序检查需要管理员批准”框，请验证该应用程序是否已获得批准。 有关详细信息，请参阅如何在 Configuration Manager 中部署应用程序。
任务序列变量
表 28 列出了 ApplicationPage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 28. ApplicationPage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
ApplicationBaseVariable 指定用作为 ApplicationPage 向导页上选择的每个Configuration Manager应用程序创建的任务序列变量名称基的名称。 此变量是使用 UDI 向导Designer功能区上“编辑设置”组中的“编辑软件设置”按钮配置的。 将为此页上选择的每个应用程序创建单独的任务序列变量。 此变量的默认值为 APPLICATIONS。 因此，例如，为此页上选择的每个应用程序创建的任务序列变量的默认名称将 APPLICATIONS001、APPLICATIONS002、APPLICATIONS003 等。 |
否 | 是 | 是 |
|
OSDApplicationList 指定最初应选择的应用程序标识符列表。 变量包含用分号 (;) 分隔的数值列表。 应用程序标识符位于 UDI 向导应用程序配置文件中的 Application 元素的 Id 属性 (UDIWizard_Config.xml.app) 。 此向导页中显示的每个应用程序都有单独的 Application 元素。 |
是 | 否 | 否 |
|
OSDArchitecture 指定目标计算机的处理器体系结构。 未设置 VolumeArchitecture 内存变量时，ApplicationPage 向导页使用此变量筛选可用应用程序。 但是，如果已设置 VolumeArchitecture 内存变量，则它始终优先于此任务序列变量来筛选可用应用程序。 此变量的值可以是： - x86，指示 32 位处理器体系结构 - amd64，指示 64 位处理器体系结构 |
是 | 否 | 否 |
|
OSDBaseVariableName 指定用作为 ApplicationPage 向导页上选择的每个Configuration Manager包和程序创建的任务序列变量名称基的名称。 此变量是使用 UDI 向导Designer功能区上“页面行为”组中的“编辑软件设置”按钮配置的。 将为此页上选择的每个应用程序创建单独的任务序列变量。 此变量的默认值为 PACKAGES。 例如，为此页上选择的每个应用程序创建的任务序列变量的默认名称将 PACKAGES001、PACKAGES002、PACKAGES003 等。 |
否 | 是 | 是 |
内存变量
表 29 列出了 ApplicationPage 内存变量以及说明以及该变量是由向导页读取还是写入的。
表 29. ApplicationPage 内存变量
| "变量" | Read | Write |
|---|---|---|
|
VolumeArchitecture 指定要部署的目标作系统映像的处理器体系结构， (映像是包含 32 位还是 64 位作系统) 。 显示此页面时，它会检查此变量是否已更改。 如果自上次显示向导页以来变量已更改，向导页会根据目标作系统的体系结构筛选可供选择的程序。 例如，如果要部署 32 位作系统，向导页将从向导页上的可用应用程序列表中删除 (筛选器) 任何 64 位应用程序。 |
是 | 否 |
|
WizardConfigFilename 指定当前正在使用的 UDI 向导配置文件的名称。 如果 Link.Uri setter 属性的值为空， 则 ApplicationPage 向导页将读取此变量的值，以查找包含应用程序列表的相应.app文件。 例如，如果 UDI 向导配置文件名为 config.xml， 则向导页将查找相应的.app文件 (config.xml.app) 。 此变量在 UDI 向导启动时设置。 Link.Uri setter 属性在“软件设置”对话框中设置，可以使用 UDI 向导Designer功能区上“页面行为”组中的“编辑软件设置”按钮打开该对话框。 |
是 | 否 |
BitLockerPage
此向导页用于为目标计算机配置 BitLocker 设置。
任务序列变量
表 30 列出了 BitLockerPage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 30. BitLockerPage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
BDEInstallSuppress 指定是否应取消 BitLocker 安装。 如果变量设置为： - 是，然后选中“启用 BitLocker 检查”框并执行安装 - 否，然后清除“启用 BitLocker 检查”框，并且不会执行安装 |
是 | 是 | 是 |
|
BDEKeyLocation 指定 BitLocker 加密密钥的存储位置的完全限定路径，该路径可以是本地路径或 UNC 路径。 此变量设置为 BitLockerPage 的 UDI 向导配置文件中 KeyLocation setter 值的值。 仅当 OSDBitLockerMode 设置为 TPMKEY 或 KEY 时，此变量才被视为有效。 |
否 | 是 | 否 |
|
BDEPin 如果选中了“ 使用 TPM 和 Pin 启用 BitLocker ”选项，则指定 BitLocker PIN 值。 |
是 | 是 | 是 |
|
OSDBitLockerCreateRecoveryPassword 指定是否应将 BitLocker 恢复密码存储在 AD DS 中。 如果变量设置为： - AD，然后选中“ 在 Active Directory” 选项，并将恢复密钥存储在 AD DS 中， (建议) - NONE，然后选择 “不创建恢复密钥 ”选项，并且恢复密钥不会存储在 AD DS 中， (不建议) |
否 | 是 | 否 |
|
OSDBitLockerMode 指定在目标计算机上启用 BitLocker 时要使用的模式。 有效值包括： - TPM。 此值指示已选择 “仅使用 TPM 启用 BitLocker ”选项，并且仅在目标计算机上启用 BitLocker 时使用 TPM。 - TPMPIN。 此值指示选中了 “使用 TPM 启用 BitLocker 和 Pin” 选项，并在目标计算机上启用 BitLocker 时将使用 TPM 和用户指定的 PIN。 - TPMKEY。 此值指示选中“ 使用 TPM 启用 BitLocker 和启动密钥 ”选项，并在目标计算机上启用 BitLocker 时使用 TPM 和启动密钥。 - 钥匙。 此值指示选中了 “仅使用外部启动密钥启用 BitLocker ”选项，并在目标计算机上启用 BitLocker 时仅使用外部启动密钥。 |
否 | 是 | 否 |
|
OSDBitLockerStartupKeyDrive 指定将 BitLocker 外部启动密钥存储在目标计算机上的驱动器号。 仅当 OSDBitLockerMode 设置为 TPMKEY 或 KEY 时，此变量才被视为有效。 |
否 | 是 | 否 |
|
OSDBitLockerWaitForEncryption 指定任务序列是否应等待 BitLocker 加密完成。 如果变量设置为： - 是，然后选中“等待所有驱动器上的 BitLocker 加密完成，然后继续检查”框，任务序列将等待安装完成 - 否，然后清除“等待所有驱动器上的 BitLocker 加密完成然后再继续检查”框，并且任务序列不会等到安装完成 |
是 | 是 | 是 |
配置变量
表 31 列出了 BitLockerPage 配置变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 31. BitLockerPage 配置变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
KeyLocation 指定 BitLocker 加密密钥的存储位置的完全限定路径，该路径可以是本地路径或 UNC 路径。 此配置值用于设置 BitLockerPage 的 BDEKeyLocation 任务序列变量的值。 仅当 OSDBitLockerMode 设置为 TPMKEY 或 KEY 时，此变量才被视为有效。 |
是 | 否 | 是 |
ComputerPage
使用此向导页可以配置目标计算机的计算机名称、要加入的域或工作组，以及加入域时要使用的凭据。 将此页面配置为将目标计算机加入域时，此向导页将默认验证你提供的用于在 AD DS 中加入域的凭据。 然后，此向导页尝试修改 AD DS 中的计算机对象，以验证此页上提供的用户凭据是否有权创建或修改计算机对象。 可以禁用其中任一行为。 如果禁用凭据验证，则创建或修改计算机对象的权限验证也会被禁用。 选择“ 下一步 ”按钮时，将执行这两种验证。 如果任一验证遇到错误，将显示一条错误消息，并且此页面将继续显示。
以下是确定默认计算机名称的优先级顺序：
如果 UDI 向导配置文件中的 UserExistingComputerName 值设置为 TRUE，则使用现有计算机名称 (（如果存在) ）。
如果设置了 OSDComputerName 任务序列变量，则使用该变量中的计算机名称。
如果在 UDI 向导配置文件中为计算机名称指定了默认值，则使用该值。
任务序列变量
表 32 列出了 ComputerPage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 32. ComputerPage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
OSDComputerName 指定目标计算机的名称。 此变量的值在 “计算机名称 ”框中设置。 |
是 | 是 | 是 |
|
OSDDomainName 指定要加入目标计算机的域的名称。 此变量的值在 “域 ”框中设置。 |
是 | 是 | 是 |
|
OSDDomainOUName 指定要放置目标计算机对象的域中 OU 的名称。 此变量的值在 “组织单位 ”框中设置。 |
是 | 是 | 是 |
|
OSDJoinAccount 指定用于将目标计算机加入域的用户帐户。 此变量的值在 “用户名 ”框中设置。 |
是 | 是 | 是 |
|
OSDJoinPassword 指定用于将目标计算机加入域的用户帐户的密码。 此变量的值在 “密码” 和“ 确认密码 ”框中设置。 |
是 | 是 | 是 |
|
OSDNetworkJoinType 指定目标计算机是加入工作组还是域。 如果值设置为： - 0，然后选择 “域 ”选项，并将目标计算机加入域 - 1，然后选中 “工作组 ”选项，并将目标计算机加入工作组 |
否 | 是 | 否 |
|
SMSTSAssignUsersMode 指定用于在 Configuration Manager 中配置用户相关性的模式。 使用此变量可配置在 SMSTSUdaUsers 任务序列变量中的目标计算机和用户帐户之间创建相关性的行为。 如果在显示此页面之前未指定此变量，则此变量的值设置为 Pending。 此变量的可能值包括： - 自动。关联处理由Configuration Manager自动批准。 - 待定。相关性处理规则需要Configuration Manager管理员的批准。 - 禁用。 不会发生关联处理。 |
否 | 是 | 否 |
配置变量
表 33 列出了 ComputerPage 配置变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 33. ComputerPage 配置变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
ADComputerObjectCheck 指定 ComputerPage 向导页是否会验证提供的凭据是否具有在 AD DS 中修改计算机对象的相应权限，然后再继续下一个向导页。 注意： 如果 ADCredentialCheck 设置为 FALSE，则忽略此配置设置。 如果值设置为： - 如果为 TRUE，则会在 UDI 向导Designer的“域加入凭据”部分的向导页编辑器中选择“Active Directory 计算机对象检查检查”框，并且验证了修改凭据的计算机对象的权限 - FALSE，则“Active Directory 计算机对象检查检查”框在 UDI 向导Designer的“域加入凭据”部分的向导页编辑器中清除，并且不会验证修改凭据的计算机对象的权限 |
是 | 否 | 是 |
|
ADCredentialCheck 指定 ComputerPage 向导页是否会在继续下一个向导页之前验证为加入域而提供的凭据。 如果值设置为： - 如果为 TRUE，则会在 UDI 向导Designer的“域加入凭据”部分的向导页编辑器中选择“Active Directory 凭据检查检查”框，并验证凭据 如果此配置设置设置为 TRUE，则即使禁用凭据字段 (锁定) ，也会验证凭据。 - FALSE，则会在 UDI 向导Designer的“域加入凭据”部分的向导页编辑器中清除“Active Directory 凭据检查检查”框，并且凭据未验证 如果此配置设置设置为 FALSE，则 忽略 ADComputerObjectCheck 配置设置，并且不会执行提供的凭据是否可以修改 AD DS 中的计算机对象的验证。 |
是 | 否 | 是 |
|
UseExistingComputerName 指定 ComputerPage 向导页是否将使用目标计算机上的现有计算机名称作为计算机名称的默认值。 注意： 此检查框仅与“刷新计算机”部署方案相关。 如果值设置为： - 如果为 TRUE，则在 UDI 向导Designer的“计算机名称”部分的向导页编辑器中选择“使用现有计算机名检查”框，并且部署新作系统后，现有计算机名将用作目标计算机的默认计算机名称 - 如果为 FALSE，则会在 UDI 向导Designer的“计算机名称”部分的向导页编辑器中清除“使用现有计算机名检查”框，并且部署新作系统后，现有计算机名将不会用作目标计算机的默认计算机名称 |
是 | 否 | 是 |
ConfigScanPage
使用此向导页可以运行 UDI 任务，这些任务扫描目标计算机的配置，以确定目标计算机是否已准备好部署作系统映像。 此就绪情况包括拥有足够的系统资源和正确安装和配置的任何必备软件。 此外，还会运行其他 UDI 任务来收集有关目标计算机的配置信息，例如标识：
计算机是否连接到电源 (而不是使用电池运行)
计算机是否连接到有线网络连接 (而不是使用无线网络连接)
任何已安装的应用程序
任何已安装的打印机
LanguagePage
使用此向导页可以确定应安装的语言包、目标作系统的默认语言、键盘区域设置以及计算机所在的时区。
任务序列变量
表 34 列出了 LanguagePage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 34. LanguagePage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
InputLocale 指定目标作系统的输入区域设置。 在“ 时间和货币格式 ”框中设置此变量的值。 如果未指定，则使用映像中配置的输入区域设置。 |
是 | 是 | 是 |
|
KeyboardLocale 指定目标作系统的键盘区域设置。 在“ 键盘布局 ”框中设置此变量的值。 如果未指定，则使用映像中配置的键盘区域设置。 |
是 | 是 | 是 |
|
OSDTimeZone 指定目标计算机的物理位置所在的时区。 在“ 时区 ”框中设置此变量的值。 如果未指定，则使用映像中配置的时区。 |
是 | 是 | 是 |
|
UILanguage 指定要用于目标作系统的默认语言。 在“ 要安装的语言 ”框中设置此变量的值。 如果未指定，则使用映像中配置的语言。 |
是 | 是 | 是 |
ProgressPage
使用此向导页可以运行从目标计算机捕获用户状态迁移数据的 UDI 任务。 这些任务包括：
将应用程序发现文件复制到 UserStatePage 向导页上所选的位置
将打印机配置文件复制到 UserStatePage 向导页上所选的位置
将已安装的产品列表复制到 UserStatePage 向导页上所选的位置
运行 USMT 并将用户状态迁移数据保存到 UserStatePage 向导页上所选的位置
RebootPage
使用此向导页可通知用户目标计算机将重启。 可以使用 UDI 向导Designer配置通知消息。
SummaryPage
使用此向导页可通知用户在运行 UDI 向导时选择的配置选项。 此向导页上显示的配置信息会自动从其他向导页收集。 其他向导页上的某些字段允许使用 UDI 向导Designer配置在此向导页上显示的描述文字 (标签) 。
UDAPage
使用此向导页在目标计算机和指定用户之间配置 UDA。 将用户分配为计算机的主要用户允许自动安装部署到该用户的软件。 UDA 功能仅在 Configuration Manager 中可用，并且仅在新计算机部署方案中可用。
任务序列变量
表 35 列出了 UDAPage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 35. UDAPage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
SMSTSAssignUsersMode 指定用于在 Configuration Manager 中配置用户相关性的模式。 使用此变量可配置在 SMSTSUdaUsers 任务序列变量中的目标计算机和用户帐户之间创建相关性的行为。 若要设置此变量，请选择“使用用户设备相关性检查”框。 如果变量设置为： - 自动，然后由Configuration Manager自动批准关联处理 - 挂起，则关联处理规则将需要Configuration Manager管理员的批准 (这是选中“使用用户设备相关性检查”框时使用的值。) - 禁用，则不会发生关联处理 |
否 | 是 | 否 |
|
SMSTSUdaUsers 指定要与目标计算机关联的用户。 用户设备相关性帐户设置此变量。 此变量可以指定一个或多个用户， Domain\User1, Domain\User2格式为 。 |
是 | 是 | 是 |
UserStatePage
使用此向导页配置用于捕获或还原用户状态迁移数据的设置。 此向导页用于用户状态迁移数据捕获和还原。
UserStatePage 可以从本地连接到目标计算机的磁盘、附加到目标计算机的 U 盘或网络共享文件夹中捕获或还原用户状态迁移数据。 此外，可以选择不还原任何用户数据。 向导页背后的代码逻辑根据部署方案以及磁盘是否正在格式化，启用、禁用或自动选择以下每个选项：
无要还原的数据。 此选项指示没有要还原的用户状态迁移数据，并将 OSDUserStateMode 任务序列变量和 UserStateMode 变量设置为 NoData。
本地。 此选项指示用户状态迁移数据应存储在本地附加到目标计算机的磁盘上，并将 OSDUserStateMode 任务序列变量和 UserStateMode 变量设置为 Local。
USB。 此选项指示用户状态迁移数据应存储在本地连接到目标计算机的 USB 磁盘上，并将 OSDUserStateMode 任务序列变量和 UserStateMode 变量设置为 USB。
网络。 此选项指示用户状态迁移数据应存储在网络共享文件夹上，并将 OSDUserStateMode 任务序列变量和 UserStateMode 变量设置为 “网络”。
NEWCOMPUTER 阶段行为
NEWCOMPUTER 阶段用于不存在用户状态迁移数据的计算机。 新计算机部署方案可用作替换计算机部署方案的第二部分。 如果用户选择：
格式化目标计算机上的磁盘，然后 UserStatePage 假定本地硬盘上没有用户状态迁移数据，因此禁用 “本地 ”选项并启用所有其他选项
不格式化目标计算机上的磁盘，则 UserStatePage 假定存在要还原的用户状态迁移数据，并且禁用除 “本地 ”选项以外的所有选项 (使用 “本地 ”选项提供比 USB 或网络共享文件夹方法更快的用户状态迁移数据还原方法。)
表 36 列出了 NEWCOMPUTER 阶段的向导页上选项的行为。 “ 格式” 列指示目标硬盘是否要作为部署的一部分进行格式化。 其他列指示在加载 UserStatePage 时选项的配置。
表 36. NEWCOMPUTER 阶段的选项行为
| Format | NoData | Local | USB | 网络 |
|---|---|---|---|---|
| 是 | 已启用 | 已禁用 | 已启用 | 已启用 |
| 否 | Disabled | 已选中 | Disabled | Disabled |
NewComputer.预留阶段行为
NEWCOMPUTER。预留阶段基于 Configuration Manager 中的预留媒体功能。 由于本地硬盘是新的，因此没有要从本地硬盘还原的用户状态迁移数据，因此禁用了 “本地” 选项。 所有其他选项都对此部署方案有效，并且已启用。 未选择默认选项。
表 37 列出了 NewComputer.Prestaged 阶段的向导页上选项的行为。 “ 格式” 列指示目标硬盘是否要作为部署的一部分进行格式化。 其他列指示在加载 UserStatePage 时选项的配置。
表 37. NewComputer.Prestaged 阶段的选项行为
| Format | NoData | Local | USB | 网络 |
|---|---|---|---|---|
| 不适用 | 已启用 | 已禁用 | 已启用 | 已启用 |
REFRESH 阶段行为
刷新阶段是在完整的 Windows作系统中启动的，而不是 Windows PE。 如果用户选择：
格式化目标计算机上的磁盘，然后 UserStatePage 假定不会还原任何用户状态迁移数据，并且禁用除 NoData 选项以外的所有选项
不格式化目标计算机上的磁盘，则 UserStatePage 假定存在要还原的用户状态迁移数据，并且禁用除 “本地 ”选项以外的所有选项 (使用 “本地 ”选项提供比 USB 或网络共享文件夹方法更快的用户状态迁移数据还原方法。)
表 38 列出了“刷新”阶段的向导页上选项的行为。 “ 格式” 列指示目标硬盘是否要作为部署的一部分进行格式化。 其他列指示在加载 UserStatePage 时选项的配置。
表 38. REFRESH 阶段的选项行为
| Format | NoData | Local | USB | 网络 |
|---|---|---|---|---|
| 是 | 已选中 | Disabled | Disabled | Disabled |
| 否 | Disabled | 已选中 | Disabled | Disabled |
取代。WinPE 阶段行为
REPLACE。WinPE 阶段从现有 (旧) 计算机捕获用户状态迁移数据，然后使用新计算机部署方案之一还原用户状态迁移数据。 由于部署涉及两台不同的计算机，因此必须将用户状态迁移数据保存到 U 盘或网络共享文件夹。 无法将用户状态迁移数据保存到本地磁盘。
表 39 列出了 REPLACE 的向导页上选项的行为。WinPE 阶段。 “ 格式” 列指示目标硬盘是否要作为部署的一部分进行格式化。 其他列指示在加载 UserStatePage 时选项的配置。
表 39. REPLACE 选项的行为。WinPE 阶段
| Format | NoData | Local | USB | 网络 |
|---|---|---|---|---|
| 不适用 | Disabled | 已禁用 | 已启用 | 已启用 |
任务序列变量
表 40 列出了 UserStatePage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 40. UserStatePage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
_SMSTsInWinPE 指定 UDI 向导是否在 Windows PE 中运行。 如果变量设置为： - TRUE，则 UDI 向导在 Windows PE 中运行 - FALSE，则 UDI 向导不在 Windows PE 中运行，而是在完整的 Windows作系统中运行 |
是 | 否 | 否 |
|
OSDDataSourceDirectory 指定存储用户状态迁移数据的目录。 |
否 | 是 | 否 |
|
OSDDataSourceDrive 指定用于捕获和还原用户状态迁移数据的 USB 驱动器，从“ USB 目标驱动器 ”框中选择这些数据。 如果在显示向导页之前设置了变量，则变量的值将用作默认值。 |
是 | 是 | 否 |
|
OSDDiskPart 指定是否应格式化和分区为目标作系统安装选择的驱动器。 在 VolumePage 向导页上设置此变量，此向导页上的代码使用该变量来确定默认选择和启用的选项。 有关详细信息，请参阅 UserStatePage。 |
是 | 否 | 是 |
|
OSDHardLinks 指定是捕获到本地驱动器还是从本地驱动器还原用户状态迁移数据。 如果变量设置为： - 如果为 TRUE，则选择了 “本地 ”选项，并且将从附加到目标计算机的本地驱动器捕获或还原用户状态迁移数据 - FALSE，则未选择 “本地 ”选项，并且不会从附加到目标计算机的本地驱动器捕获或还原任何用户状态迁移数据 |
否 | 是 | 否 |
|
OSDRestoreData 指定是否有要还原的数据。 如果变量设置为： - 如果为 TRUE，则选择了 “本地”、“ USB 目标驱动器”或“ 网络 ”选项，并且将从目标计算机捕获或还原用户状态迁移数据 - FALSE，则选中“ 没有要还原的数据” 选项，并且不会从目标计算机捕获或还原任何用户状态迁移数据 |
否 | 是 | 否 |
|
OSDUserStateKey 指定用于保护用户状态迁移数据的用户名。 捕获用户状态迁移数据时提供用户名。 还原用户状态迁移数据时，必须提供相同的用户名和密码。 在“ 用户名 ”框中设置此变量的值。 |
是 | 是 | 是 |
|
OSDUserStateKeyPassword 指定用于保护用户状态迁移数据的用户名的密码。 在“ 密码 ”和“ 确认密码 ”框中设置此变量的值。 |
是 | 是 | 是 |
|
OSDUserStateMode 指定用于捕获或还原用户状态迁移数据的模式 (方法) 。 此变量的值由所选选项设置。 如果变量设置为： - NoData，然后选择了“ 没有要还原的数据” 选项，并且不会捕获或还原任何用户状态迁移数据 - “本地”，然后选择了“ 本地 ”选项，并且将从目标计算机上的本地硬盘捕获或还原用户状态迁移数据 - 网络，然后选择了 “网络 ”选项，用户状态 迁移 数据将捕获到网络共享文件夹或从网络共享文件夹还原 - 在捕获模式下使用时，此选项基于用户名和密码的哈希创建一个文件夹，以便保护用户状态迁移数据的标识。 还原用户状态迁移数据时必须使用完全相同的用户名和密码，以便向导页能够准确找到文件夹。 - USB，然后选择了 “USB 目标驱动器 ”选项，用户状态迁移数据将捕获到物理连接到目标计算机的 USB 驱动器或从该 U 盘还原 - U 盘的向导页行为也受 Format、 FormatPrompt 和 MinimumDriveSize 变量的影响。 |
否 | 是 | 否 |
|
SMSConnectNetworkFolderPath 指定用于捕获和还原用户状态迁移数据的网络共享文件夹，该数据是从“ 网络 ”框中选择的。 “网络”框显示网络共享文件夹的用户友好名称，该名称在 UDI 向导Designer向导页编辑器的“网络组合框”部分的“网络共享”框中配置。 如果在显示向导页之前设置了变量，则变量的值将用作默认值。 |
是 | 是 | 是 |
内存变量
表 41 列出了 UserStatePage 内存变量及其说明以及该变量是由向导页读取还是写入的。
表 41. UserStatePage 内存变量
| "变量" | Read | Write |
|---|---|---|
|
DriveLetter 指定在向导页上的“USB 目标驱动器”框中选择的 USB 驱动器的驱动器 号。 此变量的值将是驱动器号，包括冒号 (：) 后缀，如 M：。 |
否 | 是 |
|
TargetDrive 指定在向导页上的“USB 目标驱动器”框中为目标计算机上所选的 USB 驱动器显示的描述文字。 此变量的值将类似于以下示例： M: VendorA Ultra TD v1.0 USB Device (74.5 GB) |
否 | 是 |
|
UserStateMode 指定使用向导页上的选项选择的选项，并将其设置为与 OSDUserStateMode 变量相同的值。 此变量的有效值包括： - NoData，指示已选择“ 无要还原的数据” 选项 - Local，指示已选择“ 本地” 选项 - USB，指示已选择 USB 目标驱动器 选项 - “网络”，指示选择了“ 网络 ”选项 |
否 | 是 |
配置变量
表 42 列出了 UserStatePage 配置变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 42. UserStatePage 配置变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
DataSourceText 指定一条信息性消息，指示执行用户状态捕获或还原的用户如何使用向导页。 可以在 UDI 向导Designer向导分页编辑器的“消息”部分中的“指令文本”框中设置此变量的值。 |
是 | 否 | 是 |
|
Format 指定在捕获用户状态迁移数据之前，是否应为捕获目标计算机上的用户状态而选择的 U 盘进行分区和格式化。 通过在 UDI 向导Designer的分页编辑器上的“USB 组合框”部分选择“捕获 检查前格式化 U 盘”框来设置此变量的值。 如果变量设置为： - 如果为 TRUE，则在捕获用户状态迁移数据之前格式化驱动器 - FALSE，则不会在捕获用户状态迁移数据之前格式化驱动器 |
是 | 否 | 是 |
|
FormatPrompt 指定用户在执行捕获之前是否必须确认用于捕获用户状态迁移数据的 U 盘的格式。 通过在 UDI 向导的分页编辑器 检查Designer的“USB 组合框”部分选择“在格式化目标驱动器之前提示用户”框来设置此变量的值。 注意： 仅当 OSDUserStateMode 任务序列变量设置为 USB 时，此变量才有效。 |
是 | 否 | 是 |
|
MinimumDriveSize 指定驱动器可用于存储用户状态迁移数据所需的最小可用磁盘空间（以 GB 为单位）。 此变量的值充当筛选器，可在 UDI 向导Designer的分页编辑器的 USB 组合框部分的“最小驱动器大小”文本框中对其进行设置。 |
是 | 否 | 是 |
|
NetworkDrive 指定此向导页用于映射到 SMSConnectNetworkFolderPath 任务序列变量中的网络共享文件夹的驱动器号。 网络共享文件夹映射用于捕获或还原用户状态迁移数据。 在 UDI 向导Designer的向导分页编辑器的“网络组合框”部分的“映射驱动器号”框中设置此变量的值。 指定的驱动器号必须包括驱动器号后面的冒号 (：) ，并且不能在目标计算机上使用。 例如，如果目标计算机具有驱动器 C： 和 D：，则 C： 和 D： 不能用于此变量。 注意： 仅当 OSDUserStateMode 任务序列变量设置为 “网络”时，此变量才有效。 |
是 | 否 | 是 |
|
状态 指定向导页是否用于捕获或还原用户状态迁移数据。 在 UDI 向导Designer的向导分页编辑器的“捕获/还原位置”部分中的“捕获”或“还原”框中设置此变量的值。 如果变量设置为： - 捕获，然后使用向导页捕获用户状态迁移数据 - 还原，然后使用向导页还原用户状态迁移数据 |
是 | 否 | 是 |
VolumePage
使用此向导页可在将部署作系统的目标计算机上配置磁盘卷的设置。 这些设置包括选择目标作系统、选择目标驱动器、选择任何 Windows 安装，以及确定是否应在部署过程中格式化目标驱动器。
任务序列变量
表 43 列出了 VolumePage 任务序列变量以及该变量是由向导页读取的、由向导页编写的，还是可以在 UDI 向导配置文件中配置。
表 43. VolumePage 任务序列变量
| "变量" | Read | Write | Config |
|---|---|---|---|
|
OSDDiskPart 指定在捕获用户状态迁移数据之前，是否应为在目标计算机上部署目标作系统而选择的驱动器进行分区和格式化。 此变量的值由向导页上的以下检查框之一设置： - 清理所选卷。当 UDI 向导在完整的 Windows作系统中运行时，将显示此检查框。 可以使用 UDI 向导配置文件中的向导页的 FormatFullOS setter 属性配置文本消息。 - 对磁盘 0 进行分区和格式化。当 UDI 向导在 Windows PE 中运行时，将显示此检查框。 可以使用 UDI 向导配置文件中的向导页的 FormatWinPE setter 属性配置文本消息。 UserStatePage 向导页背后的代码逻辑使用此变量来确定默认选择和启用的选项。 如果变量设置为： - 如果为 TRUE，则在部署目标作系统之前对驱动器进行分区和格式化 - FALSE，则在部署目标作系统之前未对驱动器进行分区和格式化 |
是 | 是 | 是 |
|
OSDImageIndex 指定 .wim 文件中作系统映像的数字索引，该文件在“ 图像选择” 组合框中选中。 在 VolumePage 向导页编辑器的“映像组合框”部分的“映像组合框值”框中，在“映像选择”框中配置可能的作系统映像列表。 图像索引配置为“ 图像组合框值 ”列表中的每个图像的一部分。 |
是 | 是 | 是 |
|
OSDImageName 指定 .wim 文件中作系统映像的名称，该文件在“ 图像选择 ”框中选中。 “映像选择”组合框中可能的作系统映像列表是在 VolumePage 向导页面编辑器的“图像组合框”部分的“图像组合框值”列表中配置的。 映像名称配置为“ 图像组合框值 ”列表中的每个图像的一部分。 |
否 | 是 | 否 |
|
OSDTargetDrive 指定向导页上的“ 卷 ”框中所选卷的驱动器号。 此变量的值将是驱动器号，包括冒号 (：) 后缀，例如 C：。 |
否 | 是 | 否 |
|
OSDWinPEWindir 指定目标计算机上现有 Windows 安装的位置。 在向导页上的 “Windows 目录 ”框中设置此变量的值。 |
否 | 是 | 否 |
内存变量
表 44 列出了 VolumePage 内存变量以及向导页是读取还是写入该变量的说明。
表 44. VolumePage 内存变量
| "变量" | Read | Write |
|---|---|---|
|
VolumeArchitecture 指定要部署的作系统的处理器体系结构，该体系结构在“ 映像选择 ”框中选中。 VolumeArchitecture 向导页使用此变量来筛选该页上显示的应用程序的体系结构。 例如，如果要部署 32 位作系统，则 VolumeArchitecture 向导页将从可用应用程序列表中删除 (筛选器) 任何 64 位应用程序。 如果变量设置为： - x86，随后选择了 32 位作系统 - amd64，随后选择了 64 位作系统 |
否 | 是 |
WelcomePage
使用此向导页可向用户提供有关 UDI 向导和部署过程的信息。 可以使用 UDI 向导Designer配置通知消息。
UDI 生成自己的页面工具箱控件参考
UDI 中的“生成自己的页面”功能允许你创建自定义向导页，可用于收集其他部署信息，以便在 UDI 中使用。 可以使用以下命令创建自定义向导页：
生成自己的页面功能。 借助此功能，可以创建自定义向导页来收集部署信息，而无需编写代码或具备开发人员技能。 如果需要在没有高级用户交互的情况下收集基本信息，请使用此功能。 例如，无法使用此功能添加任何代码或自定义 UI 字体。
UDI SDK 和 Visual Studio。 如果要在 Visual Studio 中创建一个完全自定义的高级向导页来收集部署信息，请使用此 SDK。 尽管 UDI SDK 允许创建自定义向导页（例如添加自定义代码或更改字体），但此方法需要开发人员技能。
有关使用 UDI SDK 创建自定义向导页的详细信息，请参阅 用户驱动器安装开发人员指南中的“创建自定义 UDI 向导页”。
“生成自己的页面”功能包括一个控件工具箱，你可以从“生成自己的页面”工具箱添加到自定义向导页，当你在 UDI 向导Designer的“配置”选项卡上查看自定义向导页时，会显示该工具箱。
表 45 列出了自定义向导页的控件类型，如图 5 所示。 从属部分将进一步详细讨论这些控件中的每一个。
表 45. UDI 生成自己的页面工具箱中的控件类型
| 控件类型 | 说明 |
|---|---|
| 复选框控件 | 此控件允许你选择或清除配置选项，并充当传统的 UI 检查 框。 |
| 组合框控件 | 此控件允许你从项列表中选择一个项，并充当传统的 UI 下拉列表。 |
| 线条控件 | 此控件允许添加水平线，以将自定义向导页的一部分与另一部分分开。 |
| Label 控件 | 此控件允许向向导页添加描述性只读文本。 |
| 无线电控制 | 此控件允许你从一组两个或多个选项中选择一个配置选项。 |
| 位图控件 | 此控件允许将位图图形 (.bmp 文件) 添加到自定义向导页。 |
| 文本框控件 | 此控件允许你在自定义向导页上输入文本。 |
可以根据要收集的信息将这些控件的任意组合添加到自定义向导页。 此外，可以使用“显示网格线检查”框来显示或隐藏网格线，这些网格线可用于帮助直观地设计自定义向导页。
图 5 提供了自定义向导页和“生成自己的页面”工具箱的示例。
图 SEQ 图 \* 阿拉伯文 5。 自定义向导页示例
复选框控件
此控件允许你选择或清除配置选项，并充当传统的 UI 检查 框。 此控件具有相应的标签，可用于描述检查框的用途。 选中“检查”框时，此控件的状态为 True，清除检查框时为 False。 检查框的状态存储在为此控件配置的任务序列变量中。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 46 列出了 复选框 控件的布局属性，并提供了每个属性的简要说明
表 46. 复选框控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Label | 使用此属性可配置与“检查”框关联的描述性文本。 |
| Width | 使用此属性可配置控件的宽度。 注意 如果在 Label 属性中输入的文本长于控件的宽度，则文本将被剪裁且不显示。 |
| Height | 使用此属性可配置控件的高度。 注意 如果在 Label 属性中输入的文本高于控件的高度，则会剪裁文本。 |
设置属性
设置属性用于配置最初显示在控件中的数据， (默认值) 以及从用户那里收集的信息的保存位置。 表 47 列出了 复选框 控件的设置属性，并提供了每个属性的简要说明。
表 47. 复选框控件设置属性
| 属性 | 说明 |
|---|---|
| 默认值 | 使用此属性可配置控件的默认值。 对于检查框，默认值为 False。 |
| 任务序列变量名称 | 使用此属性可配置任务序列变量，其中存储了从用户收集的信息。 如果任务序列变量： - 尚不存在，任务序列变量已创建并设置为用户提供的值 - 已存在，任务序列变量的现有值将被用户提供的值覆盖 |
| 摘要页中可见的友好显示名称 | 使用此属性可配置显示在 “摘要 ”向导页上的描述性名称。 此名称用于描述此控件的 任务序列变量名称 属性中保存的值。 |
| 解 锁 | 使用此属性可配置用户是否能够与控件交互。 默认情况下，控件处于启用状态。 此按钮显示以下状态： - 解 锁。 控件已启用，用户可以使用它输入信息。 - 锁。 控件已禁用，用户无法使用它输入信息。 注意 如果禁用) 控件 (锁，则必须通过在 CustomSettings.ini 或 MDT DB 中配置 MDT 属性来提供控件收集的信息。 否则，UDI 向导不会收集必要的信息，并且 UDI 部署将失败。 |
组合框控件
此控件允许你从项列表中选择一个项，并充当传统的 UI 下拉列表。 此控件允许你在列表中添加或删除项，并提供将在为此控件配置的任务序列变量中设置的相应值。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 48 列出了 Combobox 控件的布局属性，并提供了每个属性的简要说明。
表 48. 组合框控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Width | 使用此属性可配置控件的宽度。 注意 如果在控件中输入的文本长于控件的宽度，则不显示文本。 |
| Height | 使用此属性可配置控件的高度。 注意 如果在控件中输入的文本高于控件的高度，则会剪裁文本。 |
| 数据项 | 使用此属性可配置控件中显示的数据项列表。 每个数据项具有以下属性： - 价值。 选择数据项时存储在任务序列变量中的值 - DisplayValue。 在 控件中向用户显示的值 可以执行下列操作： - 立即在数据项列表右侧使用蓝色加号按钮向列表添加数据项 - 立即使用数据项列表右侧的红色 X 按钮从列表中删除数据项 注意 在将项添加到列表中后，无法更改列表中数据项的顺序。 确保按希望在控件中显示的顺序输入数据项。 |
设置属性
设置属性用于配置最初显示在控件中的数据， (默认值) 以及从用户那里收集的信息的保存位置。 表 49 列出了 Combobox 控件的设置属性，并提供了每个属性的简要说明。
表 49. 组合框控件设置属性
| 属性 | 说明 |
|---|---|
| 任务序列变量名称 | 使用此属性可配置任务序列变量，其中存储了从用户收集的信息。 如果任务序列变量： - 尚不存在，任务序列变量已创建并设置为用户提供的值 - 已存在，任务序列变量的现有值将被用户提供的值覆盖 |
| 摘要页中可见的友好显示名称 | 使用此属性可配置显示在 “摘要 ”向导页上的描述性名称。 此名称用于描述此控件的 任务序列变量名称 属性中保存的值。 |
| 解 锁 | 使用此属性可配置用户是否能够与控件交互。 默认情况下，控件处于启用状态。 此按钮显示以下状态： - 解 锁。 控件已启用，用户可以使用它输入信息。 - 锁。 控件已禁用，用户无法使用它输入信息。 注意 如果禁用) 控件 (锁，则必须通过在 CustomSettings.ini 或 MDT DB 中配置 MDT 属性来提供控件收集的信息。 否则，UDI 向导不会收集必要的信息，并且 UDI 部署将失败。 |
线条控件
此控件允许添加水平线，以将自定义向导页的一部分与另一部分分开。 此控件不收集任何配置值，而是用于直观地增强 UI。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 50 列出了 Line 控件的布局属性，并提供了每个属性的简要说明。
表 50. 线条控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Width | 使用此属性可配置控件的宽度。 |
| Height | 使用此属性可配置控件的高度。 注意 增加此属性不会增加线条的高度或宽度。 |
设置属性
Line 控件没有设置属性。
标签控件
此控件允许向向导页添加描述性只读文本。 此控件不收集任何配置值，而是用于直观地增强 UI。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 51 列出了 Label 控件的布局属性，并提供了每个属性的简要说明。
表 51. 标签控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Label | 使用此属性可配置与此控件关联的描述性文本。 |
| Width | 使用此属性可配置控件的宽度。 注意 如果在 Label 属性中输入的文本长于控件的宽度，则文本将被剪裁且不显示。 |
| Height | 使用此属性可配置控件的高度。 注意 如果在 Label 属性中输入的文本高于控件的高度，则会剪裁文本。 |
设置属性
Label 控件没有设置属性。
无线电控制
此控件允许你从一组两个或多个选项中选择一个选项。 与传统单选按钮一样，可以对这些控件中的两个或多个进行分组：然后，用户可以选择组中的选项之一。
将为每个单选按钮分配唯一值。 分配给所选单选按钮控件的值保存在为此控件配置的任务序列变量中。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 52 列出了 Radio 控件的布局属性，并提供了每个属性的简要说明。
表 52. 单选控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Label | 使用此属性可配置与单选按钮关联的描述性文本。 |
| Width | 使用此属性可配置控件的宽度。 注意 如果在 Label 属性中输入的文本长于控件的宽度，则文本将被剪裁且不显示。 |
| Height | 使用此属性可配置控件的高度。 注意 如果在 Label 属性中输入的文本高于控件的高度，则会剪裁文本。 |
| RadioGroup | 使用此属性对两个或多个单选按钮进行分组。 当单选按钮属于同一组时，只能选择组中的一个单选按钮。 如果需要多个单选按钮组，请为每个各自的单选按钮组配置此属性。 |
| 值 | 在选择单选按钮时，使用此属性配置任务序列变量中存储的值。 |
设置属性
设置属性用于配置最初显示在控件中的数据， (默认值) 以及从用户那里收集的信息的保存位置。 表 53 列出了 单选 控件的设置属性，并提供了每个属性的简要说明。
表 53. 无线电控制设置属性
| 属性 | 说明 |
|---|---|
| 默认值 | 使用此属性可配置控件的默认值。 默认情况下，该值设置为控件 ID。 |
| 任务序列变量名称 | 使用此属性可配置任务序列变量，其中存储了从用户收集的信息。 如果任务序列变量： - 尚不存在，任务序列变量已创建并设置为用户提供的值 - 已存在，任务序列变量的现有值将被用户提供的值覆盖 |
| 摘要页中可见的友好显示名称 | 使用此属性可配置显示在 “摘要 ”向导页上的描述性名称。 此名称用于描述此控件的 任务序列变量名称 属性中保存的值。 |
| 解 锁 | 使用此属性可配置用户是否能够与控件交互。 默认情况下，控件处于启用状态。 此按钮显示以下状态： - 解 锁。 控件已启用，用户可以使用它输入信息。 - 锁。 控件已禁用，用户无法使用它输入信息。 注意 如果禁用) 控件 (锁，则必须通过在 CustomSettings.ini 或 MDT DB 中配置 MDT 属性来提供控件收集的信息。 否则，UDI 向导不会收集必要的信息，并且 UDI 部署将失败。 |
位图控件
此控件允许将位图图形 (.bmp 文件) 添加到自定义向导页。 此控件不收集任何配置值，而是用于直观地增强 UI。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 54 列出了 Bitmap 控件的布局属性，并提供了每个属性的简要说明。
表 54. 位图控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Width | 使用此属性可配置控件的宽度。 注意 如果在 Source 属性中选择的图形长于控件的宽度，则会剪裁图形。 |
| Height | 使用此属性可配置控件的高度。 注意 如果在 Source 属性中选择的图形高于控件的高度，则会剪裁图形。 |
| Source | 使用此属性可配置 .bmp 文件的完全限定路径，包括文件名。 .bmp 文件的路径相对于 UDI 向导 (OSDSetupWizard.exe) 的位置，该位置位于以下文件夹之一 (其中mdt_tookit_package是Configuration Manager) 中 MDT 工具包包的位置： - mdt_tookit_package\Tools\x86 - mdt_tookit_package\Tools\x64 若要在预览自定义向导页时查看图形，.bmp 文件还必须位于以下文件夹中， (其中 mdt_install_folder 是安装 MDT) 的文件夹： - mdt_install_folder\Template\Distribution\Tools\x86 - mdt_install_folder \Template\Distribution\Tools\x64 |
设置属性
Bitmap 控件没有设置属性。
文本框控件
此控件允许你在自定义向导页上输入文本。 在此控件中键入的文本保存在为此控件配置的任务序列变量中。
布局属性
布局属性用于配置控件的 UI 特征，并在 UDI 向导Designer的“布局”选项卡上配置。 表 55 列出了 Textbox 控件的布局属性，并提供了每个属性的简要说明。
表 55. 文本框控件布局属性
| 属性 | 说明 |
|---|---|
| X | 使用此属性可配置控件的水平位置。 |
| Y | 使用此属性可配置控件的垂直位置。 |
| Width | 使用此属性可配置控件的宽度。 注意 如果控件中输入的文本长于控件的宽度，则文本将被剪裁且不显示。 |
| Height | 使用此属性可配置控件的高度。 注意 如果在控件中输入的文本高于控件的高度，则会剪裁文本。 |
设置属性
设置属性用于配置最初显示在控件中的数据， (默认值) 以及从用户那里收集的信息的保存位置。 表 56 列出了 Textbox 控件的设置属性，并提供了每个属性的简要说明
表 56. 文本框控件设置属性
| 属性 | 说明 |
|---|---|
| 默认值 | 使用此属性可配置控件的默认值。 |
| 任务序列变量名称 | 使用此属性可配置任务序列变量，其中存储了从用户收集的信息。 如果任务序列变量： - 尚不存在，任务序列变量已创建并设置为用户提供的值 - 已存在，任务序列变量的现有值将被用户提供的值覆盖 |
| 摘要页中可见的友好显示名称 | 使用此属性可配置显示在 “摘要 ”向导页上的描述性名称。 此名称用于描述此控件的 任务序列变量名称 属性中保存的值。 |
| 分配给此控件的验证程序列表 | 此属性包含用于验证在文本框中输入的内容的验证程序列表。 可以执行下列操作： - 立即在验证程序列表右侧使用蓝色加号按钮将验证程序添加到列表中 - 立即使用验证程序列表右侧的铅笔按钮编辑列表中的验证程序 - 立即使用验证程序列表右侧的红色 X 按钮从列表中删除验证程序 |
| 解 锁 | 使用此属性可配置用户是否能够与控件交互。 默认情况下，控件处于启用状态。 此按钮显示以下状态： - 解 锁。 控件已启用，用户可以使用它输入信息。 - 锁。 控件已禁用，用户无法使用它输入信息。 注意： 注意 如果禁用) 控件 (锁，则必须通过在 CustomSettings.ini 或 MDT DB 中配置 MDT 属性来提供控件收集的信息。 否则，UDI 向导不会收集必要的信息，并且 UDI 部署将失败。 |
UDI 任务序列变量
本部分中的任务序列变量仅在 User-Driven 安装 (UDI) 部署中使用。 除了这些任务序列变量之外，UDI 还使用以下 ZTI 任务序列变量，并在本指南前面的相应部分中进行了介绍：
OSDAddAdmin
此任务序列变量指定要添加到目标计算机上的 Administrators 本地内置组的基于域的帐户或本地帐户的列表。
| 值 | 说明 |
|---|---|
| domain\account_name1;computer\account_name2 | 要成为目标计算机上的 Administrators 组成员的帐户的格式，格式为 domain\account ，并用分号分隔，其中 域 可以是 Active Directory 域的名称或目标计算机名称。 |
| 示例 |
|---|
OSDAddAdmin=domain\user01;Win7-01\LocalUser01 |
OSDApplicationList
此任务序列变量指定默认情况下应在作系统部署 (OSD) 安装向导的 “安装软件 ”页上选择哪些应用程序。
| 值 | 说明 |
|---|---|
| app_id1;app_id2 | 在作系统部署 (OSD) 安装向导的 “安装软件 ”页上默认选择的以分号分隔的应用程序列表;每个应用程序由应用程序 ID 表示，并用分号分隔。 应用程序 ID 派生自 UDIWizard_Config.xml 文件中每个应用程序的 Id 属性。 在 UDIWizard_Config.xml 文件的以下摘录中，带有 SP2 应用程序的 2007 Microsoft Office 系统的 Id 属性为 1：<Application DisplayName="Office 2007 SP2" State="Disabled" Id="1"> |
| 示例 |
|---|
OSDApplicationList=2;3 |
OSDArchitecture
此任务序列变量指定要部署的目标作系统的处理器体系结构。
| 值 | 说明 |
|---|---|
| x86 | 目标作系统是 32 位作系统。 |
| amd64 | 目标作系统是 64 位作系统。 |
| 示例 |
|---|
OSDArchitecture=amd64 |
OSDBitlockerStatus
此任务序列变量指定 BitLocker 预检检查是否在目标计算机上启用 BitLocker。
| 值 | 说明 |
|---|---|
| 保护 | 目标计算机已启用 BitLocker。 |
| 不存在 | 如果目标计算机未启用 BitLocker，则任务序列变量不存在。 |
| 示例 |
|---|
| None |
OSDDiskPart
此任务序列变量指定是否应格式化目标磁盘分区。
| 值 | 说明 |
|---|---|
| 真 | 将格式化目标磁盘分区。 |
| 假 | 不会格式化目标磁盘分区。 |
| 示例 |
|---|
OSDDiskPart=TRUE |
OSDDomainName
此任务序列变量指定目标计算机将加入的域的名称（如果计算机配置为域成员）。
| 值 | 说明 |
|---|---|
| domain_name | 目标计算机将加入到的域的名称。 如果已将作系统部署 (OSD) 安装向导中的“计算机”向导页配置为“静默”，则此任务序列变量中的值必须与 UDI 向导Designer中指定的值匹配。 否则，将显示向导页。 注意： 只有在 OU 中创建新的计算机帐户时，才需要此任务序列变量。 如果计算机帐户已存在，则不需要此变量。 |
| 示例 |
|---|
OSDDomainName=domain01 |
OSDDomainOUName
此任务序列变量指定当计算机加入域时，目标计算机帐户将创建到的域中 OU 的名称。
| 值 | 说明 |
|---|---|
| ou_name | 将在其中创建计算机帐户的域中 OU 的名称 注意： 只有在 OU 中创建新的计算机帐户时，才需要此任务序列变量。 如果计算机帐户已存在，则不需要此变量。 |
| 示例 |
|---|
OSDDomainOUName=NewDeployOU |
OSDImageIndex
此任务序列变量指定 WIM 文件中目标作系统的索引号。
| 值 | 说明 |
|---|---|
| index_number | 目标索引号，以 WIM 文件中第一个作系统的索引号 1 开头 |
| 示例 |
|---|
OSDImageIndex=1 |
OSDImageName
此任务序列变量指定在 VolumePage 向导页上的“映像选择”框中选择的 .wim 文件中的作系统映像的名称。 “图像选择”框中可能的作系统映像列表是在 VolumePage 向导页编辑器的“映像组合框”部分的“图像组合框值”列表中配置的。 映像名称配置为“ 图像组合框值 ”列表中的每个图像的一部分。
注意
注意 此任务序列变量由 VolumePage 向导设置，不应在 CustomSettings.ini 文件或 MDT DB 中配置。 但是，此任务序列变量可用于设置任务序列步骤的条件，如 MDT 文档中 使用 Microsoft Deployment Toolkit 中的“配置 UDI 任务序列以部署不同的作系统”部分中所述。
| 值 | 说明 |
|---|---|
| image_name | 在 VolumePage 向导页上的“映像选择”框中选择的 .wim 文件中作系统映像的名称 |
| 示例 |
|---|
| None |
OSDJoinAccount
此任务序列变量指定用于将目标计算机加入 OSDDomainName 任务序列变量中指定的域的基于域的帐户。 如果目标计算机将加入域，则此任务序列变量是必需的。
| 值 | 说明 |
|---|---|
| account_name | 用于将目标计算机加入域的帐户名称，格式为 domain\account |
| 示例 |
|---|
OSDJoinAccount=domain\admin01 |
OSDJoinPassword
此任务序列变量指定用于将目标计算机加入 OSDJoinAccount 任务序列变量中指定的域的基于域的帐户的密码。 如果目标计算机将加入域，则此任务序列变量是必需的。
| 值 | 说明 |
|---|---|
| password | 用于加入域的帐户的密码 |
| 示例 |
|---|
OSDJoinPassword=P@ssw0rd10 |
OSDLocalAdminPassword
此任务序列变量指定目标计算机上的管理员本地内置帐户的密码。
| 值 | 说明 |
|---|---|
| password | 目标计算机上的管理员本地内置帐户的密码 |
| 示例 |
|---|
OSDLocalAdminPassword=P@ssw0rd10 |
OSDNetworkJoinType
此任务序列变量指定目标计算机是加入域还是加入工作组。
| 值 | 说明 |
|---|---|
| 0 | 目标计算机将加入域。 如果选择此选项并将相应的作系统部署 (OSD) 安装向导页配置为 “静默”，则还必须相应地为 OSDJoinAccount、 OSDJoinPassword、 OSDDomainName 和 OSDDomainOUName 任务序列变量提供值。 此外，必须在 UDI 向导Designer计算机页上的“工作区”窗格中选择“默认选择”中的域。 |
| 1 | 目标计算机将加入工作组。 如果选择此选项并将相应的作系统部署 (OSD) 安装向导页配置为 “无提示”，则还必须为 OSDWorkgroupName 任务序列变量提供值。 此外，还必须在 UDI 向导Designer的“计算机”页上的“工作区”窗格中选择“默认选择”中的“工作组”。 |
| 示例 |
|---|
OSDNetworkJoinType=0 |
OSDSetupWizCancelled
此任务序列变量指定用户是否取消了作系统部署 (OSD) 安装向导。
| 值 | 说明 |
|---|---|
| 真 | 用户取消了作系统部署 (OSD) 安装向导。 |
| 不存在 | 如果未取消向导，则任务序列变量不存在。 |
| 示例 |
|---|
| None |
OSDTargetDrive
此任务序列变量指定将部署目标作系统的磁盘卷。
| 值 | 说明 |
|---|---|
| disk_volume | 磁盘卷指定 |
| 示例 |
|---|
OSDTargetDrive=C: |
OSDWinPEWinDir
此任务序列变量指定目标计算机上当前安装 Windows作系统的文件夹。
| 值 | 说明 |
|---|---|
| windows_directory | 当前安装 Windows作系统的目录 |
| 示例 |
|---|
OSDWinPEWinDir=C:\Windows |
OSDWorkgroupName
此任务序列变量指定目标计算机将加入的工作组的名称（如果计算机配置为工作组成员）。
| 值 | 说明 |
|---|---|
| workgroup_name | 目标计算机将加入到的工作组的名称 |
| 示例 |
|---|
OSDWorkgroupName=WORKGROUP01 |
OSDResults.exe.config 文件元素值
OSD 结果程序（OSDResults.exe）在 UDI 部署结束时运行，并显示部署过程的结果。 可以通过修改 OSDResults.exe.config 文件元素值来自定义 OSD 结果程序的行为。 OSDResults.exe.config 文件存储在用户驱动器安装任务序列中的 MDT 包的 Tools\OSDResults 中。
backgroundOpacity
此 XML 元素将背景壁纸图像的不透明性配置为 backgroundWallpaper 元素中指定为十进制格式的百分比。
| 值 | 说明 |
|---|---|
| opacity_percent | 以十进制格式百分比指定的 backgroundWallpaper 元素的不透明百分比，例如， 值 0.8 指定 80% 的不透明度。 |
| 示例 |
|---|
<add key="backgroundOpacity" value="0.8"/> |
backgroundWallpaper
此 XML 元素提供在 OSD 结果 对话框中显示为背景的图像的文件名和相对路径。 路径相对于 MDT 包中的 Tools\OSDResults 文件夹。
| 值 | 说明 |
|---|---|
| path\\file_name | 包括背景图像的相对路径和文件名;路径用 //) (双正斜杠分隔。 |
| 示例 |
|---|
<add key="backgroundWallpaper" value="images\\Wallpaper.jpg"/> |
completedText
此 XML 元素提供部署完成后， OSD 结果 对话框中显示的文本。
| 值 | 说明 |
|---|---|
| text | 部署完成后，将在 OSD 结果 对话框中以引号显示的文本 |
| 示例 |
|---|
<add key="completedText" value="Deployment Complete"/> |
headerImagePath
此 XML 元素提供“ OSD 结果 ”对话框标头中显示的图像的文件名和相对路径。 路径相对于 MDT 包中的 Tools\OSDResults 文件夹。
| 值 | 说明 |
|---|---|
| path\\file_name | 包括标头图像的相对路径和文件名;路径用双反斜杠分隔 (\\) 。 |
| 示例 |
|---|
<add key="headerImagePath" value="images\\Windows7_h_rgb.png"/> |
timeoutMinutes
此 XML 元素配置在自动关闭对话框和重新启动计算机之前显示 OSD 结果 对话框的分钟数。
| 值 | 说明 |
|---|---|
| 非数值 | 在选择 “启动 Windows” 之前，该对话框将保持打开状态。 |
| 负值 | 在选择 “启动 Windows” 之前，该对话框将保持打开状态。 |
| 0 | 在选择 “启动 Windows” 之前，该对话框将保持打开状态。 |
| 包括小数点 | 在选择 “启动 Windows” 之前，该对话框将保持打开状态。 |
| 1 - 10080 | 将显示对话框的分钟数，最小值为 1 分钟，最大值为 10080 分钟， (1 周) 。 |
| 示例 |
|---|
<add key="timeoutMinutes" value="30"/> |
welcomeText
此 XML 元素提供 OSD 结果 对话框中显示的欢迎文本。
| 值 | 说明 |
|---|---|
| welcome_text | 将在 OSD 结果 对话框中用引号显示的欢迎文本 |
| 示例 |
|---|
<add key="welcomeText" value="Congratulations, Windows 7 has been successfully deployed to your computer."/> |