Исключение файлов и параметров

  • Статья

Когда вы указываете XML-файлы (MigApp.xml, Migdocs.xml и MigUser.xml) для переноса, средство миграции пользовательской среды (USMT) 10.0 переносит перечисленные параметры и компоненты, как описано в разделе Компоненты, перенос которых выполняет USMT. Можно создать собственный XML-файл, чтобы более точно указать, что следует включить в перенос или исключить из него. Кроме того, вы можете создать файл Config.xml, чтобы полностью исключить какой-либо компонент из переноса. Однако с помощью XML-файлов для переноса и файла Config.xml невозможно исключить пользователей. Единственный способ указать, каких пользователей нужно включить или исключить, — использовать параметры пользователя в средстве ScanState в командной строке. Дополнительные сведения см. в разделе Синтаксис ScanState.

В этом разделе

  • Создание пользовательского XML-файла. Чтобы указать файлы и параметры, которые необходимо исключить, вы можете использовать следующие элементы:

    • include и exclude. Элементы <include> и <exclude> позволяют исключать объекты при определенных условиях. Например, можно перенести все файлы, расположенные на диске C:\, кроме MP3-файлов. Важно помнить, что на эти элементы распространяются конфликты и приоритет.

    • unconditionalExclude. Элемент <unconditionalExclude> позволяет выполнить глобальное исключение данных. Этот элемент имеет более высокий приоритет по сравнению со всеми остальными правилами включения и исключения в XML-файлах. Следовательно, с его помощью можно исключить объекты, независимо от любых других правил <include>, заданных в XML-файлах. Например, можно исключить все MP3-файлы на компьютере или все файлы в папке C:\UserData.

  • Создание файла Config.xml. Файл Config.xml позволяет полностью исключить какой-либо компонент из переноса. Например, можно использовать его, чтобы исключить параметры одного из приложений по умолчанию. Кроме того, создание и изменение файла Config.xml — это единственный способ исключить параметры операционной системы, которые переносятся на компьютеры с операционной системой Windows. Исключить компоненты с помощью данного файла проще, чем изменять XML-файлы для переноса, так как для этого не требуется знание правил переноса и синтаксиса.

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

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

<include> и <exclude>

XML-файлы для переноса MigApp.xml, MigDocs.xml и MigUser.xml содержат элемент <component>, который обычно представляет автономный компонент или программу, например Microsoft® Office Outlook® или Word. Используйте элементы <include> и <exclude>, чтобы исключать файлы и параметры реестра, связанные с этими компонентами. Например, можно использовать эти элементы, чтобы перенести все файлы и параметры, соответствующие шаблону X, кроме файлов и параметров, соответствующих шаблону Y, который определен более строго, чем X. Сведения о синтаксисе для этих элементов см. в разделе Справочник по XML для средства миграции пользовательской среды.

Примечание  

Если вы определяете правило <exclude>, всегда определяйте соответствующее правило <include>. Если не определить правило <include>, отдельные файлы и параметры не будут включены. Они уже будут исключены из набора данных для переноса. Таким образом, использование правила <exclude> без соответствующего правила <include> нецелесообразно.

 

  • Пример 1. Перенос всех файлов на диске C:\, кроме MP3-файлов

  • Пример 2. Перенос всех файлов в папке C:\Data, кроме файлов в папке C:\Data\tmp

  • Пример 3. Исключение файлов, находящихся в папке, и включение всех вложенных папок

  • Пример 4. Исключение файла из определенной папки

  • Пример 5. Исключение файла, независимо от его расположения

Пример 1. Перенос всех файлов на диске C:\, кроме MP3-файлов

Ниже приведен XML-файл для переноса всех файлов на диске C:\, кроме MP3-файлов.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/mp3files">
    <!-- This component migrates all files except those with .mp3 extension-->
    <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>

Пример 2. Перенос всех файлов в папке C:\Data, кроме файлов в папке C:\Data\tmp

Ниже приведен XML-файл для переноса всех файлов и вложенных папок в каталоге C:\Data, кроме файлов и вложенных папок в каталоге C:\Data\tmp.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
    <component type="Documents" context="System">
        <displayName _locID="miguser.sharedvideo">Test component</displayName>
        <role role="Data">
            <rules>
         <include>
            <objectSet>
                 <pattern type="File">C:\Data\* [*]</pattern>
            </objectSet>
          </include>
         <exclude>
             <objectSet>
                   <pattern type="File"> C:\Data\temp\* [*]</pattern>
             </objectSet>
         </exclude>  
            </rules>
        </role>
    </component>
</migration>

Пример 3. Исключение файлов, находящихся в папке, и включение всех вложенных папок

Ниже приведен XML-файл для переноса всех вложенных папок в каталоге C:\EngineeringDrafts, кроме всех файлов, находящихся в папке C:\EngineeringDrafts.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents without subfolders</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>
</migration>

Пример 4. Исключение файла из определенной папки

Ниже приведен XML-файл для переноса всех файлов и вложенных папок в каталоге C:\EngineeringDrafts, кроме файла Sample.doc в папке C:\EngineeringDrafts.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents except Sample.doc</displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
                 <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
            </objectSet>
          </include>
      <exclude>
        <objectSet>
          <pattern type="File"> C:\EngineeringDrafts\ [Sample.doc]</pattern>
        </objectSet>
      </exclude>
    </rules>
  </role>
</component>
</migration>

Пример 5. Исключение файла, независимо от его расположения

Чтобы исключить файл Sample.doc, независимо от его расположения на диске C:, используйте элемент <pattern>. Если на диске C: есть несколько файлов с таким именем, они все будут исключены.

<pattern type="File"> C:\* [Sample.doc] </pattern>

Чтобы исключить файл Sample.doc со всех дисков на компьютере, используйте элемент <script>. Если на компьютере есть несколько файлов с таким именем, все они будут исключены.

<script>MigXmlHelper.GenerateDrivePatterns("* [sample.doc]", "Fixed")</script>

Справочник по XML для средства миграции пользовательской среды

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

Ниже приведен XML-файл для исключения всех MP3-файлов.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/excludefiles">
  <component context="System" type="Documents">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
             <unconditionalExclude>
                        <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
                        </objectSet> 
             </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

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

Ниже приведен XML-файл для исключения только файлов, расположенных на диске C:.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/allfiles">
    <component type="Documents" context="System">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
  <unconditionalExclude>
                    <objectSet>
      <pattern type="File">c:\*[*]</pattern>
                    </objectSet>
  </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Пример 3. Исключение разделов реестра

Ниже приведен XML-файл для безусловного исключения раздела реестра HKey_Current_User и всех его подразделов.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="User">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
                  <pattern type="Registry">HKCU\testReg[*]</pattern>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="Registry">HKCU\*[*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Пример 4. Исключение папок C:\Windows и C:\Program Files

Ниже приведен XML-файл для безусловного исключения системных папок C:\Windows и C:\Program Files. Обратите внимание, что в этом примере будут исключены все DOCX-, XLS- и PPT-файлы, так как элемент <unconditionalExclude> имеет более высокий приоритет, чем элемент <include>.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="System">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.doc]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.xls]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.ppt]", "Fixed")</script>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="File">C:\Program Files\* [*]</pattern>
<pattern type="File">C:\Windows\* [*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Создание файла Config.xml

Можно создать или изменить файл Config.xml, чтобы исключить из набора данных для переноса какие-либо компоненты. Исключить компоненты с помощью данного файла проще, чем изменять XML-файлы для переноса, так как для этого не требуется знание правил переноса и синтаксиса. Config.xml — это необязательный файл, который можно создать с помощью параметра командной строки /genconfig и средства ScanState. Например, можно использовать файл Config.xml, чтобы исключить параметры одного из приложений по умолчанию. Кроме того, создание и изменение этого файла — это единственный способ исключить параметры операционной системы, которые переносятся на компьютеры с операционной системой Windows.

  • Исключение параметров для программы по умолчанию. Укажите migrate="no" для приложения в разделе <Applications> файла Config.xml.

  • Исключение параметра операционной системы. Укажите migrate="no" для нужного параметра в разделе <WindowsComponents>.

  • Исключение папки "Мои документы". Укажите migrate="no" для папки "Мои документы" в разделе <Documents>. Обратите внимание, что все правила <include> из XML-файлов также будут применяться. Например, если вы создали правило, включающее все DOCX-файлы в папке "Мои документы", будут перенесены только эти файлы, а все остальные файлы будут исключены.

Дополнительные сведения см. в разделе Настройка файла Config.xml.

Примечание  

Чтобы исключить компонент из файла Config.xml, установите для параметра migrate значение "no". Удаление XML-тега для компонента из файла Config.xml не приведет к исключению этого компонента из переноса.

 

Связанные разделы

Настройка XML-файлов средства миграции пользовательской среды

Справочник по XML для средства миграции пользовательской среды

Файл Config.xml