Update review date on reviewed articles

This commit is contained in:
Frank Rojas 2025-01-29 15:35:05 -05:00
parent 73c5fec9d3
commit 24c2e18504
50 changed files with 129 additions and 129 deletions

View File

@ -8,7 +8,7 @@ ms.service: windows-client
author: frankroj author: frankroj
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
ms.date: 08/30/2024 ms.date: 01/29/2025
appliesto: appliesto:
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a>
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 08/30/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -50,7 +50,7 @@ For exceptions to what can be migrated offline, see [What Does USMT Migrate?](us
## What offline environments are supported? ## What offline environments are supported?
All currently supported All currently supported
The following table defines the supported combination of online and offline operating systems in USMT. The following table defines the supported combination of online and offline operating systems in USMT.
@ -183,9 +183,9 @@ The following XML example illustrates some of the elements discussed earlier in
```xml ```xml
<offline> <offline>
<winDir> <winDir>
<path>C:\Windows</path> <path>C:\Windows</path>
<path>D:\Windows</path> <path>D:\Windows</path>
<path>E:\</path> <path>E:\</path>
</winDir> </winDir>
<failOnMultipleWinDir>1</failOnMultipleWinDir> <failOnMultipleWinDir>1</failOnMultipleWinDir>
</offline> </offline>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -496,7 +496,7 @@ The following sample `Config.xml` file contains detailed examples about items th
</changeGroup> </changeGroup>
</mappings> </mappings>
</localGroups> </localGroups>
--> -->
</ProfileControl> </ProfileControl>
</Configuration> </Configuration>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -79,7 +79,7 @@ Specifying `migrate="no"` in the `Config.xml` file is the same as deleting the c
<objectSet> <objectSet>
<pattern type="File">%CSIDL_PERSONAL%\* [*.doc] </pattern> <pattern type="File">%CSIDL_PERSONAL%\* [*.doc] </pattern>
</objectSet> </objectSet>
</include> </include>
``` ```
### How does USMT process each component in an .xml file with multiple components? ### How does USMT process each component in an .xml file with multiple components?
@ -116,7 +116,7 @@ In the following example, mp3 files aren't excluded from the migration. The mp3
<objectSet> <objectSet>
<pattern type="File"> C:\* [*.mp3]</pattern> <pattern type="File"> C:\* [*.mp3]</pattern>
</objectSet> </objectSet>
</exclude> </exclude>
``` ```
### \<include\> and \<exclude\> rules precedence examples ### \<include\> and \<exclude\> rules precedence examples
@ -185,11 +185,11 @@ The destination computer contains the following files:
A custom **.xml** file contains the following code: A custom **.xml** file contains the following code:
```xml ```xml
<include> <include>
<objectSet> <objectSet>
<pattern type="File">c:\data\* [*]</pattern> <pattern type="File">c:\data\* [*]</pattern>
</objectSet> </objectSet>
</include> </include>
``` ```
For this example, the following information describes the resulting behavior if the code is added to the custom **.xml** file. For this example, the following information describes the resulting behavior if the code is added to the custom **.xml** file.

View File

@ -8,7 +8,7 @@ ms.service: windows-client
author: frankroj author: frankroj
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
ms.date: 01/09/2024 ms.date: 01/29/2025
appliesto: appliesto:
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a>
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a>
@ -120,7 +120,7 @@ The following sample is a custom **.xml** file named `CustomFile.xml` that migra
<component type="Documents" context="User"> <component type="Documents" context="User">
<displayName>My Video</displayName> <displayName>My Video</displayName>
<role role="Data"> <role role="Data">
<detects> <detects>
<detect> <detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYVIDEO%")</condition> <condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYVIDEO%")</condition>
</detect> </detect>
@ -251,8 +251,8 @@ The behavior for this custom **.xml** file is described within the `<displayName
<rules> <rules>
<include> <include>
<objectSet> <objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("\Requests\* [*] ", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns ("\Requests\* [*] ", "Fixed")</script>
<script>MigXmlHelper.GenerateDrivePatterns ("*\Requests\* [*] ", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns ("*\Requests\* [*] ", "Fixed")</script>
</objectSet> </objectSet>
</include> </include>
</rules> </rules>
@ -264,7 +264,7 @@ The behavior for this custom **.xml** file is described within the `<displayName
<role role="Data"> <role role="Data">
<rules> <rules>
<include> <include>
<objectSet> <objectSet>
<pattern type="File"> C:\*\Presentations\* [*]</pattern> <pattern type="File"> C:\*\Presentations\* [*]</pattern>
<pattern type="File"> C:\Presentations\* [*]</pattern> <pattern type="File"> C:\Presentations\* [*]</pattern>
</objectSet> </objectSet>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -11,12 +11,12 @@ metadata:
ms.mktglfcycl: deploy ms.mktglfcycl: deploy
ms.sitesec: library ms.sitesec: library
audience: itpro audience: itpro
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: faq ms.topic: faq
title: Frequently Asked Questions title: Frequently Asked Questions
summary: | summary: |
**Applies to:** **Applies to:**
- Windows 11 - Windows 11
- Windows 10 - Windows 10
@ -30,13 +30,13 @@ sections:
How much space is needed on the destination computer? How much space is needed on the destination computer?
answer: | answer: |
The destination computer needs enough available space for the following items: The destination computer needs enough available space for the following items:
- Operating system - Operating system
- Applications - Applications
- Uncompressed store - Uncompressed store
- question: | - question: |
Can the files and settings be stored directly on the destination computer or is a server needed? Can the files and settings be stored directly on the destination computer or is a server needed?
answer: | answer: |
@ -47,13 +47,13 @@ sections:
- Directly on the destination computer. - Directly on the destination computer.
To store it directly on the destination computer: To store it directly on the destination computer:
1. Create and share the directory `C:\store` on the destination computer. 1. Create and share the directory `C:\store` on the destination computer.
1. Run the **ScanState** tool on the source computer and save the files and settings to `\\<DestinationComputerName>\store` 1. Run the **ScanState** tool on the source computer and save the files and settings to `\\<DestinationComputerName>\store`
1. Run the **LoadState** tool on the destination computer and specify `C:\store` as the store location. 1. Run the **LoadState** tool on the destination computer and specify `C:\store` as the store location.
- question: | - question: |
Can data be migrated between operating systems with different languages? Can data be migrated between operating systems with different languages?
answer: | answer: |
@ -80,7 +80,7 @@ sections:
How can a folder or a certain type of file be excluded from the migration? How can a folder or a certain type of file be excluded from the migration?
answer: | answer: |
The **\<unconditionalExclude\>** element can be used to globally exclude data from the migration. For example, this element can be used to exclude all MP3 files on the computer or to exclude all files from `C:\UserData`. This element excludes objects regardless of any other **\<include\>** rules that are in the **.xml** files. For an example, see **\<unconditionalExclude\>** in the [Exclude files and settings](usmt-exclude-files-and-settings.md) article. For the syntax of this element, see [XML elements library](usmt-xml-elements-library.md). The **\<unconditionalExclude\>** element can be used to globally exclude data from the migration. For example, this element can be used to exclude all MP3 files on the computer or to exclude all files from `C:\UserData`. This element excludes objects regardless of any other **\<include\>** rules that are in the **.xml** files. For an example, see **\<unconditionalExclude\>** in the [Exclude files and settings](usmt-exclude-files-and-settings.md) article. For the syntax of this element, see [XML elements library](usmt-xml-elements-library.md).
- question: | - question: |
What happens to files that were located on a drive that don't exist on the destination computer? What happens to files that were located on a drive that don't exist on the destination computer?
answer: | answer: |
@ -91,22 +91,22 @@ sections:
- C:\\ is the system drive on the destination computer. - C:\\ is the system drive on the destination computer.
the file is migrated to `C:\data\File.pst`. This behavior holds true even when **\<locationModify\>** rules attempt to move data to a drive that doesn't exist on the destination computer. the file is migrated to `C:\data\File.pst`. This behavior holds true even when **\<locationModify\>** rules attempt to move data to a drive that doesn't exist on the destination computer.
- name: USMT .xml Files - name: USMT .xml Files
questions: questions:
- question: | - question: |
Where are there examples of USMT **.xml** files? Where are there examples of USMT **.xml** files?
answer: | answer: |
The following articles include examples of USMT **.xml** files: The following articles include examples of USMT **.xml** files:
- [Exclude files and settings](usmt-exclude-files-and-settings.md) - [Exclude files and settings](usmt-exclude-files-and-settings.md)
- [Reroute files and settings](usmt-reroute-files-and-settings.md) - [Reroute files and settings](usmt-reroute-files-and-settings.md)
- [Include files and settings](usmt-include-files-and-settings.md) - [Include files and settings](usmt-include-files-and-settings.md)
- [Custom XML examples](usmt-custom-xml-examples.md) - [Custom XML examples](usmt-custom-xml-examples.md)
- question: | - question: |
Can custom **.xml** files that were written for USMT 5.0 be used? Can custom **.xml** files that were written for USMT 5.0 be used?
answer: | answer: |
@ -121,9 +121,9 @@ sections:
Why must the **.xml** files be included with both the `ScanState.exe` and `LoadState.exe` commands? Why must the **.xml** files be included with both the `ScanState.exe` and `LoadState.exe` commands?
answer: | answer: |
The **.xml** files aren't copied to the store as in previous versions of USMT. Because the **ScanState** and **LoadState** tools need the **.xml** files to control the migration, the same set of **.xml** files must be specified for the `ScanState.exe` and `LoadState.exe` commands. If a particular set of mig\*.xml files were used in the **ScanState** tool, either called through the `/auto` option, or individually through the `/i` option, then the same option should be used to call the exact same mig\*.xml files in the **LoadState** tool. However, the `Config.xml` file doesn't need to be specified, unless files and settings that were migrated to the store need to be excluded. For example, the **Documents** folder might be migrated to the store, but not to the destination computer. To do this type of migration, modify the `Config.xml` file and specify the updated file with the `LoadState.exe` command. **LoadState** migrates only the desired files and settings. The **.xml** files aren't copied to the store as in previous versions of USMT. Because the **ScanState** and **LoadState** tools need the **.xml** files to control the migration, the same set of **.xml** files must be specified for the `ScanState.exe` and `LoadState.exe` commands. If a particular set of mig\*.xml files were used in the **ScanState** tool, either called through the `/auto` option, or individually through the `/i` option, then the same option should be used to call the exact same mig\*.xml files in the **LoadState** tool. However, the `Config.xml` file doesn't need to be specified, unless files and settings that were migrated to the store need to be excluded. For example, the **Documents** folder might be migrated to the store, but not to the destination computer. To do this type of migration, modify the `Config.xml` file and specify the updated file with the `LoadState.exe` command. **LoadState** migrates only the desired files and settings.
If an **.xml** file is excluded from the `LoadState.exe` command, then all of the data in the store that was migrated with the missing **.xml** files are migrated. However, the migration rules that were specified for the `ScanState.exe` command don't apply. For example, if a `MigApp.xml` file that has a rerouting rule such as `MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")` is excluded, USMT doesn't reroute the files. Instead, it migrates them to `C:\data`. If an **.xml** file is excluded from the `LoadState.exe` command, then all of the data in the store that was migrated with the missing **.xml** files are migrated. However, the migration rules that were specified for the `ScanState.exe` command don't apply. For example, if a `MigApp.xml` file that has a rerouting rule such as `MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")` is excluded, USMT doesn't reroute the files. Instead, it migrates them to `C:\data`.
- question: | - question: |
Which files can be modified and specified on the command line? Which files can be modified and specified on the command line?
answer: | answer: |
@ -133,20 +133,20 @@ sections:
What happens if the **.xml** files aren't specified on the command line? What happens if the **.xml** files aren't specified on the command line?
answer: | answer: |
- **ScanState** - **ScanState**
If no files are specified with the `ScanState.exe` command, all user accounts and default operating system components are migrated. If no files are specified with the `ScanState.exe` command, all user accounts and default operating system components are migrated.
- **LoadState** - **LoadState**
If no files are specified with the `LoadState.exe` command, all data that is in the store is migrated. However, any target-specific migration rules that were specified in **.xml** files with the `ScanState.exe` command doesn't apply. For example, if a `MigApp.xml` file that has a rerouting rule such as `MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")` is excluded, USMT doesn't reroute the files. Instead, it migrates them to `C:\data`. If no files are specified with the `LoadState.exe` command, all data that is in the store is migrated. However, any target-specific migration rules that were specified in **.xml** files with the `ScanState.exe` command doesn't apply. For example, if a `MigApp.xml` file that has a rerouting rule such as `MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")` is excluded, USMT doesn't reroute the files. Instead, it migrates them to `C:\data`.
- name: Conflicts and Precedence - name: Conflicts and Precedence
questions: questions:
- question: | - question: |
What happens when there are conflicting XML rules or conflicting objects on the destination computer? What happens when there are conflicting XML rules or conflicting objects on the destination computer?
answer: | answer: |
For more information, see [Conflicts and precedence](usmt-conflicts-and-precedence.md). For more information, see [Conflicts and precedence](usmt-conflicts-and-precedence.md).
additionalContent: | additionalContent: |

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -73,21 +73,21 @@ The XML helper functions in the [XML elements library](usmt-xml-elements-library
The encoded location is composed of the node part, optionally followed by the leaf enclosed in square brackets. This format makes a clear distinction between nodes and leaves. The encoded location is composed of the node part, optionally followed by the leaf enclosed in square brackets. This format makes a clear distinction between nodes and leaves.
For example, specify the file For example, specify the file
`C:\Windows\Notepad.exe` `C:\Windows\Notepad.exe`
as as
**c:\\Windows\[Notepad.exe\]** **c:\\Windows\[Notepad.exe\]**
Similarly, specify the directory Similarly, specify the directory
`C:\Windows\System32` `C:\Windows\System32`
as as
**c:\\Windows\\System32** **c:\\Windows\\System32**
Note the absence of the **\[\]** characters in second example. Note the absence of the **\[\]** characters in second example.
The registry is represented in a similar way. The default value of a registry key is represented as an empty **\[\]** construct. For example, the default value for the `HKLM\SOFTWARE\MyKey` registry key is **HKLM\\SOFTWARE\\MyKey\[\]**. The registry is represented in a similar way. The default value of a registry key is represented as an empty **\[\]** construct. For example, the default value for the `HKLM\SOFTWARE\MyKey` registry key is **HKLM\\SOFTWARE\\MyKey\[\]**.

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -8,7 +8,7 @@ ms.service: windows-client
author: frankroj author: frankroj
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
ms.date: 01/09/2024 ms.date: 01/29/2025
appliesto: appliesto:
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a>
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a>
@ -33,7 +33,7 @@ When the **ScanState** tool runs on the source computer, it goes through the fol
There are three types of components: There are three types of components:
- Components that migrate the operating system settings. - Components that migrate the operating system settings.
- Components that migrate application settings. - Components that migrate application settings.
- Components that migrate users' files. - Components that migrate users' files.

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -9,7 +9,7 @@ author: frankroj
ms.topic: conceptual ms.topic: conceptual
ms.localizationpriority: medium ms.localizationpriority: medium
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
ms.date: 01/09/2024 ms.date: 01/29/2025
appliesto: appliesto:
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 11</a>
- ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a> - ✅ <a href="https://learn.microsoft.com/windows/release-health/supported-versions-windows-client" target="_blank">Windows 10</a>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -25,12 +25,12 @@ The following **.xml** file migrates a single registry key.
```xml ```xml
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/test"> <migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Application" context="System"> <component type="Application" context="System">
<displayName>Component to migrate only registry value string</displayName> <displayName>Component to migrate only registry value string</displayName>
<role role="Settings"> <role role="Settings">
<rules> <rules>
<include> <include>
<objectSet> <objectSet>
<pattern type="Registry">HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Cache [Persistent]</pattern> <pattern type="Registry">HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Cache [Persistent]</pattern>
</objectSet> </objectSet>
</include> </include>
</rules> </rules>
@ -95,8 +95,8 @@ The following **.xml** file migrates all files and subfolders of the `Engineerin
<rules> <rules>
<include> <include>
<objectSet> <objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("\EngineeringDrafts\* [*] ", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns ("\EngineeringDrafts\* [*] ", "Fixed")</script>
<script>MigXmlHelper.GenerateDrivePatterns ("*\EngineeringDrafts\* [*] ", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns ("*\EngineeringDrafts\* [*] ", "Fixed")</script>
</objectSet> </objectSet>
</include> </include>
</rules> </rules>
@ -114,7 +114,7 @@ The following **.xml** file migrates all files and subfolders of the `Engineerin
<role role="Data"> <role role="Data">
<rules> <rules>
<include> <include>
<objectSet> <objectSet>
<pattern type="File"> C:\*\EngineeringDrafts\* [*]</pattern> <pattern type="File"> C:\*\EngineeringDrafts\* [*]</pattern>
<pattern type="File"> C:\EngineeringDrafts\* [*]</pattern> <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
</objectSet> </objectSet>
@ -149,7 +149,7 @@ The following **.xml** file migrates `.mp3` files located in the specified drive
</rules> </rules>
</role> </role>
</component> </component>
</migration> </migration>
``` ```
## Migrate a specific file ## Migrate a specific file

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 04/30/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -7,7 +7,7 @@ author: frankroj
ms.reviewer: kevinmi,warrenw ms.reviewer: kevinmi,warrenw
manager: aaroncz manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: overview ms.topic: overview
ms.collection: ms.collection:
- highpri - highpri

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -7,7 +7,7 @@ ms.reviewer: kevinmi,warrenw
manager: aaroncz manager: aaroncz
ms.author: frankroj ms.author: frankroj
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.collection: ms.collection:
- highpri - highpri

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 04/30/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -70,7 +70,7 @@ The following custom **.xml** file reroutes **.mp3** files located in the fixed
</rules> </rules>
</role> </role>
</component> </component>
</migration> </migration>
``` ```
## Reroute a specific file ## Reroute a specific file
@ -83,8 +83,8 @@ The following custom **.xml** file migrates the `Sample.doc` file from `C:\Engin
<displayName>Sample.doc into the Documents folder</displayName> <displayName>Sample.doc into the Documents folder</displayName>
<role role="Data"> <role role="Data">
<rules> <rules>
<include> <include>
<objectSet> <objectSet>
<pattern type="File"> C:\EngineeringDrafts\ [Sample.doc]</pattern> <pattern type="File"> C:\EngineeringDrafts\ [Sample.doc]</pattern>
</objectSet> </objectSet>
</include> </include>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -23,7 +23,7 @@ appliesto:
- Microsoft Visual Studio - Microsoft Visual Studio
- The User State Migration Tool (USMT) XML schema (the `MigXML.xsd` file) can be used to validate the migration **.xml** files using an XML authoring tool such as Microsoft Visual Studio. - The User State Migration Tool (USMT) XML schema (the `MigXML.xsd` file) can be used to validate the migration **.xml** files using an XML authoring tool such as Microsoft Visual Studio.
For more information about how to use the schema with an XML authoring environment, see the environment's documentation. For more information about how to use the schema with an XML authoring environment, see the environment's documentation.
- [Ask the Directory Services Team blog](https://techcommunity.microsoft.com/t5/ask-the-directory-services-team/bg-p/AskDS). - [Ask the Directory Services Team blog](https://techcommunity.microsoft.com/t5/ask-the-directory-services-team/bg-p/AskDS).

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 04/30/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/18/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:
@ -95,7 +95,7 @@ The following example is from the `MigApp.xml` file:
<location type="Registry">%HklmWowSoftware%\Microsoft\Office\16.0\Common\Migration\Office [Lang]</location> <location type="Registry">%HklmWowSoftware%\Microsoft\Office\16.0\Common\Migration\Office [Lang]</location>
<attributes>DWORD</attributes> <attributes>DWORD</attributes>
<bytes>00000000</bytes> <bytes>00000000</bytes>
</object> </object>
``` ```
## \<bytes\> ## \<bytes\>
@ -127,7 +127,7 @@ The following example is from the `MigApp.xml` file:
<location type="Registry">%HklmWowSoftware%\Microsoft\Office\16.0\Common\Migration\Office [Lang]</location> <location type="Registry">%HklmWowSoftware%\Microsoft\Office\16.0\Common\Migration\Office [Lang]</location>
<attributes>DWORD</attributes> <attributes>DWORD</attributes>
<bytes>00000000</bytes> <bytes>00000000</bytes>
</object> </object>
``` ```
## \<commandLine\> ## \<commandLine\>
@ -1070,10 +1070,10 @@ Example:
</externalProcess> </externalProcess>
</rules> </rules>
</role> </role>
<!-- Migrate <!-- Migrate
all doc files from the system all doc files from the system
all power point files all power point files
all visio design files all visio design files
all my c++ program files --> all my c++ program files -->
<extensions> <extensions>
<extension>DOC</extension> <extension>DOC</extension>
@ -1126,18 +1126,18 @@ Syntax:
For example, to migrate all \*.doc files from the source computer, specifying the following code under the **\<component\>** element: For example, to migrate all \*.doc files from the source computer, specifying the following code under the **\<component\>** element:
```xml ```xml
<extensions> <extensions>
<extension>doc</extension> <extension>doc</extension>
<extensions> <extensions>
``` ```
is the same as specifying the following code below the **\<rules\>** element: is the same as specifying the following code below the **\<rules\>** element:
```xml ```xml
<include> <include>
<objectSet> <objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("* [*.doc]", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns ("* [*.doc]", "Fixed")</script>
</objectSet> </objectSet>
</include> </include>
``` ```
@ -1202,7 +1202,7 @@ The following example is from the `MigUser.xml` file:
<path type="File">%CSIDL_MYVIDEO%</path> <path type="File">%CSIDL_MYVIDEO%</path>
</paths> </paths>
<role role="Data"> <role role="Data">
<detects> <detects>
<detect> <detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYVIDEO%")</condition> <condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYVIDEO%")</condition>
</detect> </detect>
@ -1702,11 +1702,11 @@ The following example is from the `MigUser.xml` file:
<path type="File">%CSIDL_MYMUSIC%</path> <path type="File">%CSIDL_MYMUSIC%</path>
</paths> </paths>
<role role="Data"> <role role="Data">
<detects> <detects>
<detect> <detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYMUSIC%")</condition> <condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYMUSIC%")</condition>
</detect> </detect>
</detects> </detects>
<rules> <rules>
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'> <include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet> <objectSet>
@ -1846,11 +1846,11 @@ The following example is from the `MigUser.xml` file. For more examples, see the
<path type="File">%CSIDL_STARTMENU%</path> <path type="File">%CSIDL_STARTMENU%</path>
</paths> </paths>
<role role="Settings"> <role role="Settings">
<detects> <detects>
<detect> <detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_STARTMENU%")</condition> <condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_STARTMENU%")</condition>
</detect> </detect>
</detects> </detects>
<rules> <rules>
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'> <include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet> <objectSet>
@ -1901,11 +1901,11 @@ The following example is from the `MigUser.xml` file:
<path type="File">%CSIDL_MYMUSIC%</path> <path type="File">%CSIDL_MYMUSIC%</path>
</paths> </paths>
<role role="Data"> <role role="Data">
<detects> <detects>
<detect> <detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYMUSIC%")</condition> <condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYMUSIC%")</condition>
</detect> </detect>
</detects> </detects>
<rules> <rules>
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'> <include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet> <objectSet>
@ -1969,7 +1969,7 @@ Examples:
To migrate the Sample.doc file from any drive on the source computer, use **\<script\>** as follows. If multiple files exist with the same name, all such files get migrated. To migrate the Sample.doc file from any drive on the source computer, use **\<script\>** as follows. If multiple files exist with the same name, all such files get migrated.
```xml ```xml
<script>MigXmlHelper.GenerateDrivePatterns("* [sample.doc]", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns("* [sample.doc]", "Fixed")</script>
``` ```
For more examples of how to use this element, see [Exclude Files and Settings](usmt-exclude-files-and-settings.md), [Reroute Files and Settings](usmt-reroute-files-and-settings.md), and [Custom XML Examples](usmt-custom-xml-examples.md). For more examples of how to use this element, see [Exclude Files and Settings](usmt-exclude-files-and-settings.md), [Reroute Files and Settings](usmt-reroute-files-and-settings.md), and [Custom XML Examples](usmt-custom-xml-examples.md).
@ -2171,7 +2171,7 @@ For example:
```xml ```xml
<variable name="QuickTime5or6DataSys"> <variable name="QuickTime5or6DataSys">
<text>%CSIDL_COMMON_APPDATA%\QuickTime</text> <text>%CSIDL_COMMON_APPDATA%\QuickTime</text>
</variable> </variable>
``` ```
@ -2204,7 +2204,7 @@ The following **.xml** file excludes all `.mp3` files from migration. For additi
<unconditionalExclude> <unconditionalExclude>
<objectSet> <objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script> <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
</objectSet> </objectSet>
</unconditionalExclude> </unconditionalExclude>
</rules> </rules>
</role> </role>

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto:

View File

@ -6,7 +6,7 @@ manager: aaroncz
ms.author: frankroj ms.author: frankroj
ms.service: windows-client ms.service: windows-client
author: frankroj author: frankroj
ms.date: 01/09/2024 ms.date: 01/29/2025
ms.topic: conceptual ms.topic: conceptual
ms.subservice: itpro-deploy ms.subservice: itpro-deploy
appliesto: appliesto: