Archivo Config.xml

Artículo
12/03/2013

Archivo Config.xml

El archivo Config.xml es un archivo opcional de la Herramienta de migración de estado de usuario (USMT) 5.0 que puedes crear usando la opción /genconfig con la herramienta ScanState.exe. Si quieres incluir todos los componentes predeterminados, pero no cambiar el comportamiento predeterminado de creación de almacén o de migración de perfiles, no es necesario que crees el archivo Config.xml.

Sin embargo, si estás satisfecho con el comportamiento de migración predeterminado definido en los archivos MigApp.xml, MigUser.xml y MigDocs.xml, pero quieres excluir determinados componentes, puedes crear y modificar un archivo Config.xml y dejar los otros archivos .xml inalterados. Por ejemplo, deberás crear y modificar el archivo Config.xml si quieres excluir algunas de las configuraciones del sistema operativo que se migran. Es necesario crear y modificar este archivo si quieres cambiar algunos de los comportamientos predeterminados de creación de almacén o migración de perfiles.

El archivo Config.xml tiene un formato distinto del de los demás archivos .xml de migración, porque no contiene reglas de migración. Contiene solamente una lista de los componentes del sistema operativo, aplicaciones y documentos de usuario que se pueden migrar, además de una directiva de perfil de usuario y una directiva de control de errores. Por esta razón, excluir componentes con el archivo Config.xml es más fácil que modificar los archivos .xml de migración, porque no necesitas conocer las reglas y la sintaxis de migración. Sin embargo, no puedes usar caracteres comodín en este archivo.

Para obtener más información sobre el uso del archivo Config.xml con otros archivos de migración (como los archivos MigDocs.xml y MigApps.xml), consulta el tema donde se explican Descripción de archivos XML de migración.

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.

En este tema

En la USMT hay nuevas directivas de migración que se pueden configurar en el archivo Config.xml. Por ejemplo, puedes configurar las opciones adicionales <ErrorControl>, <ProfileControl> y <HardLinkStoreControl>. Los siguientes elementos y parámetros se usan solo en el archivo Config.xml.

<fatal>

Archivo Config.xml de muestra

<Policies>

El elemento <Policies> contiene elementos que describen las directivas que USMT sigue al crear un almacén de migración. Los elementos secundarios válidos del elemento <Policies> son <ErrorControl> y <HardLinkStoreControl>. El elemento <Policies> es un elemento secundario de <Configuration>.

Sintaxis: <Policies> </Policies>

<ErrorControl>

El elemento <ErrorControl> es un elemento opcional que puedes configurar en el archivo Config.xml. Las reglas <ErrorControl> configurables solo admiten variables del entorno relativas al sistema operativo que se está ejecutando y al usuario actualmente conectado. Como solución alternativa, puedes especificar una ruta de acceso con el carácter comodín (*).

Número de repeticiones: una vez por cada componente
Elementos primarios: el elemento <Policies>
Elementos secundarios: los elementos <fileError> y <registryError>

Sintaxis: <ErrorControl></ErrorControl>

En el siguiente ejemplo se especifica que se deben pasar por alto todos los archivos bloqueados, sin importar su ubicación (incluidos los archivos de C:\Usuarios). Sin embargo, la migración no se culmina si no se puede acceder a cualquiera de los archivos en C:\Usuarios por el motivo que sea. En el siguiente ejemplo, el elemento <ErrorControl> omite los problemas existentes en las claves del Registro de migración que coincidan con el patrón suministrado y los resuelve con un error de Acceso denegado.

Por otra parte, el orden de la sección <ErrorControl> implica prioridad. En este ejemplo, la primera etiqueta <nonFatal> tiene precedencia sobre la segunda etiqueta <fatal>. Esta precedencia se aplica sin importar cuántas etiquetas haya enumeradas.

<ErrorControl>
  <fileError>
    <nonFatal errorCode="33">* [*]</nonFatal>
    <fatal errorCode="any">C:\Users\* [*]</fatal>
  </fileError>
  <registryError>
    <nonFatal errorCode="5">HKCU\SOFTWARE\Microsoft\* [*]</nonFatal>
  </registryError>
</ErrorControl>

Importante

Las reglas <ErrorControl> configurables solo admiten variables del entorno relativas al sistema operativo que se está ejecutando y al usuario actualmente conectado. Como solución alternativa, puedes especificar una ruta de acceso con el carácter comodín (*).

<fatal>

El elemento <fatal> no es obligatorio.

Número de repeticiones: una vez por cada componente
Elementos primarios: <fileError> y <registryError>
Elementos secundarios: ninguno.

Sintaxis: <fatal errorCode="any"><pattern></fatal>

Parámetro	Obligatorio	Valor
errorCode	No	"any" o "especificar mensaje de error de sistema aquí"

El elemento <fatal> sirve para especificar que los errores que coinciden con un patrón específico deben hacer que USMT detenga la migración.

<fileError>

El elemento <fileError> no es obligatorio.

Número de repeticiones: una vez por cada componente
Elementos primarios: <ErrorControl>
Elementos secundarios: <nonFatal> y <fatal>

Sintaxis: <fileError></fileError>

El elemento <fileError> sirve para representar el comportamiento asociado a los errores de archivo.

<nonFatal>

El elemento <nonFatal> no es obligatorio.

Número de repeticiones: una vez por cada componente
Elementos primarios: los elementos <fileError> y <registryError>.
Elementos secundarios: ninguno.

Sintaxis: <nonfatal errorCode="any"><pattern></nonFatal>

Parámetro	Obligatorio	Valor
<errorCode>	No	"any" o "especificar mensaje de error del sistema aquí". Si no se especifican mensajes de error del sistema, el comportamiento predeterminado aplica el parámetro a todos los mensajes de error del sistema.

El elemento <nonFatal> sirve para especificar que los errores que coinciden con un patrón específico no deben hacer que USMT detenga la migración.

<registryError>

El elemento <registryError> no es obligatorio.

Número de repeticiones: una vez por cada componente
Elementos primarios: <ErrorControl>
Elementos secundarios: <nonfatal> y <fatal>

Sintaxis: <registryError></registryError>

Parámetro	Obligatorio	Valor
<errorCode>	No	"any" o "especificar mensaje de error del sistema aquí". Si no se especifican mensajes de error del sistema, el comportamiento predeterminado aplica el parámetro a todos los mensajes de error del sistema.

El elemento <registryError> sirve para especificar que los errores que coinciden con un patrón específico no deben hacer que USMT detenga la migración.

<HardLinkStoreControl>

El elemento <HardLinkStoreControl> contiene elementos que describen cómo tratar los archivos al crear un almacén de migración de vínculo físico. Su único elemento secundario válido es <fileLocked>.

Sintaxis: <HardLinkStoreControl> </HardLinkStoreControl>

Número de repeticiones: una vez por cada componente
Elementos primarios: <Policies>
Elementos secundarios: <fileLocked>

Sintaxis: <HardLinkStoreControl></HardLinkStoreControl>

El siguiente código de muestra de <HardLinkStoreControl> especifica que se pueden crear vínculos físicos a los archivos bloqueados solo si el archivo bloqueado en cuestión reside en alguna parte de C:\Usuarios\. De lo contrario, se produce un error de acceso a archivo cuando se encuentre un archivo bloqueado que no se pueda copiar, aunque técnicamente sea posible crear el vínculo.

Importante

La sección <ErrorControl> se puede configurar para omitir los errores de acceso a archivo en cada situación, en función de la ubicación del archivo.

<Policy>
   <HardLinkStoreControl>
      <fileLocked>
         <createHardLink>C:\Users\*</createHardLink>
         <errorHardLink>C:\*</errorHardLink>
      </fileLocked>
   </HardLinkStoreControl>
   <ErrorControl>
      […]
   </ErrorControl>
</Policy>

<fileLocked>

El elemento <fileLocked> contiene elementos que describen cómo tratar los archivos que están bloqueados para su modificación. Las reglas que define el elemento <fileLocked> se procesan en el orden en el que figuran en el archivo XML.

Sintaxis: <fileLocked></fileLocked>

<createHardLink>

El elemento <createHardLink> define un patrón MigXML estándar que describe rutas de acceso a archivos donde se deben crear vínculos físicos, aun cuando el archivo esté bloqueado y otra aplicación no pueda modificarlo.

Sintaxis: <createHardLink><pattern></createHardLink>

<errorHardLink>

El elemento <errorHardLink> define un patrón MigXML estándar que describe rutas de acceso a archivos donde no se deben crear vínculos físicos si el archivo está bloqueado y otra aplicación no pueda modificarlo. USMT intentará copiar en el almacén de migración los archivos que haya en estas rutas de acceso. Sin embargo, si no es posible, se genera Error_Locked. Se trata de un error estándar de la interfaz de programación de aplicaciones (API) de Windows que se puede capturar con la sección <ErrorControl> para que USMT omita el archivo o anule la migración.

Sintaxis: <errorHardLink><pattern></errorHardLink>

<ProfileControl>

Este elemento sirve para contener otros elementos que establecen reglas para migrar perfiles, usuarios y directivas en torno a la pertenencia al grupo local durante la migración. <ProfileMigration> es un elemento secundario de <Configuration>.

Sintaxis: <ProfileControl> </ProfileControl>

<localGroups>

Este elemento sirve para contener otros elementos que establecen reglas sobre cómo migrar grupos locales. <localGroups> es un elemento secundario de <ProfileControl>.

Sintaxis: <localGroups> </localGroups>

<mappings>

Este elemento sirve para contener otros elementos que establecen asignaciones entre grupos.

Sintaxis: <mappings> </mappings>

<changeGroup>

Este elemento describe los grupos de origen y destino de un cambio de pertenencia a grupo durante la migración. Es un elemento secundario de <localGroups>. Se definen los siguientes parámetros:

Parámetro	Obligatorio	Valor
From	Sí	Grupo local válido en el equipo de origen que contiene los usuarios seleccionados para la migración en la línea de comandos.
To	Sí	Grupo local al que se van a mover los usuarios durante la migración.
appliesTo	Sí	nonmigratedUsers, migratedUsers, AllUsers. Este valor define a qué usuarios va a afectar la operación de cambio de grupo.

Los elementos secundarios obligatorios y válidos de <changeGroup> son <include> y <exclude>. Si bien ambos pueden ser elementos secundarios al mismo tiempo, solo uno es necesario.

Sintaxis: <changeGroup From="Group1" To= "Group2"> </changeGroup>

<include>

Este elemento especifica que su elemento secundario obligatorio, <pattern>, debe incluirse en la migración.

Sintaxis: <include>``</include>

<exclude>

Este elemento especifica que su elemento secundario obligatorio, <pattern>, debe excluirse de la migración.

Sintaxis: <exclude>`` </exclude>