Общие сведения о XML-файлах миграции

• Применяется к:

  ✅ Windows 11, ✅ Windows 10

Поведение базовой миграции средства миграции пользовательской среды (USMT) можно изменить с помощью XML-файлов. Эти файлы содержат инструкции о том, где и как средства USMT должны собирать и применять файлы и параметры. USMT включает три XML-файла, которые можно использовать для настройки базовой миграции: MigDocs.xml файлы и MigUser.xml , которые изменяют способ обнаружения файлов на исходном компьютере, и файл MigApps.xml, необходимый для переноса поддерживаемых параметров приложения. Пользовательские XML-файлы и Config.xml файл можно создать и изменить для дальнейшей настройки миграции.

В этой статье представлен обзор XML-файлов по умолчанию и пользовательских файлов миграции, а также рекомендации по созданию и редактированию настраиваемой MigDocs.xml версии файла. Файл MigDocs.xml использует новую GenerateDocPatterns функцию, доступную в USMT, для автоматического поиска документов пользователей на исходном компьютере.

Обзор файла Config.xml

Файл Config.xml — это файл конфигурации, созданный параметром /genconfig средства ScanState . Его можно использовать для изменения компонентов операционной системы, переносимых USMT. Файл Config.xml можно использовать с другими XML-файлами, например в следующем примере:

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

При использовании таким образом Config.xml файл строго контролирует аспекты миграции, включая профили пользователей, данные и параметры, без изменения или создания других XML-файлов. Дополнительные сведения о файле см. в Config.xml разделе Настройка XML-файлов USMT и файлаConfig.xml.

Примечание.

При изменении XML-элементов в Config.xml файле присвойте свойству migrate для элемента значение Нет , а не удалите элемент из файла. Если элемент удаляется вместо задания свойства, правила в других XML-файлах по-прежнему могут переносить компонент.

Обзор файла MigApp.xml

Файл, установленный MigApp.xml с USMT, содержит инструкции по переносу параметров для приложений, перечисленных в разделе Что такое миграция USMT?. Чтобы перенести параметры приложения, MigApp.xml файл должен быть включен при использовании средств ScanState и LoadState с помощью /i параметра . Файлы MigDocs.xml и MigUser.xml не переносятся параметры приложения. Можно создать пользовательский XML-файл для включения дополнительных приложений. Дополнительные сведения см. в разделе Настройка XML-файлов USMT.

Важно.

Файл MigApps.xml обнаруживает и переносит только PST-файлы , связанные с Microsoft Office Outlook. Дополнительные сведения о переносе PST-файлов , которые не связаны с Outlook, см . в разделе Примеры правил миграции для настраиваемых версий XML-файлов.

Обзор файла MigDocs.xml

В MigDocs.xml файле используется новая GenerateDocPatterns вспомогащая функция для создания инструкций для USMT по переносу файлов с исходного компьютера на основе расположения файлов. Файл MigDocs.xml можно использовать со средствами ScanState и LoadState для выполнения более целевой миграции, чем с помощью USMT без инструкций XML.

Файл по умолчанию MigDocs.xml переносит следующие данные:

• Все файлы в корневой части диска, кроме %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA%или %USERS%.

• Все папки в корневом каталоге всех фиксированных дисков. Например: c:\data_mail\*[*].

• Все файлы из корневой папки Profiles, за исключением файлов в системном профиле. Например: c:\users\name[mail.pst].

• Все папки из корневого каталога папки Profiles, за исключением папок системного профиля. Например: c:\users\name\new folder\*[*].

• Standard общих папок:

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

• Standard для каждого пользователя:

  • 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

Файл по умолчанию MigDocs.xml не переносит следующие данные:

• Файлы, помеченные как скрытыми , так и системными атрибутами.

• Файлы и папки на съемных дисках.

• Данные из папок %WINDIR%, %PROGRAMDATA% и %PROGRAMFILES%.

• Папки, содержащие установленные приложения.

Параметр /genmigxml можно использовать вместе со средством ScanState для просмотра и изменения перенесенных файлов.

Обзор файла MigUser.xml

Файл MigUser.xml содержит инструкции для USMT по переносу пользовательских файлов на основе расширений имен файлов. Файл MigUser.xml можно использовать со средствами ScanState и LoadState для выполнения более целевой миграции, чем с помощью USMT без инструкций XML. Файл MigUser.xml собирает все файлы из стандартных папок профиля пользователя и все файлы на компьютере с указанными расширениями имен файлов.

Файл по умолчанию MigUser.xml переносит следующие данные:

• Все файлы из стандартных папок профиля пользователя, которые описаны следующим образом:

  • CSIDL_MYVIDEO

  • CSIDL_MYMUSIC

  • CSIDL_DESKTOP

  • CSIDL_STARTMENU

  • CSIDL_PERSONAL

  • CSIDL_MYPICTURES

  • CSIDL_FAVORITES

  • CSIDL_QUICK LAUNCH

• Файлы со следующими расширениями:

  .accdb, .ch3, .csv, .dif, .doc*, .dot*, .dqy, .iqy, .mcw, .mdb*, .mpp, .one*, .oqy, .or6, .pot*, .ppa, .pps*, .ppt*, .pre, .pst, .pub, .qdf, .qel, .qph, .qsd, .rqy, .rtf, .scd, .sh3, .slk, .txt, .vl*, .vsd, .wk*, .wpd, .wps, .wq1, .wri, .xl*, .xla, .xlb, .xls*

  Примечание.

  Звездочка (*) означает ноль или больше символов.

  Примечание.

  Расширения OpenDocument (*.odt, *.odp, *.ods), которые могут использовать приложения Microsoft Office, по умолчанию не переносятся.

Файл по умолчанию MigUser.xml не переносит следующие данные:

• Файлы, помеченные как скрытыми , так и системными атрибутами.

• Файлы и папки на съемных дисках.

• Данные из %WINDIR%папок , %PROGRAMFILES%, %PROGRAMDATA% .

• ACLS для файлов в папках вне профиля пользователя.

Файл MigUser.xml можно скопировать, а затем изменить копию, чтобы включить или исключить стандартные папки профиля пользователя и расширения имен файлов. Если известны все расширения для файлов, которые необходимо перенести с исходного компьютера, используйте MigUser.xml файл для перемещения всех соответствующих данных независимо от расположения файлов. Однако добавление всех расширений файлов, которые необходимо перенести в файл, может привести к MigUser.xml миграции, содержащей больше файлов, чем предполагалось. Например, если переносятся все файлы.jpg , он также может переносить файлы изображений, такие как эскизы и логотипы, из устаревших приложений, установленных на исходном компьютере.

Примечание.

Каждое расширение имени файла, включенное в правила в MigUser.xml файле, увеличивает время, необходимое средству ScanState для сбора файлов для миграции. Если переносится более 300 типов файлов, процесс миграции может быть медленным. Дополнительные сведения о других способах организации переноса данных см. в разделе Использование нескольких XML-файлов этой статьи.

Использование нескольких XML-файлов

С инструментами ScanState и LoadState можно использовать несколько XML-файлов . Каждый из XML-файлов по умолчанию, включенных или создаваемых USMT, настраивается для определенного компонента миграции. Пользовательские XML-файлы также можно использовать для дополнения этих файлов по умолчанию дополнительными правилами миграции.

Файл миграции XML	Изменяет следующие компоненты:
файлConfig.xml	Компоненты операционной системы, такие как обои для рабочего стола и фоновая тема. Можно Config.xml также расширить, чтобы включить некоторые параметры приложения и документа, создав Config.xml файл с другими XML-файлами по умолчанию. Дополнительные сведения см. в разделе Настройка XML-файлов USMT и файлаConfig.xml.
файлMigApps.xml	Параметры приложений.
файлыMigUser.xml или MigDocs.xml	Пользовательские файлы и параметры профиля.
Пользовательские XML-файлы	Параметры приложения, параметры профиля пользователя или файлы пользователей, помимо правил, содержащихся в других XML-файлах.

Например, все типы файлов миграции XML можно использовать для одной миграции, как показано в следующем примере:

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

Правила XML для переноса пользовательских файлов

Важно.

Файлы MigUser.xml и MigDocs.xml не должны использоваться вместе в одной команде. Использование обоих XML-файлов может привести к дублированию некоторых перенесенных файлов. Дублирование некоторых перенесенных файлов может произойти, если в каждом XML-файле предоставляются конфликтующие инструкции по расположению целевого объекта. Целевой файл сохраняется один раз во время миграции, но каждый XML-файл применяет его к другому расположению на конечном компьютере.

Если набор данных неизвестен или много файлов хранится за пределами стандартных папок профиля пользователя, MigDocs.xml лучше выбрать, чем MigUser.xml файл, так как MigDocs.xml файл собирает более широкий область данных. Файл MigDocs.xml переносит папки данных в зависимости от расположения. Файл MigUser.xml переносит только файлы с указанными расширениями имен файлов.

Чтобы получить дополнительный контроль над миграцией, создайте пользовательские XML-файлы. Дополнительные сведения о создании пользовательских XML-файлов см. в статье Создание и редактирование настраиваемого XML-файла.

Создание и редактирование пользовательского XML-файла

Параметр /genmigxml командной строки можно использовать для определения файлов, включенных в миграцию. Параметр /genmigxml создает файл в указанном расположении. Затем можно просмотреть XML-правила в файле и при необходимости внести изменения.

Примечание.

Если USMT переустановлен, XML-файлы миграции по умолчанию перезаписываются, а все настройки, внесенные в эти файлы, теряются. Рассмотрите возможность создания отдельных XML-файлов для пользовательских правил миграции и их сохранения в безопасном расположении.

Чтобы создать файл правил миграции XML для исходного компьютера, выполните следующие действия:

1. Выберите Запустить>все программы>Аксессуары

2. Щелкните правой кнопкой мыши командную строку и выберите Пункт Запустить от имени.

3. Выберите учетную запись с правами администратора, введите пароль и нажмите кнопку ОК.

4. В командной строке введите:

   cd /d <USMTpath>
   ScanState.exe /genmigxml: <filepath.xml>
   

   где:

   • <USMTpath> — расположение на исходном компьютере сохраненных файлов и средств USMT.
   • < >filepath.xml — полный путь к файлу, в котором можно сохранить отчет.

   Например, введите:

   cd /d c:\USMT
   ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"
   

Функция GenerateDocPatterns

Файл MigDocs.xml вызывает функцию GenerateDocPatterns , которая принимает три логических значения. Параметры можно изменить, чтобы изменить способ создания xml-правил для миграции в MigDocs.xml файле.

• ScanProgramFiles: этот аргумент действителен, только если GenerateDocPatterns функция вызывается в системном контексте. Этот аргумент определяет, следует ли сканировать каталог Program Files для сбора зарегистрированных расширений имен файлов для известных приложений.

  Значение по умолчанию: False

  Например, если задано значение TRUE, функция обнаруживает и переносит файлы.doc в каталог Microsoft Office, так как .doc — это расширение имени файла, зарегистрированное в приложении Microsoft Office. Функция GenerateDocPatterns создает этот шаблон включения для .doc файлов:

  <pattern type="File">C:\Program Files\Microsoft Office[.doc]</pattern>

  Если дочерняя папка включенной папки содержит установленное приложение, ScanProgramFiles также создает правило исключения для дочерней папки. Все папки в папке приложения проверяются рекурсивно на наличие зарегистрированных расширений имен файлов.

• IncludePatterns: этот аргумент определяет, следует ли создавать шаблоны исключений или включать их в XML. Если для этого аргумента задано значение TRUE, GenerateDocPatterns функция создает шаблоны include, и функция должна быть добавлена <include> в элемент . При изменении этого аргумента на FALSE создаются шаблоны исключения, и функция должна быть добавлена <exclude> в элемент .

  Значение по умолчанию: True

• SystemDrive: этот аргумент определяет, следует ли создавать шаблоны для всех фиксированных дисков или только для системного диска. При изменении этого аргумента на TRUE все шаблоны ограничиваются системным диском.

  Значение по умолчанию: False

Употребление:

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

Чтобы создать шаблоны данных только для системного диска, выполните следующие действия:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>
     </objectSet>
</include>

Чтобы создать правило включения для сбора файлов для зарегистрированных расширений из каталога %PROGRAMFILES%, выполните следующие действия:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
     </objectSet>
</include>

Чтобы создать шаблоны данных исключения, выполните приведенные далее действия.

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
     </objectSet>
</exclude>

Общие сведения о системном и пользовательском контексте

XML-файлы миграции содержат два <компонента> с разными параметрами контекста :

• Системный контекст применяется к файлам на компьютере, которые не хранятся в каталоге профилей пользователей.
• Контекст пользователя применяется к файлам, которые относятся к конкретному пользователю.

Контекст системы

Системный контекст включает правила для данных за пределами каталога профилей пользователей. Например, при вызове в системном контексте в MigDocs.xml файле GenerateDocPatterns функция создает шаблоны для всех общих папок оболочки, файлов в корневом каталоге жестких дисков и папок, расположенных в корне жестких дисков. В состав входят следующие папки:

• CSIDL_COMMON_DESKTOPDIRECTORY

• CSIDL_COMMON_FAVORITES

• CSIDL_COMMON_DOCUMENTS

• CSIDL_COMMON_MUSIC

• CSIDL_COMMON_PICTURES

• CSIDL_COMMON_VIDEO

• FOLDERID_PublicDownloads

Контекст пользователя

Контекст пользователя содержит правила для данных в каталоге Профилей пользователей. При вызове в контексте пользователя в MigDocs.xml файле GenerateDocPatterns функция создает шаблоны для всех папок оболочки пользователя, файлов, расположенных в корне профиля, и папок, расположенных в корне профиля. В состав входят следующие папки:

• 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

Примечание.

Правила, содержащиеся в компоненте, которому назначен контекст пользователя выполняется для каждого профиля пользователя на компьютере. Файлы, которые сканируются несколько раз файлами MigDocs.xml , копируются в хранилище миграции только один раз. Однако большое количество правил в контексте пользователя может замедлить миграцию. Используйте системный контекст, если это применимо.

Примеры правил миграции для настраиваемых версий XML-файлов

Совет

Рекомендации и требования к настраиваемым XML-файлам в USMT см. в статье Настройка XML-файлов USMT и общих соглашений.

Примеры использования правил исключения

В следующих примерах исходный компьютер содержит файл.txtnew text document в каталоге с именем new folder. Поведение по умолчанию MigDocs.xml переносит новый текстовый document.txt файл и все файлы, содержащиеся в каталоге new folder . Правила, создаваемые функцией:

Правило	Синтаксис
Правило 1	<pattern type="File">d:\new folder[new text document.txt]</pattern>
Правило 2	<pattern type="File">d:\new folder[]</pattern>

Чтобы исключить новый текстовый document.txt файл и все файлы.txt в new folder, можно внести следующие изменения:

Пример 1. Исключение всех .txt файлов в папке

Чтобы исключить правило 1, должно быть точное совпадение имени файла. Однако для правила 2 можно создать шаблон для исключения файлов с помощью расширения имени файла.

<exclude>
     <objectSet>
        <pattern type="File">D:\Newfolder\[new text document.txt]</pattern>
         <pattern type="File">D:\New folder\*[*.txt]</pattern>
     </objectSet>
</exclude>

Пример 2. Использование элемента UnconditionalExclude для предоставления правилу приоритета над правилами включения

Если имя файла или расположение файла неизвестно, но расширение имени файла известно, можно использовать функцию GenerateDrivePatterns . Однако правило менее специфично, чем правило включения по умолчанию, созданное файлом MigDocs.xml , поэтому оно не имеет приоритета. Элемент <UnconditionalExclude> должен использоваться для предоставления этому правилу приоритета над правилом включения по умолчанию. Дополнительные сведения о порядке приоритета для правил миграции XML см. в разделе Конфликты и приоритет.

<unconditionalExclude>
     <objectSet>
        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
     </objectSet>
</unconditionalExclude>

Пример 3. Использование компонента контекста UserandSystem для выполнения правил в обоих контекстах

Чтобы применить <элемент UnconditionalExclude> как к системе, так и к контексту пользователя, можно создать третий компонент с помощью контекста UserandSystem . Правила в этом компоненте выполняются в обоих контекстах.

<component type="Documents" context="UserandSystem">
   <displayName>MigDocExcludes</displayName>
   <role role="Data">
     <rules>
       <unconditionalExclude>
         <objectSet>
                <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
         </objectSet>
       </unconditionalExclude>
     </rules>
   </role>
</component>

Дополнительные примеры правил исключения, которые можно использовать в XML-файлах пользовательской миграции, см. в разделе Исключение файлов и параметров.

Включение примеров использования правил

Каталог данных приложения — это наиболее распространенное расположение, в которое необходимо добавить правило включения. Функция GenerateDocPatterns по умолчанию исключает это расположение. Если организация использует приложение, которое сохраняет важные данные в этом расположении, можно создать правила включения для переноса данных. Например, по умолчанию для PST-файлов используется расположение: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Файл MigApp.xml содержит правила миграции для перемещения только тех PST-файлов , которые связаны с Microsoft Outlook. Чтобы включить PST-файлы , которые не связаны, можно внести следующее изменение:

Пример 1. Включение расширения имени файла в папку известного пользователя

Это правило включает PST-файлы , которые находятся в расположении по умолчанию, но не связаны с Microsoft Outlook. Используйте контекст пользователя, чтобы запустить это правило для каждого пользователя на компьютере.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>
     </objectSet>
</include>

Пример 2. Включение расширения имени файла в Program Files

Для расположений за пределами профиля пользователя, таких как папка Program Files, правило можно добавить в компонент контекста системы.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
     </objectSet>
</include>

Дополнительные примеры правил включения, которые можно использовать в XML-файлах пользовательской миграции, см. в разделе Включение файлов и параметров.

Совет

Дополнительные сведения о порядке приоритета для правил миграции XML см. в разделе Конфликты и приоритет.

Дальнейшие действия

Дополнительные правила для миграции можно включить в MigDocs.xml файл или другие XML-файлы миграции. Например, элемент можно использовать для перемещения файлов из папки, <locationModify> в которой они были собраны, в другую папку при их применении к конечному компьютеру.

Xml-файл схемы (MigXML.xsd) можно использовать для проверки синтаксиса настраиваемых XML-файлов. Дополнительные сведения см. в разделе Ресурсы USMT.

Связанные статьи

• Исключите файлы и параметры.
• Включите файлы и параметры.