mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-15 18:33:43 +00:00
Metadata update deployment/usmt 5
This commit is contained in:
Frank Rojas
@ -43,7 +43,7 @@ This article provides an overview of the default and custom migration XML files
|
||||
|
||||
[Next Steps](#bkmk-next)
|
||||
|
||||
## <a href="" id="bkmk-config"></a>Overview of the Config.xml file
|
||||
## <a href="" id="bkmk-config"></a> Overview of the Config.xml file
|
||||
|
||||
The `Config.xml` file is the configuration file created by the `/genconfig` option of the ScanState tool; it can be used to modify which operating-system components are migrated by USMT. The `Config.xml` file can be used with other XML files, such as in the following example:
|
||||
|
||||
@ -54,133 +54,133 @@ When used this way, the `Config.xml` file tightly controls aspects of the migrat
|
||||
> [!NOTE]
|
||||
> When modifying the XML elements in the `Config.xml` file, you should edit an element and set the **migrate** property to **no**, rather than deleting the element from the file. If you delete the element instead of setting the property, the component may still be migrated by rules in other XML files.
|
||||
|
||||
## <a href="" id="bkmk-migapp"></a>Overview of the MigApp.xml file
|
||||
## <a href="" id="bkmk-migapp"></a> Overview of the MigApp.xml file
|
||||
|
||||
The `MigApp.xml` file installed with USMT includes instructions to migrate the settings for the applications listed in [What Does USMT Migrate?](usmt-what-does-usmt-migrate.md). You must include the `MigApp.xml` file when using the ScanState and LoadState tools, by using the `/i` option in order to migrate application settings. The `MigDocs.xml` and `MigUser.xml` files don't migrate application settings. You can create a custom XML file to include additional applications. For more information, see [Customize USMT XML Files](usmt-customize-xml-files.md).
|
||||
|
||||
> [!Important]
|
||||
> [!IMPORTANT]
|
||||
> The MigApps.xml file will only detect and migrate .pst files that are linked to Microsoft Office Outlook. For more information about migrating .pst files that are not linked to Outlook, see the [Sample migration rules for customized versions of XML files](#bkmk-samples).
|
||||
|
||||
## <a href="" id="bkmk-migdocs"></a>Overview of the MigDocs.xml file
|
||||
## <a href="" id="bkmk-migdocs"></a> Overview of the MigDocs.xml file
|
||||
|
||||
The `MigDocs.xml` file uses the new `GenerateDocPatterns` helper function to create instructions for USMT to migrate files from the source computer, based on the location of the files. You can use the `MigDocs.xml` file with the ScanState and LoadState tools to perform a more targeted migration than using USMT without XML instructions.
|
||||
|
||||
The default `MigDocs.xml` file migrates the following data:
|
||||
|
||||
- All files on the root of the drive except %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA%, or %USERS%.
|
||||
- All files on the root of the drive except `%WINDIR%`, `%PROGRAMFILES%`, `%PROGRAMDATA%`, or `%USERS%`.
|
||||
|
||||
- All folders in the root directory of all fixed drives. For example: c:\\data\_mail\\\*\[\*\]
|
||||
- All folders in the root directory of all fixed drives. For example: `c:\data_mail\*[*]`
|
||||
|
||||
- All files from the root of the Profiles folder, except for files in the system profile. For example: c:\\users\\name\[mail.pst\]
|
||||
- All files from the root of the Profiles folder, except for files in the system profile. For example: `c:\users\name[mail.pst]`
|
||||
|
||||
- All folders from the root of the Profiles folder, except for the system-profile folders. For example: c:\\users\\name\\new folder\\\*\[\*\]
|
||||
- All folders from the root of the Profiles folder, except for the system-profile folders. For example: `c:\users\name\new folder\*[*]`
|
||||
|
||||
- Standard shared folders:
|
||||
- Standard shared folders:
|
||||
|
||||
- CSIDL\_COMMON\_DESKTOPDIRECTORY
|
||||
- CSIDL\_COMMON\_DESKTOPDIRECTORY
|
||||
|
||||
- CSIDL\_COMMON\_FAVORITES
|
||||
- CSIDL\_COMMON\_FAVORITES
|
||||
|
||||
- CSIDL\_COMMON\_DOCUMENTS
|
||||
- CSIDL\_COMMON\_DOCUMENTS
|
||||
|
||||
- CSIDL\_COMMON\_MUSIC
|
||||
- CSIDL\_COMMON\_MUSIC
|
||||
|
||||
- CSIDL\_COMMON\_PICTURES
|
||||
- CSIDL\_COMMON\_PICTURES
|
||||
|
||||
- CSIDL\_COMMON\_VIDEO
|
||||
- CSIDL\_COMMON\_VIDEO
|
||||
|
||||
- FOLDERID\_PublicDownloads
|
||||
- FOLDERID\_PublicDownloads
|
||||
|
||||
- Standard user-profile folders for each user:
|
||||
- Standard user-profile folders for each user:
|
||||
|
||||
- CSIDL\_MYDOCUMENTS
|
||||
- CSIDL\_MYDOCUMENTS
|
||||
|
||||
- CSIDL\_MYPICTURES
|
||||
- CSIDL\_MYPICTURES
|
||||
|
||||
- FOLDERID\_OriginalImages
|
||||
- FOLDERID\_OriginalImages
|
||||
|
||||
- CSIDL\_MYMUSIC
|
||||
- CSIDL\_MYMUSIC
|
||||
|
||||
- CSIDL\_MYVIDEO
|
||||
- CSIDL\_MYVIDEO
|
||||
|
||||
- CSIDL\_FAVORITES
|
||||
- CSIDL\_FAVORITES
|
||||
|
||||
- CSIDL\_DESKTOP
|
||||
- CSIDL\_DESKTOP
|
||||
|
||||
- CSIDL\_QUICKLAUNCH
|
||||
- CSIDL\_QUICKLAUNCH
|
||||
|
||||
- FOLDERID\_Contacts
|
||||
- FOLDERID\_Contacts
|
||||
|
||||
- FOLDERID\_Libraries
|
||||
- FOLDERID\_Libraries
|
||||
|
||||
- FOLDERID\_Downloads
|
||||
- FOLDERID\_Downloads
|
||||
|
||||
- FOLDERID\_SavedGames
|
||||
- FOLDERID\_SavedGames
|
||||
|
||||
- FOLDERID\_RecordedTV
|
||||
- FOLDERID\_RecordedTV
|
||||
|
||||
The default `MigDocs.xml` file won't migrate the following data:
|
||||
|
||||
- Files tagged with both the **hidden** and **system** attributes.
|
||||
- Files tagged with both the **hidden** and **system** attributes.
|
||||
|
||||
- Files and folders on removable drives.
|
||||
- Files and folders on removable drives.
|
||||
|
||||
- Data from the %WINDIR%, %PROGRAMDATA%, and %PROGRAMFILES% folders.
|
||||
- Data from the %WINDIR%, %PROGRAMDATA%, and %PROGRAMFILES% folders.
|
||||
|
||||
- Folders that contain installed applications.
|
||||
- Folders that contain installed applications.
|
||||
|
||||
You can also use the `/genmigxml` option with the ScanState tool to review and modify what files will be migrated.
|
||||
|
||||
## <a href="" id="bkmk-miguser"></a>Overview of the MigUser.xml file
|
||||
## <a href="" id="bkmk-miguser"></a> Overview of the MigUser.xml file
|
||||
|
||||
The `MigUser.xml` file includes instructions for USMT to migrate user files based on file name extensions. You can use the `MigUser.xml` file with the ScanState and LoadState tools to perform a more targeted migration than using USMT without XML instructions. The `MigUser.xml` file will gather all files from the standard user-profile folders, and any files on the computer with the specified file name extensions.
|
||||
|
||||
The default `MigUser.xml` file migrates the following data:
|
||||
|
||||
- All files from the standard user-profile folders, which are described as:
|
||||
- All files from the standard user-profile folders, which are described as:
|
||||
|
||||
- CSIDL\_MYVIDEO
|
||||
- CSIDL\_MYVIDEO
|
||||
|
||||
- CSIDL\_MYMUSIC
|
||||
- CSIDL\_MYMUSIC
|
||||
|
||||
- CSIDL\_DESKTOP
|
||||
- CSIDL\_DESKTOP
|
||||
|
||||
- CSIDL\_STARTMENU
|
||||
- CSIDL\_STARTMENU
|
||||
|
||||
- CSIDL\_PERSONAL
|
||||
- CSIDL\_PERSONAL
|
||||
|
||||
- CSIDL\_MYPICTURES
|
||||
- CSIDL\_MYPICTURES
|
||||
|
||||
- CSIDL\_FAVORITES
|
||||
- CSIDL\_FAVORITES
|
||||
|
||||
- CSIDL\_QUICK LAUNCH
|
||||
- CSIDL\_QUICK LAUNCH
|
||||
|
||||
- Files with the following extensions:
|
||||
- Files with the following extensions:
|
||||
|
||||
`.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`, `.or6`, `.accdb`, `.mdb`, `.pub`
|
||||
|
||||
The default `MigUser.xml` file doesn't migrate the following data:
|
||||
|
||||
- Files tagged with both the **hidden** and **system** attributes.
|
||||
- Files tagged with both the **hidden** and **system** attributes.
|
||||
|
||||
- Files and folders on removable drives,
|
||||
- Files and folders on removable drives,
|
||||
|
||||
- Data from the %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% folders.
|
||||
- Data from the %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% folders.
|
||||
|
||||
- ACLS for files in folders outside the user profile.
|
||||
- ACLS for files in folders outside the user profile.
|
||||
|
||||
You can make a copy of the `MigUser.xml` file and modify it to include or exclude standard user-profile folders and file name extensions. If you know all of the extensions for the files you want to migrate from the source computer, use the `MigUser.xml` file to move all of your relevant data, regardless of the location of the files. However, this provision may result in a migration that contains more files than intended. For example, if you choose to migrate all .jpg files, you may migrate image files such as thumbnails and logos from legacy applications that are installed on the source computer.
|
||||
|
||||
> [!NOTE]
|
||||
> Each file name extension you include in the rules within the `MigUser.xml` file increases the amount of time needed for the ScanState tool to gather the files for the migration. If you are migrating more than 300 file types, you may experience a slow migration. For more information about other ways to organize the migration of your data, see the [Using multiple XML files](#bkmk-multiple) section of this document.
|
||||
|
||||
## <a href="" id="bkmk-multiple"></a>Using multiple XML files
|
||||
## <a href="" id="bkmk-multiple"></a> Using multiple XML files
|
||||
|
||||
You can use multiple XML files with the ScanState and LoadState tools. Each of the default XML files included with or generated by USMT is configured for a specific component of the migration. You can also use custom XML files to supplement these default files with more migration rules.
|
||||
|
||||
|XML migration file|Modifies the following components:|
|
||||
|--- |--- |
|
||||
|Config.xml file|Operating-system components such as desktop wallpaper and background theme. <br/>You can also overload config.xml to include some application and document settings by generating the config.xml file with the other default XML files. For more information, see [Customize USMT XML Files](usmt-customize-xml-files.md) and [Config.xml File](usmt-configxml-file.md).|
|
||||
|Config.xml file|Operating-system components such as desktop wallpaper and background theme.<br/> You can also overload config.xml to include some application and document settings by generating the config.xml file with the other default XML files. For more information, see [Customize USMT XML Files](usmt-customize-xml-files.md) and [Config.xml File](usmt-configxml-file.md).|
|
||||
|MigApps.xml file|Applications settings.|
|
||||
|MigUser.xml or `MigDocs.xml` files|User files and profile settings.|
|
||||
|Custom XML files|Application settings, user profile settings, or user files, beyond the rules contained in the other XML files.|
|
||||
@ -191,7 +191,7 @@ For example, you can use all of the XML migration file types for a single migrat
|
||||
Scanstate.exe <store> /config:c:\myFolder\config.xml /i:migapps.xml /i:migdocs.xml /i:customrules.xml
|
||||
```
|
||||
|
||||
### <a href="" id="bkmk-userfiles"></a>XML rules for migrating user files
|
||||
### <a href="" id="bkmk-userfiles"></a> XML rules for migrating user files
|
||||
|
||||
> [!IMPORTANT]
|
||||
> You should not use the `MigUser.xml` and `MigDocs.xml` files together in the same command. Using both XML files can result in duplication of some migrated files. This occurs when conflicting target-location instructions are given in each XML file. The target file will be stored once during the migration, but will be applied by each XML file to a different location on the destination computer.
|
||||
@ -200,7 +200,7 @@ If your data set is unknown or if many files are stored outside of the standard
|
||||
|
||||
If you want more control over the migration, you can create custom XML files. See the [Creating and editing a custom ,xml file](#bkmk-createxml) section of this document.
|
||||
|
||||
## <a href="" id="bkmk-createxml"></a>Creating and editing a custom XML file
|
||||
## <a href="" id="bkmk-createxml"></a> Creating and editing a custom XML file
|
||||
|
||||
You can use the `/genmigxml` command-line option to determine which files will be included in your migration. The `/genmigxml` option creates a file in a location you specify, so that you can review the XML rules and make modifications as necessary.
|
||||
|
||||
@ -209,13 +209,13 @@ You can use the `/genmigxml` command-line option to determine which files will b
|
||||
|
||||
To generate the XML migration rules file for a source computer:
|
||||
|
||||
1. Select **Start** > **All Programs** > **Accessories**
|
||||
|
||||
2. Right-click **Command Prompt**, and then select **Run as**.
|
||||
1. Select **Start** > **All Programs** > **Accessories**
|
||||
|
||||
3. Select an account with administrator privileges, supply a password, and then select **OK**.
|
||||
2. Right-click **Command Prompt**, and then select **Run as**.
|
||||
|
||||
4. At the command prompt, type:
|
||||
3. Select an account with administrator privileges, supply a password, and then select **OK**.
|
||||
|
||||
4. At the command prompt, type:
|
||||
|
||||
```console
|
||||
cd /d <USMTpath>
|
||||
@ -229,7 +229,7 @@ To generate the XML migration rules file for a source computer:
|
||||
scanstate.exe /genmigxml:"C:\Documents and Settings\USMT Tester\Desktop\genMig.xml"
|
||||
```
|
||||
|
||||
### <a href="" id="bkmk-generate"></a>The GenerateDocPatterns function
|
||||
### <a href="" id="bkmk-generate"></a> The GenerateDocPatterns function
|
||||
|
||||
The `MigDocs.xml` file calls the `GenerateDocPatterns` function, which takes three Boolean values. You can change the settings to modify the way the `MigDocs.xml` file generates the XML rules for migration.
|
||||
|
||||
@ -287,67 +287,67 @@ To create exclude data patterns:
|
||||
</exclude>
|
||||
```
|
||||
|
||||
### <a href="" id="bkmk-context"></a>Understanding the system and user context
|
||||
### <a href="" id="bkmk-context"></a> Understanding the system and user context
|
||||
|
||||
The migration XML files contain two <component> elements with different **context** settings. The system context applies to files on the computer that aren't stored in the User Profiles directory, while the user context applies to files that are particular to an individual user.
|
||||
|
||||
**System context**
|
||||
#### System context
|
||||
|
||||
The system context includes rules for data outside of the User Profiles directory. For example, when called in a system context in the `MigDocs.xml` file, the `GenerateDocPatterns` function creates patterns for all common shell folders, files in the root directory of hard drives, and folders located at the root of hard drives. The following folders are included:
|
||||
|
||||
- CSIDL\_COMMON\_DESKTOPDIRECTORY
|
||||
- CSIDL\_COMMON\_DESKTOPDIRECTORY
|
||||
|
||||
- CSIDL\_COMMON\_FAVORITES
|
||||
- CSIDL\_COMMON\_FAVORITES
|
||||
|
||||
- CSIDL\_COMMON\_DOCUMENTS
|
||||
- CSIDL\_COMMON\_DOCUMENTS
|
||||
|
||||
- CSIDL\_COMMON\_MUSIC
|
||||
- CSIDL\_COMMON\_MUSIC
|
||||
|
||||
- CSIDL\_COMMON\_PICTURES
|
||||
- CSIDL\_COMMON\_PICTURES
|
||||
|
||||
- CSIDL\_COMMON\_VIDEO
|
||||
- CSIDL\_COMMON\_VIDEO
|
||||
|
||||
- FOLDERID\_PublicDownloads
|
||||
- FOLDERID\_PublicDownloads
|
||||
|
||||
**User context**
|
||||
#### User context
|
||||
|
||||
The user context includes rules for data in the User Profiles directory. When called in a user context in the `MigDocs.xml` file, the `GenerateDocPatterns` function creates patterns for all user shell folders, files located at the root of the profile, and folders located at the root of the profile. The following folders are included:
|
||||
|
||||
- CSIDL\_MYDOCUMENTS
|
||||
- CSIDL\_MYDOCUMENTS
|
||||
|
||||
- CSIDL\_MYPICTURES
|
||||
- CSIDL\_MYPICTURES
|
||||
|
||||
- FOLDERID\_OriginalImages
|
||||
- FOLDERID\_OriginalImages
|
||||
|
||||
- CSIDL\_MYMUSIC
|
||||
- CSIDL\_MYMUSIC
|
||||
|
||||
- CSIDL\_MYVIDEO
|
||||
- CSIDL\_MYVIDEO
|
||||
|
||||
- CSIDL\_FAVORITES
|
||||
- CSIDL\_FAVORITES
|
||||
|
||||
- CSIDL\_DESKTOP
|
||||
- CSIDL\_DESKTOP
|
||||
|
||||
- CSIDL\_QUICKLAUNCH
|
||||
- CSIDL\_QUICKLAUNCH
|
||||
|
||||
- FOLDERID\_Contacts
|
||||
- FOLDERID\_Contacts
|
||||
|
||||
- FOLDERID\_Libraries
|
||||
- FOLDERID\_Libraries
|
||||
|
||||
- FOLDERID\_Downloads
|
||||
- FOLDERID\_Downloads
|
||||
|
||||
- FOLDERID\_SavedGames
|
||||
- FOLDERID\_SavedGames
|
||||
|
||||
- FOLDERID\_RecordedTV
|
||||
- FOLDERID\_RecordedTV
|
||||
|
||||
> [!NOTE]
|
||||
> Rules contained in a component that is assigned the user context will be run for each user profile on the computer. Files that are scanned multiple times by the `MigDocs.xml` files will only be copied to the migration store once; however, a large number of rules in the user context can slow down the migration. Use the system context when it is applicable.
|
||||
|
||||
### <a href="" id="bkmk-samples"></a>Sample migration rules for customized versions of XML files
|
||||
### <a href="" id="bkmk-samples"></a> Sample migration rules for customized versions of XML files
|
||||
|
||||
> [!NOTE]
|
||||
> For best practices and requirements for customized XML files in USMT, see [Customize USMT XML Files](usmt-customize-xml-files.md) and [General Conventions](usmt-general-conventions.md).
|
||||
|
||||
### <a href="" id="bkmk-exclude"></a>Exclude rules usage examples
|
||||
### <a href="" id="bkmk-exclude"></a> Exclude rules usage examples
|
||||
|
||||
In the examples below, the source computer has a .txt file called "new text document" in a directory called "new folder". The default `MigDocs.xml` behavior migrates the new text document.txt file and all files contained in the "new folder" directory. The rules generated by the function are:
|
||||
|
||||
@ -358,7 +358,7 @@ In the examples below, the source computer has a .txt file called "new text docu
|
||||
|
||||
To exclude the new text document.txt file and any .txt files in "new folder", you can do the following modification:
|
||||
|
||||
**Example 1: Exclude all .txt files in a folder**
|
||||
#### Example 1: Exclude all .txt files in a folder
|
||||
|
||||
To exclude Rule 1, there needs to be an exact match of the file name. However, for Rule 2, you can create a pattern to exclude files by using the file name extension.
|
||||
|
||||
@ -371,7 +371,7 @@ To exclude Rule 1, there needs to be an exact match of the file name. However, f
|
||||
</exclude>
|
||||
```
|
||||
|
||||
**Example 2: Use the UnconditionalExclude element to give a rule precedence over include rules**
|
||||
#### Example 2: Use the UnconditionalExclude element to give a rule precedence over include rules
|
||||
|
||||
If you don't know the file name or location of the file, but you do know the file name extension, you can use the `GenerateDrivePatterns` function. However, the rule will be less specific than the default include rule generated by the `MigDocs.xml` file, so it will not have precedence. You must use the <UnconditionalExclude> element to give this rule precedence over the default include rule. For more information about the order of precedence for XML migration rules, see [Conflicts and Precedence](usmt-conflicts-and-precedence.md).
|
||||
|
||||
@ -383,9 +383,9 @@ If you don't know the file name or location of the file, but you do know the fil
|
||||
</unconditionalExclude>
|
||||
```
|
||||
|
||||
**Example 3 : Use a UserandSystem context component to run rules in both contexts**
|
||||
#### Example 3 : Use a UserandSystem context component to run rules in both contexts
|
||||
|
||||
If you want the <UnconditionalExclude> element to apply to both the system and user context, you can create a third component using the **UserandSystem** context. Rules in this component will be run in both contexts.
|
||||
If you want the **<UnconditionalExclude>** element to apply to both the system and user context, you can create a third component using the **UserandSystem** context. Rules in this component will be run in both contexts.
|
||||
|
||||
``` xml
|
||||
<component type="Documents" context="UserandSystem">
|
||||
@ -404,11 +404,11 @@ If you want the <UnconditionalExclude> element to apply to both the system
|
||||
|
||||
For more examples of exclude rules that you can use in custom migration XML files, see [Exclude Files and Settings](usmt-exclude-files-and-settings.md).
|
||||
|
||||
### <a href="" id="bkmk-include"></a>Include rules usage examples
|
||||
### <a href="" id="bkmk-include"></a> Include rules usage examples
|
||||
|
||||
The application data directory is the most common location that you would need to add an include rule for. The `GenerateDocPatterns` function excludes this location by default. If your company uses an application that saves important data to this location, you can create include rules to migrate the data. For example, the default location for .pst files is: `%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook`. The `MigApp.xml` file contains migration rules to move only those .pst files that are linked to Microsoft Outlook. To include .pst files that aren't linked, you can do the following modification:
|
||||
|
||||
**Example 1: Include a file name extension in a known user folder**
|
||||
#### Example 1: Include a file name extension in a known user folder
|
||||
|
||||
This rule will include .pst files that are located in the default location, but aren't linked to Microsoft Outlook. Use the user context to run this rule for each user on the computer.
|
||||
|
||||
@ -420,7 +420,7 @@ This rule will include .pst files that are located in the default location, but
|
||||
</include>
|
||||
```
|
||||
|
||||
**Example 2: Include a file name extension in Program Files**
|
||||
#### Example 2: Include a file name extension in Program Files
|
||||
|
||||
For locations outside the user profile, such as the Program Files folder, you can add the rule to the system context component.
|
||||
|
||||
@ -437,7 +437,7 @@ For more examples of include rules that you can use in custom migration XML file
|
||||
> [!NOTE]
|
||||
> For more information about the order of precedence for XML migration rules, see [Conflicts and Precedence](usmt-conflicts-and-precedence.md).
|
||||
|
||||
## <a href="" id="bkmk-next"></a>Next steps
|
||||
## <a href="" id="bkmk-next"></a> Next steps
|
||||
|
||||
You can include additional rules for the migration in the `MigDocs.xml` file or other XML migration files. For example, you can use the `<locationModify>` element to move files from the folder where they were gathered to a different folder, when they're applied to the destination computer.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user