Compartir a través de

Descripción de los archivos XML de migración

El comportamiento de una migración básica de la Herramienta de migración de estado de usuario (USMT) se puede modificar mediante archivos XML. Estos archivos proporcionan instrucciones sobre dónde y cómo las herramientas de USMT deben recopilar y aplicar archivos y configuraciones. USMT incluye tres archivos XML que se pueden usar para personalizar una migración básica: los MigDocs.xml archivos y MigUser.xml , que modifican cómo se detectan los archivos en el equipo de origen, y el archivo MigApps.xml, que es necesario para migrar la configuración de la aplicación admitida. Los archivos XML personalizados y un Config.xml archivo se pueden crear y editar para personalizar aún más la migración.

En este artículo se proporciona información general sobre los archivos XML de migración predeterminados y personalizados e se incluyen instrucciones para crear y editar una versión personalizada del MigDocs.xml archivo. El MigDocs.xml archivo usa la nueva GenerateDocPatterns función disponible en USMT para buscar automáticamente documentos de usuario en un equipo de origen.

Información general del archivo Config.xml

El Config.xml archivo es el archivo de configuración creado por la /genconfig opción de la herramienta ScanState . Se puede usar para modificar qué componentes del sistema operativo migra USMT. El Config.xml archivo se puede usar con otros archivos XML, como en el ejemplo siguiente:

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

Cuando se usa de esta manera, el Config.xml archivo controla estrechamente los aspectos de la migración, incluidos los perfiles de usuario, los datos y la configuración, sin modificar ni crear otros archivos XML. Para obtener más información sobre el Config.xml archivo, vea Personalizar archivos XML de USMT y archivoConfig.xml.

Nota

Al modificar los elementos XML del Config.xml archivo, establezca la propiedad migrate en un elemento en no en lugar de eliminar el elemento del archivo. Si se elimina el elemento en lugar de establecer la propiedad , las reglas de otros archivos XML pueden migrar el componente.

Información general del archivo MigApp.xml

El MigApp.xml archivo instalado con USMT incluye instrucciones para migrar la configuración de las aplicaciones enumeradas en ¿Qué migra USMT?. Para migrar la configuración de la aplicación, el MigApp.xml archivo debe incluirse al usar las herramientas ScanState y LoadState mediante la /i opción . Los MigDocs.xml archivos y MigUser.xml no migran la configuración de la aplicación. Se puede crear un archivo XML personalizado para incluir aplicaciones adicionales. Para obtener más información, vea Personalizar archivos XML de USMT.

Importante

El MigApps.xml archivo solo detecta y migra archivos .pst vinculados a Microsoft Office Outlook. Para obtener más información sobre la migración de archivos .pst que no están vinculados a Outlook, vea Reglas de migración de ejemplo para versiones personalizadas de archivos XML.

Información general del archivo MigDocs.xml

El MigDocs.xml archivo usa la nueva GenerateDocPatterns función auxiliar para crear instrucciones para que USMT migre archivos desde el equipo de origen, en función de la ubicación de los archivos. El MigDocs.xml archivo se puede usar con las herramientas ScanState y LoadState para realizar una migración más dirigida que el uso de USMT sin instrucciones XML.

El archivo predeterminado MigDocs.xml migra los datos siguientes:

  • 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 Perfiles, excepto los archivos del perfil del sistema. Por ejemplo: c:\users\name[mail.pst].

  • Todas las carpetas de la raíz de la carpeta Perfiles, excepto las carpetas de 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 predeterminado MigDocs.xml no migra los datos siguientes:

  • Archivos etiquetados con los atributos ocultos y del sistema .

  • Archivos y carpetas en unidades extraíbles.

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

  • Carpetas que contienen aplicaciones instaladas.

La /genmigxml opción se puede usar con la herramienta ScanState para revisar y modificar los archivos que se migran.

Información general del archivo MigUser.xml

El MigUser.xml archivo incluye instrucciones para que USMT migre archivos de usuario en función de las extensiones de nombre de archivo. El MigUser.xml archivo se puede usar con las herramientas ScanState y LoadState para realizar una migración más dirigida que el uso de USMT sin instrucciones XML. El MigUser.xml archivo recopila todos los archivos de las carpetas de perfil de usuario estándar y los archivos del equipo con las extensiones de nombre de archivo especificadas.

El archivo predeterminado MigUser.xml migra los datos siguientes:

  • 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

    • inicio de CSIDL_QUICK

  • Archivos con las siguientes extensiones:

    .accdb, .ch3, .csv, .dif, .doc*, .dot*, .dqy, .iqy, .mcw, .mdb*, .mpp, .one*, .oqy, .or6, .pot*, .ppa, .pps*, .ppt*, .pre, .pst, .pub, .qdf, .qel, .qph, .qsd, .rqy, .rtf, .scd, .sh3, .slk, .txt, .vl*, .vsd, .wk*, .wpd, .wps, .wq1, .wri, .xl*, .xla, .xlb, .xls*

    Nota

    El asterisco (*) significa cero o más caracteres.

    Nota

    Las extensiones de OpenDocument (*.odt, *.odp, *.ods) que las aplicaciones de Microsoft Office pueden usar no se migran de forma predeterminada.

El archivo predeterminado MigUser.xml no migra los datos siguientes:

  • Archivos etiquetados con los atributos Hidden y System .

  • Archivos y carpetas en unidades extraíbles.

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

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

El MigUser.xml archivo se puede copiar y, a continuación, modificar la copia para incluir o excluir carpetas estándar de perfil de usuario y extensiones de nombre de archivo. Si se conocen todas las extensiones de los archivos que deben migrarse desde el equipo de origen, use el MigUser.xml archivo para mover todos los datos pertinentes, independientemente de la ubicación de los archivos. Sin embargo, agregar todas las extensiones de archivo que deben migrarse al MigUser.xml archivo puede dar lugar a una migración que contiene más archivos de los previstos. Por ejemplo, si se migran todos los archivos .jpg , también puede migrar archivos de imagen como miniaturas y logotipos de aplicaciones heredadas instaladas en el equipo de origen.

Nota

Cada extensión de nombre de archivo incluida en las reglas del MigUser.xml archivo aumenta el tiempo necesario para que la herramienta ScanState recopile los archivos para la migración. Si se migran más de 300 tipos de archivo, la experiencia de migración puede ser lenta. Para obtener más información sobre otras formas de organizar la migración de los datos, consulte la sección Uso de varios archivos XML de este artículo.

Uso de varios archivos XML

Se pueden usar varios archivos XML con las herramientas ScanState y LoadState . Cada uno de los archivos XML predeterminados incluidos o generados por USMT está configurado para un componente específico de la migración. Los archivos XML personalizados también se pueden usar para complementar estos archivos predeterminados con más reglas de migración.

Archivo de migración XML Modifica los siguientes componentes:
archivoConfig.xml Componentes del sistema operativo, como el fondo de pantalla de escritorio y el tema de fondo.
Config.xml También se puede ampliar para incluir algunas opciones de configuración de la aplicación y del documento mediante la generación del Config.xml archivo con los demás archivos XML predeterminados. Para obtener más información, vea Personalizar archivos XML de USMT y archivoConfig.xml.
archivoMigApps.xml Configuración de aplicaciones.
archivosMigUser.xml o MigDocs.xml Configuración de perfiles y archivos de usuario.
Archivos XML personalizados Configuración de la aplicación, configuración de perfil de usuario o archivos de usuario, más allá de las reglas contenidas en los demás archivos XML.

Por ejemplo, todos los tipos de archivo de migración XML se pueden usar para una única migración, como en el ejemplo siguiente:

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

Reglas XML para migrar archivos de usuario

Importante

Los MigUser.xml archivos y MigDocs.xml no deben usarse juntos en el mismo comando. El uso de ambos archivos XML puede dar lugar a la duplicación de algunos archivos migrados. La duplicación de algunos archivos migrados puede producirse cuando se proporcionan instrucciones de ubicación de destino en conflicto en cada archivo XML. El archivo de destino se almacena una vez durante la migración, pero cada archivo XML aplica el archivo a una ubicación diferente en el equipo de destino.

Si el conjunto de datos es desconocido o si muchos archivos se almacenan fuera de las carpetas estándar de perfil de usuario, MigDocs.xml es una opción mejor que el MigUser.xml archivo, ya que el MigDocs.xml archivo recopila un ámbito más amplio de datos. El MigDocs.xml archivo migra carpetas de datos en función de la ubicación. El MigUser.xml archivo migra solo los archivos con las extensiones de nombre de archivo especificadas.

Para obtener más control sobre la migración, cree archivos XML personalizados. Para obtener más información sobre cómo crear archivos XML personalizados, consulte Creación y edición de un archivo XML personalizado.

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

La /genmigxml opción de línea de comandos se puede usar para determinar qué archivos se incluyen en la migración. La /genmigxml opción crea un archivo en una ubicación especificada. A continuación, se pueden revisar las reglas XML del archivo y, si es necesario, realizar modificaciones.

Nota

Si se vuelve a instalar USMT, los archivos XML de migración predeterminados se sobrescriben y se pierden las personalizaciones realizadas en estos archivos. Considere 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. Seleccione Iniciar>todos los accesorios de programas>

  2. Haga clic con el botón derecho en Símbolo del sistema y, a continuación, seleccione Ejecutar como.

  3. Seleccione una cuenta con privilegios de administrador, proporcione una contraseña y, a continuación, seleccione Aceptar.

  4. En el símbolo del sistema, escriba:

    cd /d <USMTpath>
ScanState.exe /genmigxml: <filepath.xml>

    donde:

    • <USMTpath> : ubicación en el equipo de origen de los archivos y herramientas de USMT guardados.
    • < >filepath.xml: ruta de acceso completa a un archivo donde se puede guardar el informe.

    Por ejemplo, escriba:

    cd /d c:\USMT
ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"

Función GenerateDocPatterns

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

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

    Valor predeterminado: False

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

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

    Si una carpeta secundaria de una carpeta incluida contiene una aplicación instalada, ScanProgramFiles también crea una regla de exclusión para la carpeta secundaria. Todas las carpetas de la carpeta de la aplicación se examinan de forma recursiva en busca de extensiones de nombre de archivo registradas.

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

    Valor predeterminado: True

  • SystemDrive: este argumento 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.

    Valor predeterminado: 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 para recopilar archivos para extensiones registradas desde el directorio %PROGRAMFILES%:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
     </objectSet>
</include>

Para crear patrones de exclusión de datos:

<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 de componente> con una configuración de contexto diferente:

  • El contexto del sistema se aplica a los archivos del equipo que no están almacenados en el directorio Perfiles de usuario.
  • El contexto de usuario se aplica a los archivos que son específicos de un usuario individual.

Contexto del sistema

El contexto del sistema incluye reglas para los datos fuera del directorio Perfiles de usuario. Por ejemplo, cuando se llama a en un contexto del sistema en el MigDocs.xml archivo, la GenerateDocPatterns 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 ubicadas en la raíz de las unidades de disco duro. Se incluyen las carpetas siguientes:

  • 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 en el directorio Perfiles de usuario. Cuando se llama a en un contexto de usuario en el MigDocs.xml archivo, la GenerateDocPatterns función crea patrones para todas las carpetas de shell de usuario, archivos ubicados en la raíz del perfil y carpetas ubicadas en la raíz del perfil. Se incluyen las carpetas siguientes:

  • 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 contenidas en un componente al que se asigna el contexto de usuario se ejecutan para cada perfil de usuario en el equipo. Los archivos que los archivos examinan varias veces MigDocs.xml solo se copian en el almacén de migración una vez. Sin embargo, un gran número de reglas en el contexto de usuario puede ralentizar la migración. Use el contexto del sistema cuando sea aplicable.

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

Sugerencia

Para conocer los procedimientos recomendados y los requisitos de los archivos XML personalizados en USMT, consulte Personalizar 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 en un directorio denominado new folder. El comportamiento predeterminado MigDocs.xml migra el nuevo archivo de texto document.txt y todos los archivos contenidos en el new folder directorio. Las reglas generadas por la función son:

Regla Sintaxis
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 nuevo archivo de texto document.txt y los archivos de.txt de new folder, se pueden realizar las siguientes modificaciones:

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

Para excluir la regla 1, debe haber una coincidencia exacta del nombre de archivo. Sin embargo, para la regla 2, se puede crear un patrón para excluir 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 dar prioridad a la regla sobre las reglas de inclusión

Si no se conoce el nombre de archivo o la ubicación del archivo, pero se conoce la extensión de nombre de archivo, se puede usar la GenerateDrivePatterns función. Sin embargo, la regla es menos específica que la regla de inclusión predeterminada generada por el MigDocs.xml archivo, por lo que no tiene prioridad. El <elemento UnconditionalExclude> debe usarse para dar prioridad a esta regla sobre la regla de inclusión predeterminada. Para obtener más información sobre el orden de precedencia de las reglas de migración XML, vea Conflictos y precedencia.

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

Ejemplo 3: Uso de un componente de contexto UserandSystem para ejecutar reglas en ambos contextos

Para aplicar el <elemento UnconditionalExclude> tanto al sistema como al contexto de usuario, se puede crear un tercer componente mediante el contexto UserandSystem . Las reglas de este componente se ejecutan 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>

Para obtener más ejemplos de reglas de exclusión que se pueden usar en archivos XML de migración personalizados, vea Excluir archivos y configuración.

Incluir ejemplos de uso de reglas

El directorio de datos de la aplicación es la ubicación más común para la que se tendría que agregar una regla de inclusión. La GenerateDocPatterns función excluye esta ubicación de forma predeterminada. Si la organización usa una aplicación que guarda datos importantes en esta ubicación, se pueden crear reglas de inclusión para migrar los datos. Por ejemplo, la ubicación predeterminada de los archivos .pst es: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. El MigApp.xml archivo contiene reglas de migración para mover solo los archivos .pst vinculados a Microsoft Outlook. Para incluir archivos .pst que no están vinculados, se puede realizar la siguiente modificación:

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

Esta regla incluye archivos .pst que se encuentran en la ubicación predeterminada, pero no están vinculados a Microsoft Outlook. Use 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

Para las ubicaciones fuera del perfil de usuario, como la carpeta Archivos de programa, la regla se puede agregar al componente de contexto del sistema.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
     </objectSet>
</include>

Para obtener más ejemplos de reglas de inclusión que se pueden usar en archivos XML de migración personalizados, vea Incluir archivos y configuración.

Sugerencia

Para obtener más información sobre el orden de precedencia de las reglas de migración XML, vea Conflictos y precedencia.

Pasos siguientes

Se pueden incluir reglas adicionales para la migración en el MigDocs.xml archivo u otros archivos de migración XML. Por ejemplo, el <locationModify> elemento se puede usar para mover archivos de la carpeta donde se recopilaron a otra carpeta, cuando se aplican al equipo de destino.

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