Compartir a través de

Personalización de archivos XML de USMT

  • Artículo

En este tema

Introducción

Archivos .xml de migración

Archivos .xml personalizados

Archivo Config.xml

Ejemplos

Información adicional

Introducción

Si quieres que las herramientas ScanState y LoadState usen alguno de los archivos .xml de migración, especifica estos archivos en la línea de comandos con la opción /i. Como las herramientas ScanState y LoadState necesitan los archivos .xml para controlar la migración, especifica el mismo conjunto de archivos .xml para los comandos ScanState y LoadState. De todos modos, no es necesario especificar el archivo Config.xml con la opción /config, salvo que quieras excluir parte de los archivos y la configuración que migraste al almacén. Por ejemplo, tal vez quieras migrar la carpeta Mis documentos al almacén, pero no al equipo de destino. Para hacerlo, modifica el archivo Config.xml y especifica el archivo actualizado con el comando LoadState. Luego, el comando LoadState migrará solamente los archivos y la configuración que quieras.

Si excluyes un archivo .xml del comando LoadState, se migrarán todos los datos del almacén que se migraron con los archivos .xml que faltan. Pero no se aplicarán las reglas de migración que se especificaron con el comando ScanState. Por ejemplo, si excluyes un archivo .xml que contiene una regla de reenrutamiento, como MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%"), USMT no cambiará la ruta de los archivos, y estos se migrarán a C:\data.

Para modificar la migración, realiza una o varias de las siguientes acciones:

  • Modifica los archivos .xml de migración. Si quieres excluir una parte de un componente (por ejemplo, quieres migrar C:\ y excluir todos los archivos .mp3) o mover datos a una nueva ubicación en el equipo de destino, modifica los archivos .xml. Para modificar estos archivos, debes estar familiarizado con las reglas de migración y la sintaxis. Si quieres que ScanState y LoadState usen esos archivos, especifícalos en la línea de comandos cuando escribas cada comando.

  • Crea un archivo .xml personalizado. También puedes crear un archivo .xml personalizado para migrar la configuración para otra aplicación o cambiar el comportamiento de la migración según tus necesidades. Para que ScanState y LoadState usen este archivo, especifícalo en ambas líneas de comandos.

  • Crea y modifica un archivo Config.xml. Haz esto si quieres excluir un componente completo de la migración. Por ejemplo, puedes usar un archivo Config.xml para excluir toda la carpeta Mis documentos o excluir la configuración de una aplicación. Excluir componentes usando un archivo Config.xml es más sencillo que modificar los archivos .xml de migración, porque no necesitas estar familiarizado con las reglas de migración y la sintaxis. Además, el único modo de excluir la configuración del sistema operativo de la migración es mediante un archivo Config.xml.

Para obtener más información sobre la exclusión de datos, consulta Excluir archivos y configuraciones.

Archivos .xml de migración

En esta sección, se describen los archivos .xml de migración que se incluyen con USMT. Cada archivo contiene reglas de migración que controlan qué componentes se migran y en qué ubicación del equipo de destino se migran.

Nota

Puedes usar el asterisco (*) como carácter comodín en cada archivo. En cambio, no puedes usar el signo de interrogación (?) como carácter comodín.

  • Archivo MigApp.xml: especifica este archivo con los comandos ScanState y LoadState para migrar la configuración de la aplicación.

  • Archivo MigDocs.xml: especifica este archivo con las herramientas ScanState y LoadState para migrar todos los archivos y carpetas de usuario que se encuentran con la función auxiliar MigXmlHelper.GenerateDocPatterns. Esta función auxiliar busca datos de usuario que residen en la raíz de todas las unidades y en el directorio Usuarios. Sin embargo, no busca ni migra datos de aplicaciones, archivos de programa ni archivos que se encuentran en el directorio de Windows. Puedes modificar el archivo MigDocs.xml.

  • Archivo MigUser.xml: especifica este archivo con los comandos ScanState y LoadState para migrar carpetas, archivos y tipos de archivos de usuarios. Puedes modificar el archivo MigUser.xml. Este archivo no contiene reglas que migran cuentas de usuario específicas. El único modo de especificar qué cuentas de usuario se migrarán es mediante las opciones de usuario ScanState y LoadState en la línea de comandos.

    Nota

    No uses los archivos MigUser.xml y MigDocs.xml de manera conjunta. Para obtener más información, consulta los temas Identificar tipos de archivo, archivos y carpetas y Procedimientos recomendados de USMT.

Archivos .xml personalizados

Puedes crear archivos .xml personalizados para personalizar la migración de modo que se adapte a tus necesidades. Por ejemplo, tal vez quieras crear un archivo personalizado para migrar una aplicación de línea de negocio o modificar el comportamiento predeterminado de la migración. Si quieres que ScanState y LoadState usen este archivo, especifícalo con ambos comandos. Para obtener más información, consulta el tema Personalización de archivos XML de USMT.

Archivo Config.xml

El archivo Config.xml es un archivo opcional que se crea mediante la opción /genconfig con el comando ScanState. Debes crear y modificar este archivo si quieres excluir determinados componentes de la migración. Además, debes crear y modificar este archivo si quieres excluir de la migración cualquier parte de la configuración del sistema operativo. El formato del archivo Config.xml es distinto del formato de los archivos .xml de migración porque no contiene reglas de migración. Solamente contiene una lista de los componentes del sistema operativo, las aplicaciones y los documentos de usuario que se pueden migrar. Para obtener un ejemplo, consulta el tema Archivo Config.xml. Por este motivo, excluir componentes con este archivo es más sencillo que modificar los archivos .xml de migración, porque no necesitas estar familiarizado con las reglas de migración y la sintaxis. Sin embargo, en un archivo Config.xml no puedes usar caracteres comodín.

Si quieres incluir todos los componentes predeterminados, no es necesario que crees el archivo Config.xml. Otra posibilidad es que crees y modifiques un archivo Config.xml y dejes los archivos .xml restantes en su estado original, en caso de que estés conforme con el comportamiento predeterminado de la migración definido en los archivos MigApp.xml, MigDocs.xml y MigUser.xml, y quieras excluir solo algunos componentes.

Cuando ejecutes el comando ScanState con la opción /genconfig, ScanState lee los demás archivos .xml que especifiques mediante la opción /i para crear una lista personalizada de los componentes que pueden migrarse desde el equipo. Este archivo contendrá solamente los componentes del sistema operativo, las aplicaciones y las secciones de documentos de usuario que se encuentren en ambos archivos .xml y se instalen en el equipo al ejecutar el comando ScanState con la opción /genconfig. Por lo tanto, debes crear este archivo en un equipo de origen que contenga todos los componentes, las aplicaciones y la configuración que se encontrarán en los equipos de destino. De este modo, se garantiza que este archivo incluya todos los componentes que pueden migrarse. Los componentes se organizan en las siguientes secciones: <Applications>, <WindowsComponents> y <Documents>. Si eliges no migrar un componente, cambia la entrada correspondiente a migrate="no".

Después de crear este archivo, debes especificarlo solamente con el comando ScanState mediante la opción /Config para que afecte a la migración. Pero, si quieres excluir datos adicionales que migraste al almacén, modifica el archivo Config.xml y especifica el archivo actualizado con el comando LoadState. Por ejemplo, si recopilaste la carpeta Mis documentos en el almacén, pero prefieres no migrar esta carpeta al equipo de destino, puedes modificar el archivo Config.xml para indicar migrate="no" antes de ejecutar el comando LoadState y, de este modo, el archivo no se migrará. Para obtener más información sobre el orden de prioridad durante la exclusión de datos, consulta el tema Excluir archivos y configuraciones.

Además, ten en cuenta la siguiente funcionalidad con el archivo Config.xml:

  • Si se especifica migrate="no" para quitar un componente principal de la migración en el archivo Config.xml, todos sus componentes secundarios se quitarán de la migración de manera automática, incluso si el componente secundario está establecido en migrate="yes".

  • Si, por error, hay dos líneas de código para el mismo componente, y una de ellas especifica migrate="no" , mientras que la otra especifica migrate="yes", se migrará el componente.

  • En USMT, existen varias directivas de migración que pueden configurarse en el archivo Config.xml. Por ejemplo, puedes configurar las opciones adicionales <ErrorControl>, <ProfileControl> y <HardLinkStoreControl>. Para obtener más información, consulta el tema sobre el Archivo Config.xml.

Nota

Para excluir un componente del archivo Config.xml, establece el valor migrate en “no”. Al eliminar la etiqueta XML del componente del archivo Config.xml no se excluirá el componente de la migración.

Ejemplos

  • El siguiente comando crea un archivo Config.xml en el directorio actual, pero no crea un almacén:

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:5

  • El siguiente comando crea un almacén cifrado por medio del archivo Config.xml y los archivos .xml de migración predeterminados:

    scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:5 /encrypt /key:"mykey"

  • El siguiente comando descifra el almacén y migra los archivos y la configuración:

    loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:5 /decrypt /key:"mykey"

Información adicional

Consulte también

Otros recursos

Sintaxis de línea de comandos de la Herramienta de migración de estado de usuario (USMT)
Recursos de USMT