Sintaxis de LoadState
El LoadState.exe comando se usa con la Herramienta de migración de estado de usuario (USMT) para restaurar un almacén capturado previamente por el ScanState.exe comando en un equipo de destino. En este artículo se describe la sintaxis de LoadState.exe comandos y las opciones disponibles con ella.
Antes de comenzar
Antes de ejecutar el LoadState.exe comando, tenga en cuenta los siguientes elementos:
Para asegurarse de que toda la configuración del sistema operativo se migra, Microsoft recomienda ejecutar
LoadState.execomandos en modo de administrador desde una cuenta con credenciales administrativas.Para obtener información sobre los requisitos de software para ejecutar el
LoadState.execomando, consulte Requisitos de USMT.Cierre la sesión después de ejecutar el
LoadState.execomando. Algunas configuraciones, como por ejemplo, las fuentes, el fondo de pantalla y la configuración del protector de pantalla, no surtirá efecto hasta la próxima vez que el usuario inicie sesión.A menos que se especifique lo contrario, cada opción solo se puede usar una vez al ejecutar una herramienta desde la línea de comandos.
LoadState no requiere acceso de controlador de dominio para aplicar perfiles de dominio. Esta funcionalidad está disponible sin ninguna configuración adicional. No es necesario que el equipo de origen tenga acceso al controlador de dominio cuando se recopiló el perfil de usuario mediante ScanState. Sin embargo, los perfiles de dominio no son accesibles hasta que el equipo de destino se une al dominio.
En la tabla Opciones de línea de comandos incompatibles se enumeran las opciones que se pueden usar juntas y qué opciones de línea de comandos son incompatibles.
Sintaxis
En esta sección se explica la sintaxis y el uso de las opciones de línea de comandos disponibles al usar el LoadState.exe comando . Las opciones se pueden especificar en cualquier orden. Si la opción contiene un parámetro, se puede especificar un separador de dos puntos o espacio.
La LoadState.exe sintaxis del comando es:
LoadState.exe 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] [/?|ayuda]
Por ejemplo, para descifrar el almacén y migrar los archivos y la configuración a un equipo, escriba el siguiente comando:
LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"
Opciones de almacenamiento
USMT proporciona las siguientes opciones que se pueden usar para especificar cómo y dónde se almacenan los datos migrados.
| opción Command-Line | Descripción |
|---|---|
| StorePath | Indica la carpeta donde se almacenan los archivos y los datos de configuración.
StorePath debe especificarse cuando se usa el LoadState.exe comando . No se puede especificar más de un StorePath . |
|
/decrypt /key:KeyString or /decrypt /key:"Key String" or /decrypt /keyfile:[Path]FileName |
Descifra el almacén con la clave especificada. Con esta opción, la clave de cifrado debe especificarse de una de las siguientes maneras:
KeyString no puede superar los 256 caracteres. Las /key opciones y /keyfile no se pueden usar en la misma línea de comandos.Las /decrypt opciones y /nocompress no se pueden usar en la misma línea de comandos.
Importante Tenga cuidado al usar las /key opciones o keyfile . Por ejemplo, cualquier persona que tenga acceso a scripts que ejecuten el LoadState.exe comando con estas opciones también tiene acceso a la clave de cifrado.Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /decrypt:"nivel de cifrado" | La /decrypt opción acepta un parámetro de línea de comandos para definir la intensidad de cifrado especificada para el cifrado del almacén de migración. Para obtener más información sobre los algoritmos de cifrado admitidos, consulte 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ínculos duros. El /nocompress parámetro debe especificarse con /hardlink la opción . |
| /nocompress | Especifica que el almacén no está comprimido. Esta opción solo debe usarse en entornos de prueba. Microsoft recomienda usar un almacén comprimido durante la migración real. Esta opción no se puede usar con la /decrypt opción .Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
Opciones de regla de migración
USMT proporciona las siguientes opciones para especificar qué archivos se van a migrar.
| opción Command-Line | Descripción |
|---|---|
| /i:[Path]FileName |
(incluir) Especifica un archivo .xml que contiene reglas que definen qué datos se van a migrar. Esta opción se puede especificar varias veces para incluir todos los archivos de.xml ( MigApp.xml, MigSys.xmly los MigDocs.xml archivos de.xml personalizados que se crean).
La ruta de acceso puede ser una ruta de acceso relativa o completa. Si no se especifica la variable Path , FileName debe encontrarse en el directorio actual.Para obtener más información sobre qué archivos especificar, consulte la sección "Archivos XML" del artículo Preguntas más frecuentes . |
| /config:[Path]FileName | Especifica el Config.xml archivo que debe usar el LoadState.exe comando. Esta opción no se puede especificar más de una vez en la línea de comandos.
La ruta de acceso puede ser una ruta de acceso relativa o completa. Si no se especifica la variable Path , filename debe encontrarse en el directorio actual.En este ejemplo se migran los archivos y la configuración en función de las reglas de los Config.xmlarchivos , MigDocs.xmly MigApp.xml :LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
| /auto:"ruta de acceso a los archivos de script" | Esta opción permite especificar la ubicación de los archivos de.xml predeterminados. Si no se especifica ninguna ruta de acceso, USMT usa el directorio donde se encuentran los archivos binarios de USMT. La /auto opción tiene el mismo efecto que el uso de 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 se pueden usar para analizar los problemas que se producen durante la migración.
| opción Command-Line | Descripción |
|---|---|
| /l:[Path]FileName | Especifica la ubicación y el nombre del registro LoadState . Los archivos de registro no se pueden almacenar en StorePath.
La ruta de acceso puede ser una ruta de acceso relativa o completa. Si no se especifica la variable Path , el registro se crea en el directorio actual. La /v opción se puede especificar para ajustar la detalle del registro.Si se ejecuta el LoadState.exe comando desde un recurso de red compartido, se debe especificar la l opción o USMT produce un error:USMT no pudo crear los archivos de registro Para corregir este problema, asegúrese de especificar la /l opción al ejecutarse LoadState.exe desde un recurso de red compartido. |
/v:<VerbosityLevel> |
(Detalle) Habilita la salida detallada en el archivo de registro LoadState . El valor predeterminado es 0. VerbosityLevel se puede establecer en uno de los siguientes niveles:
Por ejemplo: LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml |
| /progress:[Path]FileName | Crea el registro de progreso opcional. Los archivos de registro no se pueden almacenar en StorePath.
La ruta de acceso puede ser una ruta de acceso relativa o completa. Si no se especifica la variable Path , filename se crea en el directorio actual. Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log |
| /c | Cuando se especifica esta opción, el LoadState.exe comando continúa ejecutándose, incluso si se producen errores no irrecuperables. Los archivos o configuraciones que provocan un error se registran en el registro de progreso. Por ejemplo, si hay un archivo grande que no cabe en el equipo, el LoadState.exe comando registra un error y continúa con la migración. Sin la /c opción , el LoadState.exe comando se cierra en el primer error. La < sección ErrorControl> se puede usar en el Config.xml archivo para especificar qué errores de lectura y escritura del registro o archivo se pueden omitir de forma segura y que podrían provocar un error en la migración. Este control de error permite que la /c opción de línea de comandos omita de forma segura todos los errores de entrada/salida (E/S) en el entorno. Además, la /genconfig opción ahora genera una sección ErrorControl> de ejemplo < que está habilitada especificando los mensajes de error y los comportamientos deseados en el Config.xml archivo. |
/r:<TimesToRetry> |
(Reintentar) Especifica el número de veces que se va a reintentar cuando se produce un error al migrar el estado de usuario desde un servidor. El valor predeterminado es tres veces. Esta opción es útil en entornos donde la conectividad de red no es confiable. Cuando se restaura el estado de usuario, la /r opción no recupera los datos que se pierden debido a un error de hardware de red, como un cable de red defectuoso o desconectado, o cuando se produce un error en una conexión de red privada virtual (VPN). La opción de reintento está pensada para redes grandes y ocupadas donde la conectividad es satisfactoria, pero la latencia de comunicación es un problema. |
/w:<SecondsBeforeRetry> |
(Esperar) Especifica el tiempo de espera, en segundos, antes de reintentar una operación de archivo de red. El valor predeterminado es 1 segundo. |
| /? o /help | Muestra ayuda en la línea de comandos. |
Opciones de usuario
De forma predeterminada, se migran todos los usuarios. La única manera de especificar qué usuarios incluir y excluir es mediante las siguientes opciones. Los usuarios no se pueden excluir en la migración .xml archivos ni mediante el Config.xml archivo . Para obtener más información, vea Identificar usuarios.
| opción Command-Line | Descripción |
|---|---|
| /todo | Migra todos los usuarios del equipo. USMT migra todas las cuentas de usuario del equipo, a menos que se excluya específicamente una cuenta con las /ue opciones o /uel . Por este motivo, no es necesario especificar esta opción en la línea de comandos. Sin embargo, si se usa la /all opción , /uino se pueden usar las opciones o /ue/uel . |
|
/ui:DomainName UserName or /ui:"DomainName User Name" or /ui:ComputerName LocalUserName |
(Incluir usuario) Migra el usuario especificado. De forma predeterminada, todos los usuarios se incluyen en la migración. Por lo tanto, esta opción solo resulta útil cuando se usa con la /ue opción . Se pueden especificar varias /ui opciones, pero la /ui opción no se puede usar con la /all opción .
DomainName y UserName pueden contener el carácter comodín asterisco (*). Cuando se especifica el nombre de usuario que contiene espacios, debe estar rodeado de comillas (").Por ejemplo, para incluir solo User2 del dominio corporativo, escriba: /ue:* /ui:corporate\user2
Nota Si se especifica un usuario para su inclusión con la /ui opción y también se especifica que se excluya con las /ue opciones o /uel , el usuario se incluye en la migración.Para obtener más ejemplos, vea las descripciones de las /uelopciones , /uey /ui de esta tabla. |
/uel:<NumberOfDays>or /uel: <YYYY/MM/DD>or /uel:0 |
(Exclusión del usuario en función del último inicio de sesión) Migra solo a los usuarios que iniciaron sesión en el equipo de origen dentro del período de tiempo especificado, en función de la fecha de última modificación del archivo Ntuser.dat en el equipo de origen. La /uel opción actúa como regla de inclusión. Por ejemplo, la /uel:30 opción migra los usuarios que iniciaron sesión o cuya cuenta de usuario se modificó en los últimos 30 días a partir de la fecha en que se ejecuta el ScanState.exe comando. Se puede especificar el número de días o se puede especificar una fecha. Esta opción no se puede usar con la /all opción . USMT recupera la última información de inicio de sesión del equipo local, por lo que no es necesario que el equipo esté conectado a la red al ejecutar esta opción. Además, si un usuario de dominio inicia sesión en otro equipo, USMT no tiene en cuenta esa instancia de inicio de sesión.
Nota La /uel opción no es válida en las migraciones sin conexión.Ejemplos:
Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0 |
|
/ue:DomainName\UserName or /ue"DomainName\User Name" or /ue:ComputerName\LocalUserName |
(Exclusión de usuario) Excluye a los usuarios especificados de la migración. Se pueden usar varias /ue opciones, pero la /ue opción no se puede usar con la /all opción .
DomainName y UserName pueden contener el carácter comodín asterisco (*). Cuando se especifica un nombre de usuario que contiene espacios, debe estar rodeado de comillas (").Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1Para obtener más ejemplos, vea las descripciones de las /uelopciones , /uey /ui de esta tabla. |
|
/md:OldDomain:NewDomain or /md:LocalComputerName:NewDomain |
(Mover dominio) Especifica un nuevo dominio para el usuario. Use esta opción para cambiar el dominio de los usuarios de un equipo o para migrar un usuario local a una cuenta de dominio. OldDomain puede contener el carácter comodín asterisco (). Esta opción se puede especificar más de una vez. Si consolida los usuarios de varios dominios en un solo dominio, es posible que sea necesario especificar varias /md opciones. Por ejemplo, para consolidar los usuarios de los dominios Corporativo y FarNorth en el dominio fabrikam, especifique los valores siguientes: /md:corporate:fabrikam y /md:farnorth:fabrikam.Si hay conflictos entre dos /md comandos, se aplica la primera regla especificada. Por ejemplo, si se especifican los /md:corporate:fabrikam comandos y /md:corporate:farnorth , los usuarios corporativos se asignarían al dominio fabrikam.
Nota Si se especifica un dominio que no existía en el equipo de origen, el LoadState.exe comando parece completarse correctamente, sin error ni advertencia. Sin embargo, en este caso, los usuarios no se mueven a NewDomain , sino que permanecen en su dominio original. Por ejemplo, si contoso está mal escrito y en su lugar se especifica /md:contso:fabrikam , los usuarios permanecen en contoso en el equipo de destino.Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /md:contoso:fabrikam |
|
/mu:OldDomain OldUserName:[NewDomain]NewUserName or /mu:OldLocalUserName:NewDomain NewUserName |
(Mover usuario) Especifica un nuevo nombre de usuario para el usuario especificado. Si el almacén contiene más de un usuario, se pueden especificar varias /mu opciones. Los caracteres comodín no se pueden usar con esta opción.Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1 |
| /lac:[Password] |
(Creación de cuenta local) Si una cuenta de usuario es:
/lae opción .Si no se especifica la /lac opción, no se migrarán las cuentas de usuario locales que aún no existan en el equipo de destino.La contraseña es la contraseña de la cuenta recién creada. De forma predeterminada, se usa una contraseña vacía.
Precaución Use la variable Password con precaución. La variable Password se proporciona en texto sin formato y cualquier persona con acceso al equipo que ejecuta el LoadState.exe comando puede obtener la contraseña.Además, si el equipo tiene varios usuarios, todos los usuarios migrados tienen la misma contraseña. Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystorePara obtener instrucciones, consulte Migración de cuentas de usuario. |
/lae |
(Habilitación de la cuenta local) Habilita la cuenta que se creó con la /lac opción . La /lac opción debe especificarse con esta opción.Por ejemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /lac:password /laePara obtener instrucciones, consulte Migración de cuentas de usuario. |
Ejemplos de las opciones /ui y /ue
Los ejemplos siguientes se aplican a las opciones /ui y /ue . La opción /ue se puede reemplazar por la opción /ui para incluir, en lugar de excluir, los usuarios especificados.
| Comportamiento | Comando |
|---|---|
| Excluya al usuario denominado User One en el dominio corporativo. | /ue:"corporate\user one" |
| Excluya al usuario denominado User1 en el dominio corporativo. | /ue:corporate\user1 |
| Excluya 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
Las /uelopciones y /ui/ue se pueden usar conjuntamente para migrar solo los usuarios que deben migrarse.
La opción /ui tiene prioridad sobre las opciones /ue y /uel. Si un usuario se incluye con la /ui opción y también se excluye mediante las /ue opciones o /uel , el usuario se incluye en la migración. Por ejemplo, si /ui:contoso\* /ue:contoso\user1 se especifica , se migra User1, porque la /ui opción tiene prioridad sobre la /ue opción .
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 por la /uel opción, el perfil de ese usuario se migra incluso si se excluye mediante la /ue opción . Por ejemplo, si /ue:contoso\user1 /uel:14 se especifica , user1 se migra si ha iniciado sesión en el equipo en los últimos 14 días.
| Comportamiento | Comando |
|---|---|
| Incluya solo User2 del dominio Fabrikam y excluya al resto de usuarios. | /ue:* /ui:fabrikam\user2 |
| Incluya solo el usuario local denominado User1 y excluya al resto de usuarios. | /ue:* /ui:user1 |
| Incluya solo los usuarios de dominio de Contoso, excepto Contoso\User1. | Este comportamiento no se puede completar con un solo comando. En su lugar, para migrar este conjunto de usuarios, especifique las siguientes opciones:
|
| Incluya solo usuarios locales (que no sean de dominio). | /ue: /ui:%computername%* |
Opciones de línea de comandos incompatibles
En la tabla siguiente se indica qué opciones de línea de comandos no son compatibles con el LoadState.exe comando . Si la entrada de tabla de una combinación determinada tiene , ✅las opciones son compatibles y se pueden usar juntas. El ❌ símbolo significa que las opciones no son compatibles. Por ejemplo, la /nocompress opción no se puede usar con la /encrypt opción .
| opción Command-Line | /keyfile | /nocompress | /genconfig | /todo |
|---|---|---|---|---|
| /Yo | ✅ | ✅ | ✅ | ✅ |
| /v | ✅ | ✅ | ✅ | ✅ |
| /nocompress | ✅ | N/D | ❌ | ✅ |
| /llave | ❌ | ✅ | ❌ | ✅ |
| /descifrar | Obligatorio* | ❌ | ❌ | ✅ |
| /keyfile | N/D | ✅ | ❌ | ✅ |
| /l | ✅ | ✅ | ✅ | ✅ |
| /progreso | ✅ | ✅ | ❌ | ✅ |
| /r | ✅ | ✅ | ❌ | ✅ |
| /w | ✅ | ✅ | ❌ | ✅ |
| /c | ✅ | ✅ | ❌ | ✅ |
| /p | ✅ | ✅ | ❌ | N/D |
| /todo | ✅ | ✅ | ❌ | ✅ |
| /Ui | ✅ | ✅ | ❌ | ❌ |
| /ue | ✅ | ✅ | ❌ | ❌ |
| /Uel | ✅ | ✅ | ❌ | ❌ |
| /genconfig | ✅ | ✅ | N/D | ✅ |
| /config | ✅ | ✅ | ❌ | ✅ |
| StorePath | ✅ | ✅ | ✅ | ✅ |
| /Md | ✅ | ✅ | ✅ | ✅ |
| /mu | ✅ | ✅ | ✅ | ✅ |
| /Lae | ✅ | ✅ | ✅ | ✅ |
| /laca | ✅ | ✅ | ✅ | ✅ |
Nota
/key La opción o /keyfile debe especificarse con la /decrypt opción .