mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-23 14:23:38 +00:00
Metadata update deployment/usmt 7
This commit is contained in:
Frank Rojas
@ -28,47 +28,69 @@ For more information about using the `Config.xml` file with other migration file
|
||||
|
||||
In USMT there are new migration policies that can be configured in the `Config.xml` file. For example, you can configure additional **<ErrorControl>**, **<ProfileControl>**, and **<HardLinkStoreControl>** options. The following elements and parameters are for use in the `Config.xml` file only.
|
||||
|
||||
[<Policies>](#bkmk-policies)
|
||||
[<Policies>](#policies)
|
||||
|
||||
[<ErrorControl>](#errorcontrol)
|
||||
|
||||
<!--
|
||||
|
||||
[<ProfileControl>](#profilecontrol)
|
||||
|
||||
[<HardLinkStoreControl>](#hardlinkstorecontrol)
|
||||
|
||||
[<Components>](#components)
|
||||
|
||||
[<Component>](#component)
|
||||
|
||||
[<Applications>](#applications)
|
||||
|
||||
[<Application>](#application)
|
||||
|
||||
[<UserDocuments>](#userdocuments)
|
||||
|
||||
[<UserDocument>](#userdocument)
|
||||
|
||||
[<ErrorControl>](#bkmk-errorcontrol)
|
||||
|
||||
[<fatal>](#bkmk-fatal)
|
||||
-->
|
||||
|
||||
[<fileError>](#bkmk-fileerror)
|
||||
[<fatal>](#fatal)
|
||||
|
||||
[<nonfatal>](#bkmk-nonfatal)
|
||||
[<fileError>](#fileerror)
|
||||
|
||||
[<registryError>](#bkmk-registryerror)
|
||||
[<nonfatal>](#nonfatal)
|
||||
|
||||
[<HardLinkStoreControl>](#bkmk-hardlinkstorecontrol)
|
||||
[<registryError>](#registryerror)
|
||||
|
||||
[<fileLocked>](#bkmk-filelock)
|
||||
[<HardLinkStoreControl>](#hardlinkstorecontrol)
|
||||
|
||||
[<createHardLink>](#bkmk-createhardlink)
|
||||
[<fileLocked>](#filelocked)
|
||||
|
||||
[<errorHardLink>](#bkmk-errorhardlink)
|
||||
[<createHardLink>](#createhardlink)
|
||||
|
||||
[<ProfileControl>](#bkmk-profilecontrol)
|
||||
[<errorHardLink>](#errorhardlink)
|
||||
|
||||
[<localGroups>](#bkmk-localgroups)
|
||||
[<ProfileControl>](#profilecontrol)
|
||||
|
||||
[<mappings>](#bkmk-mappings)
|
||||
[<localGroups>](#localgroups)
|
||||
|
||||
[<changeGroup>](#bkmk-changegrou)
|
||||
[<mappings>](#mappings)
|
||||
|
||||
[<include>](#bkmk-include)
|
||||
[<changeGroup>](#changegroup)
|
||||
|
||||
[<exclude>](#bkmk-exclude)
|
||||
[<include>](#include)
|
||||
|
||||
[Sample Config.xml File](#bkmk-sampleconfigxjmlfile)
|
||||
[<exclude>](#exclude)
|
||||
|
||||
## <a href="" id="bkmk-policies"></a> <Policies>
|
||||
[Sample Config.xml File](#sample-configxml-file)
|
||||
|
||||
## <Policies>
|
||||
|
||||
The **<Policies>** element contains elements that describe the policies that USMT follows while creating a migration store. Valid children of the **<Policies>** element are **<ErrorControl>** and **<HardLinkStoreControl>**. The **<Policies>** element is a child of **<Configuration>**.
|
||||
|
||||
Syntax: `<Policies>` `</Policies>`
|
||||
|
||||
## <a href="" id="bkmk-errorcontrol"></a> <ErrorControl>
|
||||
## <ErrorControl>
|
||||
|
||||
The **<ErrorControl>** element is an optional element you can configure in the `Config.xml` file. The configurable **<ErrorControl>** rules support only the environment variables for the operating system that is running and the currently logged-on user. As a workaround, you can specify a path using the (\*) wildcard character.
|
||||
|
||||
@ -99,7 +121,7 @@ Additionally, the order in the **<ErrorControl>** section implies priority
|
||||
> [!IMPORTANT]
|
||||
> The configurable **<ErrorControl>** rules support only the environment variables for the operating system that is running and the currently logged-on user. As a workaround, you can specify a path using the (\*) wildcard character.
|
||||
|
||||
### <a href="" id="bkmk-fatal"></a> <fatal>
|
||||
### <fatal>
|
||||
|
||||
The **<fatal>** element isn't required.
|
||||
|
||||
@ -117,7 +139,7 @@ Syntax: `<fatal errorCode="any">` *<pattern>* `</fatal>`
|
||||
|
||||
You use the **<fatal>** element to specify that errors matching a specific pattern should cause USMT to halt the migration.
|
||||
|
||||
## <a href="" id="bkmk-fileerror"></a> <fileError>
|
||||
## <fileError>
|
||||
|
||||
The **<fileError>** element isn't required.
|
||||
|
||||
@ -131,7 +153,7 @@ Syntax: `<fileError>` `</fileError>`
|
||||
|
||||
You use the **<fileError>** element to represent the behavior associated with file errors.
|
||||
|
||||
## <a href="" id="bkmk-nonfatal"></a> <nonFatal>
|
||||
## <nonFatal>
|
||||
|
||||
The **<nonFatal>** element isn't required.
|
||||
|
||||
@ -149,7 +171,7 @@ Syntax: `<nonfatal errorCode="any">` *<pattern>* `</nonFatal>`
|
||||
|
||||
You use the **<nonFatal>** element to specify that errors matching a specific pattern shouldn't cause USMT to halt the migration.
|
||||
|
||||
## <a href="" id="bkmk-registryerror"></a> <registryError>
|
||||
## <registryError>
|
||||
|
||||
The **<registryError>** element isn't required.
|
||||
|
||||
@ -167,7 +189,7 @@ Syntax: `<registryError>` `</registryError>`
|
||||
|
||||
You use the **<registryError>** element to specify that errors matching a specific pattern shouldn't cause USMT to halt the migration.
|
||||
|
||||
## <a href="" id="bkmk-hardlinkstorecontrol"></a> <HardLinkStoreControl>
|
||||
## <HardLinkStoreControl>
|
||||
|
||||
The **<HardLinkStoreControl>** element contains elements that describe how to handle files during the creation of a hard-link migration store. Its only valid child is **<fileLocked>**.
|
||||
|
||||
@ -200,43 +222,43 @@ The **<HardLinkStoreControl>** sample code below specifies that hard links
|
||||
</Policy>
|
||||
```
|
||||
|
||||
## <a href="" id="bkmk-filelock"></a> <fileLocked>
|
||||
## <fileLocked>
|
||||
|
||||
The **<fileLocked>** element contains elements that describe how to handle files that are locked for editing. The rules defined by the **<fileLocked>** element are processed in the order in which they appear in the XML file.
|
||||
|
||||
Syntax: `<fileLocked>` `</fileLocked>`
|
||||
|
||||
## <a href="" id="bkmk-createhardlink"></a> <createHardLink>
|
||||
## <createHardLink>
|
||||
|
||||
The **<createHardLink>** element defines a standard MigXML pattern that describes file paths where hard links should be created, even if the file is locked for editing by another application.
|
||||
|
||||
Syntax: `<createHardLink>` *<pattern>* `</createHardLink>`
|
||||
|
||||
## <a href="" id="bkmk-errorhardlink"></a> <errorHardLink>
|
||||
## <errorHardLink>
|
||||
|
||||
The **<errorHardLink>** element defines a standard MigXML pattern that describes file paths where hard links shouldn't be created if the file is locked for editing by another application. USMT will attempt to copy files under these paths into the migration store. However, if that isn't possible, **Error\_Locked** is thrown. This error is a standard Windows application programming interface (API) error that can be captured by the **<ErrorControl>** section to either cause USMT to skip the file or abort the migration.
|
||||
|
||||
Syntax: `<errorHardLink>` *<pattern>* `</errorHardLink>`
|
||||
|
||||
## <a href="" id="bkmk-profilecontrol"></a> <ProfileControl>
|
||||
## <ProfileControl>
|
||||
|
||||
This element is used to contain other elements that establish rules for migrating profiles, users, and policies around local group membership during the migration. **<ProfileMigration>** is a child of **<Configuration>**.
|
||||
|
||||
Syntax: <`ProfileControl>` `</ProfileControl>`
|
||||
|
||||
## <a href="" id="bkmk-localgroups"></a> <localGroups>
|
||||
## <localGroups>
|
||||
|
||||
This element is used to contain other elements that establish rules for how to migrate local groups. **<localGroups>** is a child of **<ProfileControl>**.
|
||||
|
||||
Syntax: `<localGroups>` `</localGroups>`
|
||||
|
||||
## <a href="" id="bkmk-mappings"></a> <mappings>
|
||||
## <mappings>
|
||||
|
||||
This element is used to contain other elements that establish mappings between groups.
|
||||
|
||||
Syntax: `<mappings>` `</mappings>`
|
||||
|
||||
## <a href="" id="bkmk-changegrou"></a> <changeGroup>
|
||||
## <changeGroup>
|
||||
|
||||
This element describes the source and destination groups for a local group membership change during the migration. It's a child of **<localGroups>**. The following parameters are defined:
|
||||
|
||||
@ -250,19 +272,19 @@ The valid and required children of **<changeGroup>** are **<include>
|
||||
|
||||
Syntax: `<changeGroup From="Group1" To= "Group2">` `</changeGroup>`
|
||||
|
||||
## <a href="" id="bkmk-include"></a> <include>
|
||||
## <include>
|
||||
|
||||
This element specifies that its required child, *<pattern>*, should be included in the migration.
|
||||
|
||||
Syntax: `<include>` `</include>`
|
||||
|
||||
## <a href="" id="bkmk-exclude"></a> <exclude>
|
||||
## <exclude>
|
||||
|
||||
This element specifies that its required child, *<pattern>*, should be excluded from the migration.
|
||||
|
||||
Syntax: `<exclude>` `</exclude>`
|
||||
|
||||
## <a href="" id="bkmk-sampleconfigxjmlfile"></a> Sample Config.xml File
|
||||
## Sample Config.xml File
|
||||
|
||||
Refer to the following sample `Config.xml` file for more details about items you can choose to exclude from a migration.
|
||||
<br>
|
||||
|
||||
Reference in New Issue
Block a user