Compartir a través de

Personalización de archivos XML de USMT

Introducción

Para usar cualquiera de los archivos de.xml de migración con las herramientas ScanState y LoadState , especifique estos archivos en la línea de comandos mediante la /i opción . Dado que las herramientas ScanState y LoadState necesitan los archivos .xml para controlar la migración, especifique el mismo conjunto de archivos .xml para los ScanState.exe comandos y LoadState.exe . Sin embargo, no es necesario especificar el Config.xml archivo con la /config opción , a menos que sea necesario excluir algunos de los archivos y la configuración migrados del almacén. Por ejemplo, para migrar la carpeta Documentos al almacén, pero no al equipo de destino. Para lograr este escenario, modifique el Config.xml archivo y especifique el archivo actualizado con el LoadState.exe comando . A LoadState.exe continuación, el comando solo migra los archivos y la configuración deseados.

Si un archivo .xml se deja fuera del LoadState.exe comando, se migran todos los datos del almacén que se migraron con los archivos .xml que faltan. Sin embargo, no se aplican las reglas de migración especificadas con el ScanState.exe comando . Por ejemplo, si se deja fuera un archivo .xml y contiene una regla de redireccionamiento como:

MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")

USMT no redirige los archivos y se migran a C:\data.

Para modificar la migración, realice una o varias de las siguientes acciones.

  • Modifique los archivos de .xml de migración. Para excluir una parte de un componente, modifique los archivos .xml . Por ejemplo, para migrar C:\ pero excluir todos los archivos .mp3 , o para mover datos a una nueva ubicación en el equipo de destino. Para modificar estos archivos, es necesario familiarizarse con las reglas de migración y la sintaxis. Para que ScanState y LoadState usen estos archivos, especifíquelos en la línea de comandos cuando se escriba cada comando.

  • Cree un archivo de .xml personalizado. También se puede crear un archivo.xml personalizado para migrar la configuración de otra aplicación o para cambiar el comportamiento de migración para satisfacer las necesidades de la organización. Para que ScanState y LoadState usen este archivo, especifíquelos en ambas líneas de comandos.

  • Cree y modifique un archivo Config.xml. Cree y modifique un Config.xml archivo para excluir un componente completo de la migración. Por ejemplo, se puede usar un Config.xml archivo para excluir toda la carpeta Documentos o excluir la configuración de una aplicación. Excluir componentes mediante un Config.xml archivo es más fácil que modificar la migración .xml archivos porque no es necesario familiarizarse con las reglas de migración y la sintaxis. Además, el uso de un Config.xml archivo es la única manera de excluir la configuración del sistema operativo de la migración.

Para obtener más información sobre la exclusión de datos, consulte el artículo Excluir archivos y configuración .

Archivos de .xml de migración

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

Nota

El carácter comodín asterisco (*) se puede usar en cada uno de estos archivos. Sin embargo, no se puede usar un signo de interrogación (?) como carácter comodín.

  • El archivo MigApp.xml. Especifique este archivo con los comandos y LoadState.exe para migrar la ScanState.exe configuración de la aplicación.

  • El archivo MigDocs.xml. Especifique este archivo con las herramientas ScanState y LoadState para migrar todas las carpetas de usuario y los archivos que encuentra la función auxiliar MigXmlHelper.GenerateDocPatterns . Esta función auxiliar busca datos de usuario que residen en la raíz de cualquier unidad y en el directorio Usuarios. Sin embargo, no encuentra ni migra ningún dato de aplicación, archivos de programa ni ningún archivo en el directorio de Windows. El MigDocs.xml archivo se puede modificar.

  • El archivo MigUser.xml. Especifique este archivo con los ScanState.exe comandos y LoadState.exe para migrar carpetas de usuario, archivos y tipos de archivo. El MigUser.xml archivo se puede modificar. Este archivo no contiene reglas que migren cuentas de usuario específicas. La única manera de especificar qué cuentas de usuario migrar está en la línea de comandos mediante las opciones ScanState User y LoadState User.

Nota

No use los MigUser.xml archivos y MigDocs.xml juntos. Para obtener más información, consulte los artículos Identificación de tipos de archivo, archivos y carpetas y procedimientos recomendados de USMT .

Archivos de .xml personalizados

Se pueden crear archivos de.xml personalizados para personalizar la migración para las necesidades únicas de la organización. Por ejemplo, se puede crear un archivo de.xml personalizado para migrar una aplicación de línea de negocio o para modificar el comportamiento de migración predeterminado. Para ScanState.exe y LoadState.exe para usar este archivo, especifíquelo con ambos comandos. Para obtener más información, consulte el artículo Ejemplos XML personalizados .

El archivo Config.xml

El Config.xml archivo es un archivo opcional que se crea mediante la /genconfig opción con el ScanState.exe comando . Este archivo debe crearse y modificarse para excluir determinados componentes de la migración. Además, este archivo debe crearse y modificarse para excluir la migración de cualquiera de los valores del sistema operativo. El Config.xml formato de archivo es diferente de los archivos de.xml de migración porque no contiene ninguna regla de migración. Solo contiene una lista de los componentes del sistema operativo, las aplicaciones y los documentos de usuario que se pueden migrar. Para obtener un ejemplo, consulte el artículo ArchivoConfig.xml . Por este motivo, excluir los componentes que usan el Config.xml archivo es más fácil que modificar la migración .xml archivos. Config.xmlCon , no está familiarizado con las reglas y la sintaxis de migración. Sin embargo, los caracteres comodín no se pueden usar en un Config.xml archivo.

Para incluir todos los componentes predeterminados, no es necesario crear un Config.xml archivo. Como alternativa, si el comportamiento de migración predeterminado definido en los MigApp.xmlarchivos , MigDocs.xmly MigUser.xml es satisfactorio y solo es necesario excluir algunos componentes, se puede crear un Config.xml archivo. Los demás archivos .xml se pueden dejar en su estado original.

Cuando el ScanState.exe comando se ejecuta con la /genconfig opción , ScanState.exe lee los demás archivos .xml que se especifican mediante la /i opción para crear una lista personalizada de componentes que se pueden migrar desde el equipo. Este archivo solo contiene componentes del sistema operativo, aplicaciones y secciones del documento de usuario que se encuentran en ambos archivos .xml y que se instalan en el equipo cuando se ejecuta el ScanState.exe comando con la /genconfig opción . Por lo tanto, este archivo debe crearse en un equipo de origen que contenga todos los componentes, aplicaciones y configuraciones que están presentes en los equipos de destino. La creación del archivo en el equipo de origen garantiza que este archivo contiene todos los componentes que se pueden migrar. Los componentes se organizan en secciones: <Aplicaciones>, <WindowsComponentes> y <Documentos>. Para elegir no migrar un componente, cambie su entrada a migrate="no".

Una vez creado este archivo, solo debe especificarse con el ScanState.exe comando mediante la /Config opción para que afecte a la migración. Sin embargo, si es necesario excluir datos adicionales que se migraron al almacén, modifique el Config.xml archivo y especifique el archivo actualizado con el LoadState.exe comando . Por ejemplo, si la carpeta Documentos se recopila en el almacén, pero no es necesario migrar la carpeta Documentos a un equipo de destino, el Config.xml archivo se puede modificar para indicar migrate="no" antes de que se ejecute el LoadState.exe comando y no se migrará el archivo. Para obtener más información sobre la prioridad que tiene lugar al excluir datos, consulte el artículo Excluir archivos y configuraciones .

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

  • Si se quita un componente primario de la migración en el Config.xml archivo especificando migrate="no", todos sus componentes secundarios se quitan automáticamente de la migración, incluso si el componente secundario está establecido en migrate="yes".

  • Si por error existen dos líneas de código para el mismo componente donde especifica una línea migrate="no" y la otra línea especifica migrate="yes", se migra el componente.

  • En USMT, hay varias directivas de migración que se pueden configurar en el Config.xml archivo. Por ejemplo, se pueden configurar opciones adicionales <de ErrorControl>, <ProfileControl> y <HardLinkStoreControl> . Para obtener más información, consulte el artículo archivoConfig.xml .

Nota

Para excluir un componente del Config.xml archivo, establezca el valor de migración en "no". La eliminación de la etiqueta XML del componente del Config.xml archivo no excluye el componente de la migración.

Ejemplos

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

    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:5

  • El siguiente comando crea un almacén cifrado con el Config.xml archivo y la migración predeterminada .xml archivos:

    ScanState.exe \\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.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

Información adicional

  • Para obtener más información sobre cómo cambiar los archivos y la configuración que se migran, consulte los artículos de procedimientos de la Herramienta de migración de estado de usuario (USMT).
  • Para obtener más información sobre cada elemento .xml , consulte el artículo biblioteca de elementos XML .
  • Para obtener respuestas a preguntas comunes, consulte ".xml archivos" en el artículo Preguntas más frecuentes .