Compartir a través de

Sintaxis de LoadState

  • Artículo

Este tema analiza la sintaxis y las opciones del comando LoadState.

En este tema

Antes de comenzar

Sintaxis

Opciones de almacenamiento

Opciones de reglas de migración

Opciones de supervisión

Opciones de usuario

Opciones de línea de comandos no compatibles

Antes de comenzar

Antes de ejecutar el comando LoadState, ten en cuenta lo siguiente:

  • Para asegurarte de migrar toda la configuración del sistema operativo, te recomendamos ejecutar los comandos LoadState en modo de administrador desde una cuenta con credenciales administrativas.

  • Para obtener información acerca de los requisitos de software para ejecutar el comando LoadState, consulta Requisitos de USMT.

  • Después de ejecutar el comando LoadState debes cerrar la sesión. Algunas opciones de configuración (por ejemplo, configuración de fuentes, papel tapiz y protector de pantalla) no serán efectivas hasta la próxima vez que el usuario inicie sesión.

  • A menos que se especifique lo contrario, puedes usar cada opción una sola vez al ejecutar una herramienta en la línea de comandos.

  • LoadState no requiere acceso al controlador de dominio para aplicar los perfiles de dominio. Esta funcionalidad se encuentra disponible sin ninguna configuración adicional. No es necesario que el equipo de origen haya tenido acceso al controlador de dominio cuando se recopiló el perfil de usuario con ScanState. Sin embargo, no se puede acceder a los perfiles de dominio hasta que el equipo de destino se haya unido al dominio.

  • La tabla Opciones de línea de comandos no compatibles muestra las opciones que se pueden usar juntas y las opciones de línea de comandos que no son compatibles.

Sintaxis

En esta sección se explica la sintaxis y el uso de las opciones de línea de comandos que se encuentran disponibles al utilizar el comando LoadState. Las opciones se pueden especificar en cualquier orden. Si la opción contiene un parámetro, puedes especificar un carácter de dos puntos o un separador de espacio.

La sintaxis del comando LoadState es la siguiente:

loadstate StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|help]

Por ejemplo, para descifrar el almacén y migrar los archivos y las opciones de configuración a un equipo que ejecuta Windows Vista o Windows 7, escribe lo siguiente en la línea de comandos:

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

Opciones de almacenamiento

USMT proporciona las siguientes opciones que pueden utilizarse para especificar de qué manera y dónde se almacenan los datos migrados.

Opción de línea de comandos Descripción

StorePath

Indica la carpeta donde se almacenan los archivos y los datos de configuración. Debes especificar StorePath al utilizar el comando LoadState. No puedes especificar más de un StorePath.

/decrypt /key:KeyString

o

/decrypt /key:"Key String"

o

/decrypt /keyfile:[Path\]FileName

Descifra el almacén con la clave especificada. Con esta opción, deberás especificar la clave de cifrado de una de las siguientes maneras:

  • /key: KeyString especifica la clave de cifrado. Si hay un espacio en KeyString, debes incluir el argumento entre comillas.

  • /keyfile: FilePathAndName especifica un archivo de texto (.txt) que contiene la clave de cifrado.

KeyString no puede exceder los 256 caracteres.

Las opciones /key y /keyfile no se pueden usar en la misma línea de comandos.

Las opciones /decrypt y /nocompress no se pueden usar en la misma línea de comandos.

> [!IMPORTANT] > Ten cuidado con esta opción, ya que cualquiera que tenga acceso al script de la línea de comandos LoadState también tendrá acceso a la clave de cifrado. >

Por ejemplo:

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

/decrypt: "seguridad del cifrado"

La opción /decrypt acepta un parámetro de línea de comandos para definir la seguridad del cifrado que se especifica para el cifrado del almacén de migración. Para obtener más información acerca de los algoritmos de cifrado compatibles, consulta Cifrado del almacén de migración.

/hardlink

Permite restaurar los datos de estado de usuario desde un almacén de migración de vínculo físico. El parámetro /nocompress se debe especificar con la opción /hardlink.

/nocompress

Especifica que el almacén no está comprimido. Solo debes usar esta opción en entornos de prueba. Te recomendamos usar un almacén comprimido durante la migración real. Esta opción no se puede usar con la opción /decrypt.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /nocompress

Opciones de reglas de migración

USMT ofrece las siguientes opciones para especificar los archivos que quieres migrar.

Opción de línea de comandos Descripción

/i:[Path\]FileName

(include)

Especifica un archivo .xml que contiene reglas que definen el estado que se va a migrar. Puedes especificar esta opción varias veces para incluir todos los archivos .xml (MigApp.xml, MigSys.xml, MigDocs.xml y cualquier archivo .xml personalizado que crees). Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, FileName debe estar ubicado en el directorio actual.

Para obtener más información acerca de los archivos que hay que especificar, consulta la sección sobre archivos XML del tema Preguntas más frecuentes.

/config:[Path\]FileName

Especifica el archivo Config.xml que debe usar el comando LoadState. No puedes especificar esta opción más de una vez en la línea de comandos. Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, entonces el FileName debe estar situado en el directorio actual.

En este ejemplo se migran los archivos y las opciones de configuración según las reglas de los archivos Config.xml, MigDocs.xml y MigApp.xml:

loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:loadstate.log

/auto: "ruta a los archivos de script"

Esta opción te permite especificar la ubicación de los archivos .xml predeterminados y luego iniciar la migración. Si no se especifica ninguna ruta de acceso, USMT utilizará el directorio donde se encuentran los binarios de USMT. La opción /auto tiene el mismo efecto que usar las siguientes opciones: /i:MigDocs.xml/i:MigApp.xml /v:5.

Opciones de supervisión

USMT proporciona varias opciones de línea de comandos que puedes usar para analizar los problemas que se producen durante la migración.

Opción de línea de comandos Descripción

/l:[Path\]FileName

Especifica la ubicación y el nombre del registro LoadState. No puedes almacenar los archivos de registro en StorePath. Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, el registro se creará en el directorio actual. Puedes especificar la opción /v para ajustar la cantidad de salida.

Si ejecutas el comando LoadState desde un recurso de red compartido, debes especificar esta opción o USMT no se ejecutará correctamente y generará un error que indica que USMT no pudo crear los archivos de registro. Para solucionar este problema, usa la opción /l:load.log.

/v: <nivelDetalle>

(Verbosity)

Permite la salida detallada en el archivo de registro de LoadState. El valor predeterminado es 0.

Puedes establecer VerbosityLevel en uno de los siguientes niveles:

 

Nivel Explicación

0

Solo se incluyen las advertencias y los errores predeterminados.

1

Se incluye información detallada.

4

Se incluye información sobre errores y sobre el estado.

5

Se incluye información detallada y sobre el estado.

8

Permite que se pase información sobre errores a un depurador.

9

Permite que se pase información detallada a un depurador.

12

Permite que se pase información sobre errores y estado a un depurador.

13

Se incluye información detallada, sobre el estado y sobre el depurador.

 
          </div>
          <p>Por ejemplo:</p>
          <p>
            <code>loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress:</strong>[<em>Path\</em>]<em>FileName</em></p>
        </td>
        <td colspan="1">
          <p>Crea un registro de progreso opcional. No puedes almacenar los archivos de registro en <em>StorePath</em>. <em>Path</em> puede ser una ruta de acceso relativa o completa. Si no especificas la variable <em>Path</em>, entonces <em>FileName </em>se creará en el directorio actual.</p>
          <p>Por ejemplo:</p>
          <p>
            <code>loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td>
          <p>Si se especifica esta opción, el comando <strong>LoadState</strong> continuará ejecutándose aunque se produzcan errores recuperables. Cualquier archivo o configuración que cause un error se registra en el registro de progreso. Por ejemplo, si hay un archivo cuyo tamaño supera el espacio disponible en el equipo, el comando <strong>LoadState</strong> registrará un error y continuará con la migración. Sin la opción <strong>/c</strong>, el comando <strong>LoadState</strong> saldrá en el primer error. Puedes usar la nueva sección &lt;<strong>ErrorControl</strong>&gt; del archivo Config.xml para especificar qué errores de lectura/escritura de Registro o de archivo se pueden omitir tranquilamente y cuáles podrían causar un error en la migración. Esto permite que la opción de línea de comandos <strong>/c</strong> omita de forma segura todos los errores de entrada/salida (E/S) en tu entorno. Además, la opción <strong>/genconfig</strong> ahora genera una sección &lt;<strong>ErrorControl</strong>&gt; de muestra que se habilita al especificar mensajes de error y comportamientos deseados en el archivo Config.xml.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/r:</strong>
            <em>&lt;TimesToRetry&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Reintentar)</strong>
          </p>
          <p>Especifica el número de reintentos cuando se produce un error al migrar el estado de usuario de un servidor. El valor predeterminado es tres veces. Esta opción es útil en entornos donde la conectividad de red no es confiable.</p>
          <p>Al restaurar el estado del usuario, la opción <strong>/r</strong> no recuperará los datos que se pierdan por un error de hardware de red, como un cable de red defectuoso o desconectado, o cuando se genere un error en una red privada virtual (VPN). La opción de reintentar está diseñada para redes grandes y ocupadas en las que la conectividad es satisfactoria pero la latencia de comunicación es un problema.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/w:</strong>
            <em>&lt;SecondsBeforeRetry&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Esperar)</strong>
          </p>
          <p>Especifica el tiempo que hay que esperar, en segundos, antes de reintentar una operación de archivo de red. El valor predeterminado es 1 segundo.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> o <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>Muestra la ayuda en la línea de comandos.</p>
        </td>
      </tr>
    </table>

Opciones de usuario

De forma predeterminada, se migran todos los usuarios. El único modo de especificar qué usuarios se deben incluir o excluir es usar las siguientes opciones. No puedes excluir usuarios en los archivos .xml de migración o mediante el archivo Config.xml. Para obtener más información, consulta Identificar usuarios.

Opción de línea de comandos Descripción

/all

Migra todos los usuarios en el equipo.

USMT migra todas las cuentas de usuario en el equipo, a menos que específicamente excluyas una cuenta con las opciones /ue o /uel. Por este motivo, no necesitas especificar esta opción en la línea de comandos. Sin embargo, si eliges usar la opción /all, no puedes usar las opciones /ui, /ue o /uel.

/ui: DomainName\UserName

o

/ui:"DomainName\User Name"

o

/ui: ComputerName\LocalUserName

(Incluir usuario)

Migra el usuario especificado. De manera predeterminada, todos los usuarios se incluyen en la migración. Por lo tanto, esta opción es útil solo cuando se usa con la opción /ue. Puedes especificar varias opciones /ui, pero no puedes usar la opción /ui con la opción /all. DomainName y UserName pueden contener el carácter comodín asterisco (*). Cuando especifiques un nombre de usuario que contenga espacios, deberás incluirlo entre comillas.

Por ejemplo:

  • Para incluir solo User2 del dominio Corporate, escribe:

    /ue:*\* /ui:corporate\user2

noteNota
Si se especifica la inclusión de un usuario con la opción /ui y también se especifica su exclusión con las opciones /ue o /uel, se incluirá el usuario en la migración.

Para obtener más ejemplos, consulta las descripciones de las opciones /uel, /ue y /ui en esta tabla.

/uel:<NumberOfDays>

o

/uel:<YYYY/MM/DD>

o

/uel:0

(Excluir usuario en función del último inicio de sesión)

Migra solamente los usuarios que iniciaron sesión en el equipo de origen dentro del período de tiempo especificado, según la fecha de la última modificación del archivo Ntuser.dat en el equipo de origen. La opción /uel actúa como una regla de inclusión. Por ejemplo, la opción /uel:30 migra los usuarios que iniciaron sesión o cuya cuenta de usuario se modificó en los últimos 30 días desde la fecha de ejecución del comando ScanState.

Puedes especificar un número de días o puedes especificar una fecha. No puedes usar esta opción con la opción /all. USMT recupera la información del último inicio de sesión del equipo local, de modo que no es necesario que el equipo esté conectado a la red cuando ejecutes esta opción. Además, si un usuario del dominio ha iniciado sesión en otro equipo, USMT no tiene en cuenta esa instancia de inicio de sesión.

noteNota
La opción /uel no es válida en las migraciones sin conexión.

Ejemplos:

  • /uel:0 migra las cuentas en las que se inició sesión en el equipo de origen cuando se ejecutó el comando ScanState.

  • /uel:90 migra los usuarios que han iniciado sesión o aquellos cuyas cuentas se han modificado de otra manera en los últimos 90 días.

  • /uel:1 migra los usuarios cuya cuenta se ha modificado en las últimas 24 horas.

  • /uel:2002/1/15 migra los usuarios que han iniciado sesión o aquellos cuyas cuentas se han modificado a partir del 15 de enero de 2002.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0

/ue:DomainName\UserName

o

/ue:"DomainName\User Name"

o

/ue:ComputerName\LocalUserName

(Excluir usuario)

Excluye los usuarios especificados de la migración. Puedes especificar varias opciones /ue pero no puedes usar la opción /ue con la opción /all. DomainName y UserName pueden contener el carácter comodín asterisco (*). Cuando especifiques un nombre de usuario que contenga espacios, deberás incluirlo entre comillas.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /ue:contoso\user1

Para obtener más ejemplos, consulta las descripciones de las opciones /uel, /ue y /ui en esta tabla.

/md: OldDomain:NewDomain

o

/md: LocalComputerName:NewDomain

(mover dominio)

Especifica un nuevo dominio para el usuario. Usa esta opción para cambiar el dominio de los usuarios en un equipo o para migrar un usuario local a una cuenta de dominio. OldDomain puede contener el carácter comodín asterisco (*).

Puedes especificar esta opción más de una vez. Es posible que quieras especificar varias opciones /md si estás consolidando usuarios de varios dominios en un solo dominio. Por ejemplo, podrías especificar lo siguiente para consolidar los usuarios de los dominios Corporate y FarNorth en el dominio Fabrikam: /md:corporate:fabrikam y /md:farnorth:fabrikam.

Si hay conflictos entre dos comandos /md, se aplica la primera regla que especifiques. Por ejemplo, si especificas los comandos /md:corporate:fabrikam y /md:corporate:farnorth, entonces los usuarios de Corporate se asignarían al dominio Fabrikam.

noteNota
Si especificas un OldDomain que no existía en el equipo de origen, parecerá que el comando LoadState se completa correctamente, sin un error o una advertencia. Sin embargo, en este caso, los usuarios no se moverán a NewDomain sino que permanecerán en su dominio original. Por ejemplo, si escribes mal "contoso" y especificas "/md:contso:fabrikam", los usuarios permanecerán en contoso en la carpeta de destino.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /md:contoso:fabrikam

/mu: OldDomain\OldUserName:[NewDomain\]NewUserName

o

/mu: OldLocalUserName:NewDomain\NewUserName

Especifica un nombre de usuario nuevo para el usuario especificado. Si el almacén contiene más de un usuario, puedes especificar varias opciones /mu. No puedes usar caracteres comodín con esta opción.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /mu:contoso\user1:fabrikam\user1

/lac:[Password]

(crear cuenta local)

Especifica que si una cuenta de usuario es una cuenta local (no del dominio) y no existe en el equipo de destino, USMT creará la cuenta en el equipo de destino pero estará deshabilitada. Para habilitar la cuenta, también debes usar la opción /lae.

Si no se especifica la opción /lac, no se migrará ninguna cuenta de usuario local que no exista ya en el equipo de destino.

Password es la contraseña de la cuenta recién creada. Se usa una contraseña vacía de forma predeterminada.

CautionPrecaución
Usa la variable Password con precaución ya que se proporciona en texto sin formato y cualquier persona con acceso al equipo que ejecute el comando LoadState podría obtenerla.

Además, si el equipo tiene varios usuarios, todos los usuarios migrados tendrán la misma contraseña.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

Para obtener instrucciones, consulta el tema sobre el Migrar cuentas de usuario.

/lae

(habilitar cuenta local)

Habilita la cuenta que se creó con la opción /lac . Debes especificar la opción /lac con esta opción.

Por ejemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /lac:password /lae

Para obtener instrucciones, consulta el tema sobre el Migrar cuentas de usuario.

Ejemplos de las opciones /ui y /ue

Los siguientes ejemplos se aplican a las opciones /ui y /ue. Puedes reemplazar la opción /ue por la opción /ui para incluir, en lugar de excluir, los usuarios especificados.

Comportamiento Comando

Excluir el usuario denominado User One en el dominio Corporate.

/ue:"corporate\user one"

Excluir el usuario denominado User1 en el dominio Corporate.

/ue:corporate\user1

Excluir el usuario local denominado User1.

/ue:%computername%\user1

Excluir todos los usuarios del dominio.

/ue:Domain\*

Excluir todos los usuarios locales.

/ue:%computername%\*

Excluir usuarios en todos los dominios denominados User1, User2, etc.

/ue:*\user*

Uso conjunto de las opciones

Puedes usar conjuntamente las opciones /uel, /ue y /ui para migrar solo los usuarios que quieras migrar.

La opción /ui tiene prioridad sobre las opciones /ue y /uel. Si se especifica un usuario para incluirlo con la opción /ui, y también se especifica para excluirlo con las opciones /ue o /uel, el usuario se incluirá en la migración. Por ejemplo, si especificas /ui:contoso\* /ue:contoso\user1, entonces se migrará User1 porque la opción /ui tiene prioridad sobre la opción /ue.

La opción /uel tiene prioridad sobre la opción /ue. Si un usuario ha iniciado sesión en el período de tiempo especificado establecido con la opción /uel, el perfil de ese usuario se migrará aunque se excluya con la opción /ue. Por ejemplo, si especificas /ue:contoso\user1 /uel:14, User1 se migrará si ha iniciado sesión en el equipo en los últimos 14 días.

Comportamiento Comando

Incluir solo User2 del dominio Fabrikam y excluir todos los demás usuarios.

/ue:*\* /ui:fabrikam\user2

Incluir solo el usuario local denominado User1 y excluir todos los demás usuarios.

/ue:*\* /ui:user1

Incluir solo los usuarios del dominio de Contoso, excepto Contoso\User1.

Este comportamiento no se puede completar con un solo comando. En lugar de ello, para migrar este conjunto de usuarios, deberás especificar lo siguiente:

  • Con la herramienta de la línea de comandos ScanState, escribe: /ue:*\* /ui:contoso\*

  • Con la herramienta de la línea de comandos LoadState, escribe: /ue:contoso\user1

Incluir solo usuarios locales (no del dominio).

/ue:*\* /ui:%computername%\*

Opciones de línea de comandos no compatibles

En la siguiente tabla se indican las opciones de línea de comandos que no son compatibles con el comando LoadState. Si la entrada de la tabla para una combinación en particular está en blanco, las opciones son compatibles y puedes usarlas conjuntamente. El símbolo X significa que las opciones no son compatibles. Por ejemplo, no puedes usar la opción /nocompress con la opción /encrypt.

Opción de línea de comandos /keyfile /nocompress /genconfig /all

/i

/v

/nocompress

No disponible

X

/key

X

X

/decrypt

Obligatorio*

X

X

/keyfile

No disponible

X

/l

/progress

X

/r

X

/w

X

/c

X

/p

X

No disponible

/all

X

/ui

X

X

/ue

X

X

/uel

X

X

/genconfig

No disponible

/config

X

StorePath

/md

/mu

/lae

/lac

Nota

Debes especificar la opción /key o /keyfile con la opción /encrypt.

Consulte también

Otros recursos

Biblioteca de elementos XML