From 16e72492abb0c4cf86d999ef064fa16da7072919 Mon Sep 17 00:00:00 2001 From: LizRoss Date: Fri, 8 Apr 2016 10:52:39 -0700 Subject: [PATCH] Testing code and bookmarks --- .../deploy/usmt-exclude-files-and-settings.md | 73 ++++++++----------- 1 file changed, 29 insertions(+), 44 deletions(-) diff --git a/windows/deploy/usmt-exclude-files-and-settings.md b/windows/deploy/usmt-exclude-files-and-settings.md index 697bf2d3f8..93d3399b0c 100644 --- a/windows/deploy/usmt-exclude-files-and-settings.md +++ b/windows/deploy/usmt-exclude-files-and-settings.md @@ -13,13 +13,13 @@ When you specify the migration .xml files, MigApp.xml, Migdocs, and MigUser.xml, In this topic: -- [Create a custom .xml file](#options). You can use the following elements to specify what to exclude: +- [Create a custom .xml file](#create-a-custom-xml-file). You can use the following elements to specify what to exclude: - - [include and exclude](#bkmk-includeexclude): You can use the <include> and <exclude> elements to exclude objects with conditions. For example, you can migrate all files located in the C:\\ drive, except any .mp3 files. It is important to remember that [Conflicts and Precedence](usmt-conflicts-and-precedence.md) apply to these elements. + - [include and exclude](#include-and-exclude): You can use the <include> and <exclude> elements to exclude objects with conditions. For example, you can migrate all files located in the C:\\ drive, except any .mp3 files. It is important to remember that [Conflicts and Precedence](usmt-conflicts-and-precedence.md) apply to these elements. - - [unconditionalExclude](#exone): You can use the <unconditionalExclude> element to globally exclude data. This element takes precedence over all other include and exclude rules in the .xml files. Therefore, this element excludes objects regardless of any other <include> rules that are in the .xml files. For example, you can exclude all .mp3 files on the computer, or you can exclude all files from C:\\UserData. + - [unconditionalExclude](#example-1-how-to-migrate-all-files-from-c-except-mp3-files): You can use the <unconditionalExclude> element to globally exclude data. This element takes precedence over all other include and exclude rules in the .xml files. Therefore, this element excludes objects regardless of any other <include> rules that are in the .xml files. For example, you can exclude all .mp3 files on the computer, or you can exclude all files from C:\\UserData. -- [Create a Config.xml file](#co): You can create and modify a Config.xml file to exclude an entire component from the migration. For example, you can use this file to exclude the settings for one of the default applications. In addition, creating and modifying a Config.xml file is the only way to exclude the operating-system settings that are migrated to computers running Windows. Excluding components using this file is easier than modifying the migration .xml files because you do not need to be familiar with the migration rules and syntax. +- [Create a Config.xml File](#create-a-config-xml-file): You can create and modify a Config.xml file to exclude an entire component from the migration. For example, you can use this file to exclude the settings for one of the default applications. In addition, creating and modifying a Config.xml file is the only way to exclude the operating-system settings that are migrated to computers running Windows. Excluding components using this file is easier than modifying the migration .xml files because you do not need to be familiar with the migration rules and syntax. ## Create a custom .xml file We recommend that you create a custom .xml file instead of modifying the default migration .xml files. When you use a custom .xml file, you can keep your changes separate from the default .xml files, which makes it easier to track your modifications. @@ -34,11 +34,11 @@ If you specify an <exclude> rule, always specify a corresponding <inclu - [Example 2: How to migrate all files located in C:\\Data except files in C:\\Data\\tmp](#example-2-how-to-migrate-all-files-located-in-c-data-except-files-in-c-data-tmp) -- [Example 3: How to exclude the files in a folder but include all subfolders](#ex3) +- [Example 3: How to exclude the files in a folder but include all subfolders](#example-3-how-to-exclude-the-files-in-a-folder-but-include-all-subfolders) -- [Example 4: How to exclude a file from a specific folder](#ex4) +- [Example 4: How to exclude a file from a specific folder](#example-4-how-to-exclude-a-file-from-a-specific-folder) -- [Example 5: How to exclude a file from any location](#ex5) +- [Example 5: How to exclude a file from any location](#example-5-how-to-exclude-a-file-from-any-location) ### Example 1: How to migrate all files from C:\\ except .mp3 files The following .xml file migrates all files located on the C: drive, except any .mp3 files. @@ -66,10 +66,9 @@ The following .xml file migrates all files located on the C: drive, except any . ``` ### Example 2: How to migrate all files located in C:\\Data except files in C:\\Data\\tmp - The following .xml file migrates all files and subfolders in C:\\Data, except the files and subfolders in C:\\Data\\tmp. -``` syntax +``` xml Test component @@ -91,11 +90,10 @@ The following .xml file migrates all files and subfolders in C:\\Data, except th ``` -### Example 3: How to exclude the files in a folder but include all subfolders - +### Example 3: How to exclude the files in a folder but include all subfolders The following .xml file migrates any subfolders in C:\\EngineeringDrafts, but excludes all files that are in C:\\EngineeringDrafts. -``` syntax +``` xml Component to migrate all Engineering Drafts Documents without subfolders @@ -117,11 +115,10 @@ The following .xml file migrates any subfolders in C:\\EngineeringDrafts, but ex ``` -### Example 4: How to exclude a file from a specific folder - +### Example 4: How to exclude a file from a specific folder The following .xml file migrates all files and subfolders in C:\\EngineeringDrafts, except for the Sample.doc file in C:\\EngineeringDrafts. -``` syntax +``` xml Component to migrate all Engineering Drafts Documents except Sample.doc @@ -143,25 +140,25 @@ The following .xml file migrates all files and subfolders in C:\\EngineeringDraf ``` -### Example 5: How to exclude a file from any location - +### Example 5: How to exclude a file from any location To exclude a Sample.doc file from any location on the C: drive, use the <pattern> element. If multiple files exist with the same name on the C: drive, all of these files will be excluded. -``` syntax +``` xml C:\* [Sample.doc] ``` To exclude a Sample.doc file from any drive on the computer, use the <script> element. If multiple files exist with the same name, all of these files will be excluded. -``` syntax +``` xml ``` +#### Examples of how to use XML to exclude files, folders, and registry keys +Here are some examples of how to use XML to exclude files, folders, and registry keys. For more info, see [USMT XML Reference](usmt-xml-reference.md) -[USMT XML Reference](usmt-xml-reference.md)Example 1: How to exclude all .mp3 files - +##### Example 1: How to exclude all .mp3 files The following .xml file excludes all .mp3 files from the migration: -``` syntax +``` xml Test @@ -177,12 +174,10 @@ The following .xml file excludes all .mp3 files from the migration: ``` - -### Example 2: How to exclude all of the files on a specific drive - +##### Example 2: How to exclude all of the files on a specific drive The following .xml file excludes only the files located on the C: drive. -``` syntax +``` xml Test @@ -198,12 +193,10 @@ The following .xml file excludes only the files located on the C: drive. ``` +##### Example 3: How to exclude registry keys +The following .xml file unconditionally excludes the HKEY_CURRENT_USER registry key and all of its subkeys. -### Example 3: How to exclude registry keys - -The following .xml file unconditionally excludes the HKey\_Current\_User registry key and all of its subkeys. - -``` syntax +``` xml @@ -226,11 +219,10 @@ The following .xml file unconditionally excludes the HKey\_Current\_User registr ``` -### Example 4: How to Exclude C:\\Windows and C:\\Program Files - +##### Example 4: How to Exclude C:\\Windows and C:\\Program Files The following .xml file unconditionally excludes the system folders of C:\\Windows and C:\\Program Files. Note that all \*.docx, \*.xls and \*.ppt files will not be migrated because the <unconditionalExclude> element takes precedence over the <include> element. -``` syntax +``` xml @@ -256,9 +248,7 @@ The following .xml file unconditionally excludes the system folders of C:\\Windo ``` -## Create a Config.xml File - - +## Create a Config.xml File You can create and modify a Config.xml file if you want to exclude components from the migration. Excluding components using this file is easier than modifying the migration .xml files because you do not need to be familiar with the migration rules and syntax. Config.xml is an optional file that you can create using the **/genconfig** command-line option with the ScanState tool. For example, you can use the Config.xml file to exclude the settings for one of the default applications. In addition, creating and modifying this file is the only way to exclude the operating-system settings that are migrated to computers running Windows. - **To exclude the settings for a default application:** Specify `migrate="no"` for the application under the <Applications> section of the Config.xml file. @@ -272,14 +262,9 @@ See [Config.xml File](usmt-configxml-file.md) for more information. **Note**   To exclude a component from the Config.xml file, set the **migrate** value to **"no"**. Deleting the XML tag for the component from the Config.xml file will not exclude the component from your migration. -  - ## Related topics - - -[Customize USMT XML Files](usmt-customize-xml-files.md) - -[USMT XML Reference](usmt-xml-reference.md) +- [Customize USMT XML Files](usmt-customize-xml-files.md) +- [USMT XML Reference](usmt-xml-reference.md)