Compartir a través de

Descripción de archivos XML de migración

  • Artículo

Puedes modificar el comportamiento de una migración de la Herramienta de migración de estado de usuario (USMT) 5.0 básica utilizando archivos XML; estos archivos proporcionan instrucciones sobre el lugar y el modo en que las herramientas de USMT deben recopilar y aplicar archivos y opciones de configuración. USMT incluye tres archivos XML que puedes usar para personalizar una migración básica: los archivos MigDocs.xml y MigUser.xml, que modifican la forma en que se detectan los archivos en el equipo de origen, y el archivo MigApps.xml, que se necesita para poder migrar la configuración de la aplicación compatible. También puedes crear y editar archivos XML personalizados y un archivo Config.xml para personalizar más la migración.

Este tema proporciona información general sobre los archivos XML de migración predeterminados y personalizados, así como instrucciones para crear y editar una versión personalizada del archivo MigDocs.xml. El archivo MigDocs.xml usa la nueva función GenerateDocPatterns que se encuentra disponible en USMT para encontrar automáticamente documentos de usuario en un equipo de origen.

En este tema

Información general sobre el archivo Config.xml

Información general sobre el archivo MigApp.xml

Información general sobre el archivo MigDocs.xml

Información general sobre el archivo MigUser.xml

Uso de varios archivos XML

     Reglas XML para migrar archivos de usuario

Creación y edición de un archivo XML personalizado

     La función GenerateDocPatterns

     Descripción del sistema y el contexto de usuario

     Reglas de migración de muestra para versiones personalizadas de archivos XML

     Ejemplos de uso de reglas de exclusión

     Ejemplos de uso de reglas de inclusión

Pasos siguientes

Información general sobre el archivo Config.xml

El archivo Config.xml es el archivo de configuración que se crea con la opción /genconfig de la herramienta ScanState; se puede usar para modificar cuáles son los componentes del sistema operativo que se migran mediante USMT. El archivo Config.xml se puede usar junto con otros archivos XML, como en el siguiente ejemplo: scanstate /i:migapps.xml /i:migdocs.xml /genconfig:c:\myFolder\config.xml. Cuando se usa de esta manera, el archivo Config.xml controla rigurosamente los aspectos de la migración, incluidos los perfiles, datos y opciones de configuración del usuario, sin modificar o crear otros archivos XML. Para obtener más información acerca del archivo Config.xml, consulta Personalización de archivos XML de USMT y Archivo Config.xml.

Nota

Al modificar los elementos XML en el archivo Config.xml, debes editar un elemento y establecer la propiedad migrate en no, en lugar de eliminar el elemento del archivo. Si eliminas el elemento en lugar de establecer la propiedad, es posible que las reglas de otros archivos XML migren el componente de todas formas.

Información general sobre el archivo MigApp.xml

El archivo MigApp.xml instalado con USMT incluye instrucciones para migrar la configuración de las aplicaciones que se indican en ¿Qué elementos migra USMT?. Debes incluir el archivo MigApp.xml cuando utilices las herramientas ScanState y LoadState mediante la opción /i para poder migrar la configuración de la aplicación. Los archivos MigDocs.xml y MigUser.xml no migran la configuración de la aplicación. Puedes crear un archivo XML personalizado para incluir aplicaciones adicionales. Para obtener más información, consulta Personalización de archivos XML de USMT.

Importante

El archivo MigApps.xml solo detectará y migrará archivos .pst que estén vinculados a Microsoft(R) Office Outlook(R). Consulta la sección Reglas de migración de muestra para versiones personalizadas de archivos XML de este documento para obtener más información acerca de la migración de archivos .pst que no están vinculados a Outlook.

Información general sobre el archivo MigDocs.xml

El archivo MigDocs.xml usa la nueva función auxiliar GenerateDocPatterns para crear instrucciones para que USMT migre archivos desde el equipo de origen según la ubicación de los archivos. Puedes usar el archivo MigDocs.xml con las herramientas ScanState y LoadState para llevar a cabo una migración más dirigida que al usar USMT sin instrucciones XML.

El archivo MigDocs.xml predeterminado migra lo siguiente:

  • Todos los archivos de la raíz de la unidad, excepto %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% o %USERS%.

  • Todas las carpetas del directorio raíz de todas las unidades fijas. Por ejemplo: c:\data_mail\*[*]

  • Todos los archivos de la raíz de la carpeta Profiles, excepto los archivos del perfil del sistema. Por ejemplo: c:\users\name[mail.pst]

  • Todas las carpetas de la raíz de la carpeta Profiles, excepto las carpetas del perfil del sistema. Por ejemplo: c:\users\name\new folder\*[*]

  • Carpetas compartidas estándar:

    • CSIDL_COMMON_DESKTOPDIRECTORY

    • CSIDL_COMMON_FAVORITES

    • CSIDL_COMMON_DOCUMENTS

    • CSIDL_COMMON_MUSIC

    • CSIDL_COMMON_PICTURES

    • CSIDL_COMMON_VIDEO

    • FOLDERID_PublicDownloads

  • Carpetas de perfil de usuario estándar para cada usuario:

    • CSIDL_MYDOCUMENTS

    • CSIDL_MYPICTURES

    • FOLDERID_OriginalImages

    • CSIDL_MYMUSIC

    • CSIDL_MYVIDEO

    • CSIDL_FAVORITES

    • CSIDL_DESKTOP

    • CSIDL_QUICKLAUNCH

    • FOLDERID_Contacts

    • FOLDERID_Libraries

    • FOLDERID_Downloads

    • FOLDERID_SavedGames

    • FOLDERID_RecordedTV

El archivo MigDocs.xml predeterminado no migrará lo siguiente:

  • Archivos etiquetados con los atributos hidden y system.

  • Archivos y carpetas de unidades extraíbles.

  • Datos de las carpetas %WINDIR%, %PROGRAMDATA% y %PROGRAMFILES%.

  • Carpetas que contienen aplicaciones instaladas.

También puedes usar la opción /genmigxml con la herramienta ScanState para revisar y modificar qué archivos se migrarán. Para obtener más información, consulta la sección Creación y edición de un archivo XML personalizado de este documento.

Información general sobre el archivo MigUser.xml

El archivo MigUser.xml incluye instrucciones para que USMT migre archivos de usuario según las extensiones del nombre de archivo. Puedes usar el archivo MigUser.xml con las herramientas ScanState y LoadState para llevar a cabo una migración más dirigida que al usar USMT sin instrucciones XML. El archivo MigUser.xml recopilará todos los archivos de las carpetas de perfil de usuario estándar, además de todos los archivos del equipo que tengan las extensiones de nombre de archivo especificadas.

El archivo MigUser.xml predeterminado migra lo siguiente:

  • Todos los archivos de las carpetas de perfil de usuario estándar que se describen como:

    • CSIDL_MYVIDEO

    • CSIDL_MYMUSIC

    • CSIDL_DESKTOP

    • CSIDL_STARTMENU

    • CSIDL_PERSONAL

    • CSIDL_MYPICTURES

    • CSIDL_FAVORITES

    • CSIDL_QUICK LAUNCH

  • Los archivos con las siguientes extensiones:

    .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

El archivo MigUser.xml predeterminado no migra lo siguiente:

  • Archivos etiquetados con los atributos hidden y system.

  • Archivos y carpetas de unidades extraíbles,

  • Datos de las carpetas %WINDIR%, %PROGRAMFILES% y %PROGRAMDATA%.

  • ACLS para archivos en carpetas fuera del perfil de usuario.

Puedes hacer una copia del archivo MigUser.xml y modificarla para que incluya o excluya carpetas de perfil de usuario y extensiones de nombre de archivo estándar. Si conoces todas las extensiones de los archivos que deseas migrar desde el equipo de origen, usa el archivo MigUser.xml para mover todos los datos importantes, sin importar la ubicación de los archivos. Sin embargo, esto puede generar una migración que contenga más archivos de lo deseado. Por ejemplo, si eliges migrar todos los archivos .jpg, puedes migrar archivos de imagen como miniaturas y logotipos de aplicaciones heredadas que estén instaladas en el equipo de origen.

Nota

Cada extensión de nombre de archivo que incluyas en las reglas que están dentro del archivo MigUser.xml aumenta la cantidad de tiempo que la herramienta ScanState tarda en recopilar los archivos para la migración. Si migras más de 300 tipos de archivos, es posible que la migración sea lenta. Para obtener más información acerca de otras formas de organizar la migración de los datos, consulta la sección Uso de varios archivos XML de este documento.

Uso de varios archivos XML

Con las herramientas ScanState y LoadState puedes usar varios archivos XML. Cada uno de los archivos XML personalizados que se incluyen o se generan con USMT se configuran para un componente específico de la migración. También puedes usar los archivos XML personalizados para complementar estos archivos predeterminados con reglas de migración adicionales.

Archivo de migración XML Modifica los siguientes componentes:

Archivo Config.xml

Componentes del sistema operativo como el papel tapiz del escritorio y el tema de fondo.

También puedes sobrecargar config.xml para que incluya algunas configuraciones de la aplicación y de los documentos al generar el archivo config.xml con los otros archivos XML predeterminados. Para obtener más información, consulta Personalización de archivos XML de USMT y Archivo Config.xml.

Archivo MigApps.xml

Configuración de la aplicación.

Archivos MigUser.xml o MigDocs.xml

Configuración de perfiles y archivos de usuario.

Archivos XML personalizados

Configuración de la aplicación, configuración de perfiles de usuario, o archivos de usuario, más allá de las reglas que contengan los otros archivos XML.

Por ejemplo, puedes usar todos los tipos de archivo de migración XML para una sola migración, como en el siguiente ejemplo:

Scanstate <store> /config:c:\myFolder\config.xml /i:migapps.xml /i:migdocs.xml /i:customrules.xml

Reglas XML para migrar archivos de usuario

Importante

No debes usar los archivos MigUser.xml y MigDocs.xml juntos en el mismo comando. Usar ambos archivos XML puede provocar la duplicación de algunos archivos migrados. Esto sucede cuando se producen conflictos en las instrucciones de ubicación de destino en conflicto en cada archivo XML. El archivo de destino se almacenará una vez durante la migración, pero cada archivo XML lo aplicará en una ubicación distinta en el equipo de destino.

Si el conjunto de datos es desconocido o si hay muchos archivos almacenados fuera de las carpetas de perfil de usuario estándar, el archivo MigDocs.xml resulta una mejor opción que MigUser.xml ya que el primero recopilará un ámbito de datos más amplio. El archivo MigDocs.xml migra carpetas de datos según la ubicación. El archivo MigUser.xml solo migra los archivos con las extensiones de nombre de archivo especificadas.

Si deseas más control sobre la migración, puedes crear archivos XML personalizados. Consulta la sección Creación y edición de un archivo XML personalizado de este documento.

Creación y edición de un archivo XML personalizado

Puedes usar la opción de línea de comandos /genmigxml para determinar qué archivos se incluirán en la migración. La opción /genmigxml crea un archivo en la ubicación que especifiques, para que puedas revisar las reglas XML y hacer todas las modificaciones necesarias.

Nota

Si vuelves a instalar USMT, se sobrescribirán los archivos XML de migración predeterminados y se perderán todas las personalizaciones que realices directamente en estos archivos. Considera la posibilidad de crear archivos XML independientes para las reglas de migración personalizadas y guardarlos en una ubicación segura.

Para generar el archivo de reglas de migración XML para un equipo de origen:

  1. Haz clic en Inicio, Todos los programas y selecciona Accesorios. Luego, haz clic con el botón secundario en Símbolo del sistema y haz clic en Ejecutar como.

  2. Selecciona una cuenta con privilegios de administrador, escribe una contraseña y haz clic en Aceptar.

  3. En el símbolo del sistema, escribe:

    cd /d <USMTpath>

scanstate.exe /genmigxml: <filepath.xml>

    Donde <USMTpath> es la ubicación del equipo de origen donde guardaste los archivos y las herramientas de USMT y <filepath.xml> es la ruta de acceso completa a un archivo donde puedes guardar el informe. Por ejemplo, escribe:

    cd /d c:\USMT

scanstate.exe /genmigxml:"C:\Documents and Settings\USMT Tester\Desktop\genMig.xml"

La función GenerateDocPatterns

El archivo MigDocs.xml llama a la función GenerateDocPatterns, que toma tres valores booleanos. Puedes cambiar la configuración para modificar la forma en que el archivo MigDocs.xml genera las reglas XML para la migración.

Parámetro Valor Valor predeterminado

ScanProgramFiles

El argumento ScanProgramFiles solo es válido cuando se llama a la función GenerateDocPatterns en un contexto de sistema. Este argumento determina si se debe o no examinar el directorio Archivos de programa para recopilar las extensiones de nombre de archivo registradas para las aplicaciones conocidas.

Por ejemplo, cuando se establece en TRUE, la función detecta y migra archivos .doc del directorio Microsoft Office porque .doc es la extensión de nombre de archivo registrada para una aplicación de Microsoft Office. La función GenerateDocPatterns genera este patrón de inclusión para los archivos .doc:

<pattern type="File">C:\Program Files\Microsoft Office\*[*.doc]</pattern>

Si la carpeta secundaria de una carpeta incluida contiene una aplicación instalada, ScanProgramFiles también creará una regla de exclusión para la carpeta secundaria. Se examinarán recursivamente todas las carpetas de la carpeta de la aplicación en busca de las extensiones de nombre de archivo registradas.

False

IncludePatterns

El argumento IncludePatterns determina si se deben generar patrones de exclusión o inclusión en el XML. Cuando este argumento se establece en TRUE, la función GenerateDocPatterns genera patrones de inclusión y la función se debe agregar bajo el elemento <include>. Al cambiar este argumento a FALSE se generan patrones de exclusión y la función se debe agregar bajo el elemento <exclude>.

True

SystemDrive

El argumento SystemDrive determina si se deben generar patrones para todas las unidades fijas o solo para la unidad del sistema. Al cambiar este argumento a TRUE se restringen todos los patrones a la unidad del sistema.

False

Uso:

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

Para crear patrones de datos de inclusión solo para la unidad del sistema:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>

     </objectSet>

</include>

Para crear una regla de inclusión que recopile archivos de extensiones registradas del directorio %PROGRAMFILES%:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>

     </objectSet>

</include>

Para crear patrones de datos de exclusión:

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>

     </objectSet>

</exclude>

Descripción del sistema y el contexto de usuario

Los archivos XML de migración contienen dos elementos <component> con diferente configuración de contexto. El contexto de sistema se aplica a los archivos del equipo que no se almacenan en el directorio Perfiles de usuario, mientras que el contexto de usuario se aplica a los archivos que corresponden a un usuario individual en concreto.

Contexto de sistema

El contexto de sistema incluye reglas para los datos que están fuera del directorio Perfiles de usuario. Por ejemplo, cuando se llama a la función GenerateDocPatterns en un contexto de sistema en el archivo MigDocs.xml, la función crea patrones para todas las carpetas de shell comunes, los archivos del directorio raíz de las unidades de disco duro y las carpetas que se encuentran en la raíz de las unidades de disco duro. Se incluyen las siguientes carpetas:

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

Contexto de usuario

El contexto de usuario incluye reglas para los datos del directorio Perfiles de usuario. Cuando se llama a la función GenerateDocPatterns en un contexto de usuario en el archivo MigDocs.xml, la función crea patrones para todas las carpetas de shell de usuarios, los archivos que se encuentran en la raíz del perfil y las carpetas ubicadas en la raíz del perfil. Se incluyen las siguientes carpetas:

  • CSIDL_MYDOCUMENTS

  • CSIDL_MYPICTURES

  • FOLDERID_OriginalImages

  • CSIDL_MYMUSIC

  • CSIDL_MYVIDEO

  • CSIDL_FAVORITES

  • CSIDL_DESKTOP

  • CSIDL_QUICKLAUNCH

  • FOLDERID_Contacts

  • FOLDERID_Libraries

  • FOLDERID_Downloads

  • FOLDERID_SavedGames

  • FOLDERID_RecordedTV

Nota

Las reglas que contiene un componente que se asigna al contexto de usuario se ejecutarán para cada perfil de usuario del equipo. Los archivos que se examinen varias veces con los archivos MigDocs.xml solo se copiarán en el almacén de migración una vez; sin embargo, una gran cantidad de reglas en el contexto de usuario pueden ralentizar la migración. Usa el contexto de sistema cuando corresponda.

Reglas de migración de muestra para versiones personalizadas de archivos XML

Nota

Para obtener información acerca de los procedimientos recomendados y los requisitos para archivos XML personalizados en USMT, consulta Personalización de archivos XML de USMT y Convenciones generales.

Ejemplos de uso de reglas de exclusión

En los ejemplos siguientes, el equipo de origen tiene un archivo .txt llamado "new text document" (nuevo documento de texto) en un directorio llamado "new folder" (nueva carpeta). El comportamiento de MigDocs.xml predeterminado migra el siguiente archivo new text document.txt y todos los archivos que contiene el directorio "new folder". Las reglas que genera la función son:

Regla 1

 
<pattern type="File">d:\new folder\[new text document.txt]</pattern>

Regla 2

 
<pattern type="File">d:\new folder\*[*]</pattern>

Para excluir el archivo new text document.txt además de cualquier otro archivo .txt de "new folder", puedes hacer lo siguiente:

Ejemplo 1: excluir todos los archivos .txt de una carpeta

En la regla de exclusión 1 debe haber una coincidencia exacta de nombre de archivo. Sin embargo, en la regla 2, puedes crear un patrón que excluya archivos mediante la extensión de nombre de archivo.

<exclude>

     <objectSet>

        <pattern type="File">D:\Newfolder\[new text document.txt]</pattern>

         <pattern type="File">D:\New folder\*[*.txt]</pattern>

     </objectSet>

</exclude>

Ejemplo 2: usar el elemento UnconditionalExclude para darle prioridad a una regla sobre las reglas de inclusión

Si no sabes el nombre o la ubicación del archivo, pero sí conoces la extensión de nombre de archivo, puedes usar la función GenerateDrivePatterns. Sin embargo, la regla será menos específica que la regla de inclusión predeterminada que se genera con el archivo MigDocs.xml, por lo que no tendrá prioridad. Debes usar el elemento <UnconditionalExclude> para darle prioridad a esta regla sobre la regla de inclusión predeterminada. Para obtener más información acerca del orden de prioridad de las reglas de migración XML, consulta Conflictos y prioridad.

<unconditionalExclude>

     <objectSet>

        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>

     </objectSet>

</unconditionalExclude>

Ejemplo 3: usar un componente del contexto UserandSystem para ejecutar las reglas en ambos contextos.

Si deseas que se aplique el elemento <UnconditionalExclude> al contexto de sistema y de usuario, puedes crear un tercer componente que utilice el contexto UserandSystem. Las reglas de este componente se ejecutarán en ambos contextos.

<component type="Documents" context="UserandSystem">

   <displayName>MigDocExcludes</displayName>

   <role role="Data">

     <rules>

       <unconditionalExclude>

         <objectSet>

                <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>

         </objectSet>

       </unconditionalExclude>

     </rules>

   </role>

</component>

Si deseas obtener más ejemplos de reglas de exclusión que puedes usar en archivos XML de migración personalizados, consulta Excluir archivos y configuraciones.

Ejemplos de uso de reglas de inclusión

El directorio de datos de la aplicación es la ubicación donde con más frecuencia necesitarías agregar una regla de inclusión. La función GenerateDocPatterns excluye esta ubicación de forma predeterminada. Si tu empresa usa una aplicación que guarda datos importantes en esta ubicación, puedes crear reglas de inclusión para migrar los datos. Por ejemplo, la ubicación predeterminada para los archivos .pst es: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. El archivo Migapp.xml contiene reglas de migración para mover solo los archivos .pst que están vinculados a Microsoft Outlook. Para incluir archivos .pst que no están vinculados, puedes hacer lo siguiente:

Ejemplo 1: incluir una extensión de nombre de archivo en una carpeta de usuario conocida

Esta regla incluirá los archivos .pst que se encuentran en la ubicación predeterminada pero que no están vinculados a Microsoft Office. Usa el contexto de usuario para ejecutar esta regla para cada usuario del equipo.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>

     </objectSet>

</include>

Ejemplo 2: incluir una extensión de nombre de archivo en Archivos de programa

En el caso de las ubicaciones que están fuera del perfil de usuario, como la carpeta Archivos de programa, puedes agregar la regla al componente de contexto de sistema.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>

     </objectSet>

</include>

Si deseas obtener más ejemplos de reglas de inclusión que puedes usar en archivos XML de migración personalizados, consulta Incluir archivos y configuraciones.

Nota

Para obtener más información acerca del orden de prioridad de las reglas de migración XML, consulta Conflictos y prioridad.

Pasos siguientes

Puedes incluir reglas adicionales de migración en el archivo MigDocs.xml u otros archivos de migración XML. Por ejemplo, puedes usar el elemento <locationModify> para mover archivos de la carpeta en la que se han recopilado a otra carpeta, cuando se aplican al equipo de destino. Para obtener más información, consulta la Referencia de XML de USMT.

Puedes usar un archivo de esquema XML (MigXML.xsd) para validar la sintaxis de los archivos XML personalizados. Para obtener más información, consulta Recursos de USMT.

Consulte también

Otros recursos

Excluir archivos y configuraciones
Incluir archivos y configuraciones