Windows智慧运维深入解析USMT配置文件

Windows 智慧型运维
—— 深入解析USMT配置文件
Windows 10 Upgrade Ready Part-6
苏繁 | 2017.9

回顾：什么是USMT
• USMT
– 用户状态迁移工具
（Windows User State Migration Tool）
– USMT 10.0 含有三个命令行工具
• ScanState.exe
• LoadState.exe
• UsmtUtils.exe
– USMT 10.0含有一组可修改的.xml文件
• MigApp.xml
• MigDocs.xml
• MigUser.xml
• * Config.xml
• * Custom.xml

回顾：迁移场景
suf goxia public
MigApp.xml
MigDocs.xml
存储位置
Windows 7
ScanState
/ue:**
/ui:zzytgoxia
goxia public
Windows 10
LoadState
/ue:**
/ui:zzytgoxia
Config.xml
MigApp.xml
ZZYT
/mu
/md
YUTONG
/lac
/lae

内容
• Config.xml文件的概述
• MigApp.xml文件的概述
• MigDocs.xml文件的概述
• MigUser.xml文件的概述
• 使用多个XML文件
• 创建和编辑自定义XML文件
– 示例

Config.xml文件的概述
• Config.xml文件是通过ScanState工具的 /genconfig 选项创建的配置文
件；它可用于修改通过USMT迁移的操作系统组件。
• Config.xml文件可与其他XML文件结合使用
– scanstate /i:migapps.xml /i:migdocs.xml /genconfig:config.xml
– 以如此方式使用时，Config.xml文件严格控制迁移的内容，包括用
户配置文件、数据和设置，无需修改或创建其他XML文件。
• 修改Config.xml文件中的XML元素时，应编辑元素，将Migrate（迁移）
属性设置为“no”，而非从文件中删除元素。如果删除了元素而非设置
属性，则仍将按照其他XML文件中的规则迁移组件。

MigApp.xml文件的概述
• 与USMT一同安装的MigApp.xml文件包含有关迁移中所列出应用程序
的设置的说明。使用ScanState和LoadState工具时必须包含MigApp.xml
文件，这只需要使用 /i 选项迁移应用程序设置即可。
• MigDocs.xml和MigUser.xml文件不迁移应用程序设置。
• 可以创建自定义XML文件，以包含其他应用程序。

MigDocs.xml文件的概述
• MigDocs.xml文件使用新的GenerateDocPatterns Helper函数创建有关USMT根据文件位置
从源计算机迁移文件的说明。MigDocs.xml文件以及ScanState和LoadState工具的结合使
用可让迁移目标更加明确。
• 默认的MigDocs.xml文件将迁移以下内容：
– 驱动器根上的所有文件，除%WINDIR%、%PROGRAMFILES%、%PROGRAMDATA%和%USERS%外。
– 所有固定驱动器根目录中的任何文件夹。例如：c:mail*[*]
– Profiles文件夹的根中的所有文件，除系统配置文件中的文件外。例如：c:userssuf[mail.pst]
– Profiles文件夹的根中的所有文件，除系统配置文件文件夹中的文件外。例如：c:userssufnew folder*[*]
– 标准的共享文件夹（详见：MigDocs.xml文件夹参考）
– 每个用户的标准用户配置文件文件夹（详见：MigDocs.xml文件夹参考）
• 默认的MigDocs.xml文件将不会迁移以下内容：
– 标有隐藏和系统属性的文件
– 可移动驱动器上的文件和文件夹
– 来自%WINDIR%、%PROGRAMDATA%以及%PROGRAMFILES%文件夹的数据
– 含有已安装应用程序的文件夹
• 可以同时使用/genmigxml选项和ScanState工具，查看并修改要迁移的文件。

MigDocs.xml文件夹参考
• 标准的共享文件夹：
– CSIDL_COMMON_DESKTOPDIRECTORY
– CSIDL_COMMON_FAVORITES
– CSIDL_COMMON_DOCUMENTS
– CSIDL_COMMON_MUSIC
– CSIDL_COMMON_PICTURES
– CSIDL_COMMON_VIDEO
– FOLDERID_PublicDownloads
• 每个用户的标准用户配置文件文件夹：
– CSIDL_MYDOCUMENTS
– CSIDL_MYPICTURES
– FOLDERID_OriginalImages
– CSIDL_MYMUSIC
– CSIDL_MYVIDEO
– CSIDL_FAVORITES
– CSIDL_DESKTOP
– CSIDL_QUICKLAUNCH
– FOLDERID_Contacts
– FOLDERID_Libraries
– FOLDERID_Downloads
– FOLDERID_SavedGames
– FOLDERID_RecordedTV

MigUser.xml文件的概述
• MigUser.xml文件包含有关USMT根据文件扩展名迁移用户文件的说明。MigUser.xml文件以及
ScanState和LoadState工具的结合使用可让迁移目标更加明确。MigUser.xml文件将收集标准用户配置
文件文件夹中的所有文件以及计算机上带有特定文件扩展名的任何文件。
• 标准用户配置文件文件夹中的所有文件：
– CSIDL_MYVIDEO、 CSIDL_MYMUSIC、CSIDL_DESKTOP、CSIDL_STARTMENU、CSIDL_PERSONAL、
CSIDL_MYPICTURES、CSIDL_FAVORITES、CSIDL_QUICK LAUNCH
• 带有以下扩展名的文件：
– .qdf、.qsd、.qel、.qph、.doc*、.dot*、.rtf、.mcw、.wps、.scd、.wri、.wpd、.xl*、.csv、.iqy、.dqy、.oqy、.rqy
、.wk*、.wq1、.slk、.dif、.ppt*、.pps*、.pot*、.sh3、.ch3、.pre、.ppa、.txt、.pst、.one*、.vl*、.vsd、.mpp、.o
r6、.accdb、.mdb、.pub
• 默认的MigUser.xml文件将不会迁移以下内容：
– 标有隐藏和系统属性的文件、可移动驱动器上的文件和文件夹、来自 %WINDIR%、%PROGRAMFILES% 以及
%PROGRAMDATA% 文件夹的数据、不包含在用户配置文件中的文件夹中文件的 ACLS。
• 可以复制 MigUser.xml 文件，并且对它进行修改，以包含或排除标准用户配置文件文件夹以及文件
扩展名。
• 如果知道源计算机中所有要迁移文件的扩展名，则使用 MigUser.xml 文件，移动相关数据，不管文
件位置如何。但是，这会导致迁移中含有比预期要多的文件，且更耗时。

使用多个XML文件
• 可以通过ScanState和LoadState工具使用多个XML文件。
• 为迁移的特定组件配置每个由USMT包含或生成的默认XML文件。
• 可以使用自定义XML文件补充这些带有其他迁移规则的默认文件。
• 不应再同一个命令中同时使用MigUser.xml和MigDocs.xml。
• 如果数据集尚未明确或许多文件存储在标准用户配置文件文件夹外面，则MigDocs.xml比
MigUser.xml更为理想的选择

创建和编辑自定义XML文件
• 可以使用 /genmigxml 命令行选项，确定哪些文件应包含在迁移中。
利用 /genmigxml选项，在指定的位置创建文件，以便可以查看XML规
则，并作出必要的修改。
– scanstate.exe /genmigxml:”d:genmig.xml”
• 文件必须是Unicode转换格式-8（UTF-8），格式为.xml
• 文件必须具有唯一的迁移UrlID（CustomFilename应与文件名匹配）
• 文件中的每个组件都必须有显示名称，才能显示在Config.xml文件中。
例如<displayname>MyApp</displayName>

GenerateDocPatterns函数
• MigDocs.xml可调用含有三个布尔值的GenerateDocPatterns函数，更改
设置可修改MigDocs.xml文件生成XML迁移规则的方式。
– ScanProgramFiles，此参数确定是否扫描Program Files目录，以收
集已在相关应用程序中注册的文件扩展名。例如为TRUE时，该函
数将发现和迁移Microsoft Office目录项下的.doc文件。
– IncludePatterns，此参数可确定是否在XML中生成排除或包含模式。
当此参数为TURE时，GenerateDocPatterns函数将生成包含模式，
这时必须将该函数添加在<include>元素项下。将此参数更改为
FALSE时，会生成排除模式，这时必须将该函数添加在<exclude>
元素项下。
– SystemDrive，此参数将确定生成的模式是适用于所有固定驱动器
还是仅适用于系统驱动器，当此参数为TURE时，会导致所有模式
仅适用于系统驱动器。

GenerateDocPatterns函数用法
• 创建仅适用于系统驱动器的包含数据模式的步骤：
• 创建包含规则以从%PROGRAMFILES%目录收集已注册扩展名文件的步骤：
• 创建排除数据模式的步骤：

XML文件自定义版本的实例迁移规则
• 排除规则使用示例
– 以下实例中，源计算机具有一个“new folder”目录项下名为“new text document”
的.txt文件。默认的MigDocs.xml行为迁移“new text document.txt”文件以及“new
folder”目录中所含有的所有文件。
– 函数生成规则：
• 规则1：
– <pattern type="File">d:new folder[new text document.txt]</pattern>
• 规则2：
– <pattern type="File">d:new folder*[*]</pattern>

• 排除规则使用示例1：
– 排除文件夹中所有.txt文件，要排除规则1，则文件名必须完全匹配。但是，对于规
则2，则可使用文件扩展名创建模式，以排除文件。

– 如果不知道文件名或文件位置，但知道文件扩展名，则可以使用
GenerateDrivePatterns函数。但是，此规则的具体性将不如MigDocs.xml文件所生成
的默认包含规则，因此，它不具有优先性。必须使用<UnconditionalExclude>元素，
让此规则优先于默认的包含规则。

– 如果想将<UnconditionalExclude>元素应用系统和用户上下文，则可以使用
UserandSystem上下文创建第三个组件。将在两种上下文中运行此组件中的规则。
注释：
对于每个组件，ScanState 检查组件类型。如果当前用户配置文件是系统配置文件，且组件类型为“System”或“UserAndSystem”，
则为此用户选择该组件。
否则，忽略该组件。或者，如果当前用户配置文件不是系统配置文件，且组件类型为“User”或“UserAndSystem”，则为此用户选择
该组件。否则，忽略此组件。

• 包含规则使用示例
– 示例1，在已知的用户文件夹中包含文件扩展名。此规则将包含处于默认位置但未
链接到Outlook的.pst文件。使用用户上下文，对计算机上的每位用户运行此规则。
– 示例2，在程序文件中包含文件扩展名。对于用户配置文件外部的位置（如程序文
件文件夹），可以讲规则添加到系统上下文组件。

迁移不受支持的应用程序
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/migtestapp">
<component type="Application">

<displayName>Some Application</displayName>

<environment context="System">

<variable name="myVar1">

<text>value</text>
</variable>
<variable name="myAppExePath">

<script>MigXMLHelper.GetStringContent("Registry","HKLMSoftwareMyAppInstaller
[EXEPATH]")</script>
</variable>
</environment>
<role role="Settings">
<detects>

<detect>

<condition>MigXMLHelper.DoesObjectExist("Registry","HKLMSoftwareMyApp
[win32_version]")</condition>
</detect>
<detect>


<condition>MigXMLHelper.DoesFileVersionMatch("%MyAppExePath%","ProductVersion","8.*")
</condition>
<condition>MigXMLHelper.DoesFileVersionMatch("%MyAppExePath%","ProductVersion","9.*")
</condition>
</detect>
</detects>

<rules context="User">

<destinationCleanup>

<objectSet>
<pattern type="Registry">HKCUSoftwareMyAppToolbar* [*]</pattern>
<pattern type="Registry">HKCUSoftwareMyAppListView* [*]</pattern>
<pattern type="Registry">HKCUSoftwareMyApp [ShowTips]</pattern>
</objectSet>
</destinationCleanup>

<include>

<objectSet>
<pattern type="Registry">HKCUSoftwareMyAppToolbar* [*]</pattern>
<pattern type="Registry">HKCUSoftwareMyAppListView* [*]</pattern>
<pattern type="Registry">HKCUSoftwareMyApp [ShowTips]</pattern>
</objectSet>
</include>

<exclude>

<objectSet>
<pattern type="Registry">HKCUSoftwareMyApp [Display]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
</migration>

迁移“My Videos”文件夹
<?xml version="1.0" encoding="UTF-8"?>
<migration
urlid="http://www.microsoft.com/migration/1.0/migxmlext/CustomFile">
<component type="Documents" context="User">
<displayName>My Video</displayName>
<role role="Data">
<detects>
<detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYVIDEO%")<
/condition>
</detect>
</detects>
<rules>
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">%CSIDL_MYVIDEO%*
[*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
</migration>
验证源计算机上是否存在“My Videos”
筛选出不在目标计算机上的“My Videos”中的快捷方式。即
源计算机上的My Videos中存在指向C:Folder1的快捷方式，
则仅当目标计算机上存在C:Folder1时才迁移该快捷方式。
为所有用户迁移“My Videos”。

迁移文件和注册表项
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/testfilemig">
<component type="Application" context="System">
<displayName>File Migration Test</displayName>
<role role="Data">
<rules context="System">
<include>
<objectSet>
<pattern type="File">%ProgramFiles%USMTTestFolder*
[USMTTestFile.txt]</pattern>
<pattern type="File">%ProgramFiles%USMTDIRTestFolder* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
<component type="System">
<displayName>Registry Migration Test</displayName>
<role role="Settings">
<rules context="UserAndSystem">
<include>
<objectSet>
<pattern type="Registry">HKCUSoftwareUSMTTESTKEY* [MyKey]</pattern>
<pattern type="Registry">HKLMSoftwareUSMTTESTKEY* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
</migration>
从%ProgramFiles%USMTTestFolder下的所有子目录迁移Usmttestfile.txt文件
迁移%ProgramFiles%USMTTestFolder下的整个目录
迁移 HKCUSoftwareUSMTTESTKEY 下的 MyKey 的所有实例
迁移 HKCUSoftwareUSMTTESTKEY 下的整个注册表配置单元

从各个位置迁移特定文件夹
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
<displayName>Component to migrate all Engineering Drafts subfolders without documents
in this folder </displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<pattern type="File"> C:EngineeringDrafts* [*]</pattern>
</objectSet>
</include>
<exclude>
<objectSet>
<pattern type="File"> C:EngineeringDrafts [*]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
<displayName>Component to migrate all user documents except
Sample.doc</displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<pattern type="File"> C:UserDocuments* [*]</pattern>
</objectSet>
</include>
<exclude>
<objectSet>
<pattern type="File"> C:UserDocuments [Sample.doc]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
<displayName>Component to migrate all Requests folders on any drive on the computer </displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("Requests* [*] ", "Fixed")</script>
<script>MigXmlHelper.GenerateDrivePatterns ("*Requests* [*] ", "Fixed")</script>
</objectSet>
</include>
</rules>
</role>
</component>
<displayName>Component to migrate all Presentations folder from any location on the C: drive </displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<pattern type="File"> C:*Presentations* [*]</pattern>
<pattern type="File"> C:Presentations* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
</migration>

迁移C:中除.mp3文件之外的所有文件
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/mp3files">

<component type="Documents" context="UserAndSystem">
<displayName _locID="miguser.sharedvideo">MP3 Files</displayName>
<role role="Data">
<rules>
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">C:* [*]</pattern>
</objectSet>
</include>
<exclude>
<objectSet>
<pattern type="File">C:* [*.mp3]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
</migration>

重新路由特定文件类型
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/test">
<displayName>All .mp3 files to My Documents</displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
</objectSet>
</include>

<locationModify script="MigXmlHelper.Move('C:Music')">
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
</objectSet>
</locationModify>
</rules>
</role>
</component>
</migration>

Windows智慧运维深入解析USMT配置文件

Recomendados

Recomendados

Mais conteúdo relacionado

Semelhante a Windows智慧运维深入解析USMT配置文件

Semelhante a Windows智慧运维深入解析USMT配置文件 (20)