Códigos de retorno
En este tema se describen los códigos de retorno y los mensajes de error de Herramienta de migración de estado de usuario (USMT) 5.0. También se incluye una enumeración de los códigos de retorno de USMT con los pasos de migración correspondientes. Además, en este tema se proporcionan sugerencias para ayudarte a usar los archivos de registro para determinar por qué recibiste un error.
Comprender los requisitos para ejecutar USMT puede ayudarte a minimizar errores en las migraciones de USMT. Para obtener más información, consulta Requisitos de USMT
En este tema
Códigos de retorno de USMT
Mensajes de error de USMT
Solución de problemas de códigos de retorno y mensajes de error
Códigos de retorno de USMT
Si encuentras un error en la migración de USMT, puedes usar los códigos de retorno y la información más específica que ofrecen los mensajes de error de USMT relacionados para solucionar el problema e identificar los pasos para mitigarlo.
Los códigos de retorno se clasifican en las siguientes categorías amplias que describen el área de informes de error:
Operación correcta o cancelada por el usuario
Líneas de comandos no válidas
Instalación e inicialización
Errores no irrecuperables
Errores irrecuperables
Te recomendamos que establezcas el nivel de detalle en 5, /v*:5*, en las líneas de comandos ScanState, LoadState y UsmtUtils para que los informes más detallados estén a tu disposición en los registros de USMT correspondientes. Puedes usar un nivel de detalle más alto si quieres que los resultados de los archivos de registro vayan a un depurador.
Mensajes de error de USMT
Los mensajes de error te permiten ver información más detallada sobre el problema de la migración que el código de retorno asociado. Por ejemplo, las herramientas ScanState, LoadState o UsmtUtils pueden devolver el código “11” (para “USMT_INVALID_PARAMETERS”) y un mensaje de error relacionado que indica que se especificaron /key y /keyfile. El mensaje de error se muestra en el símbolo del sistema y se identifica en los archivos de registro de ScanState, LoadState o UsmtUtils para ayudarte a determinar por qué recibiste ese código de retorno.
Para obtener más información sobre los códigos de error enumerados del sistema de la interfaz de programación de aplicaciones (API) de Windows, escribe net helpmsg en la línea de comandos y, luego, el número del código de error. Para obtener más información sobre los códigos de error del sistema, consulta este sitio web de Microsoft.
Solución de problemas de códigos de retorno y mensajes de error
En la siguiente tabla, se enumeran todos los códigos de retorno con su valor numérico, junto con los mensajes de error relacionados y las acciones sugeridas para solucionar problemas.
| Valor del código de retorno | Código de retorno | Mensaje de error | Solución del problema, mitigación o soluciones alternativas | Categoría |
|---|---|---|---|---|
0 |
USMT_SUCCESS |
Successful run |
No aplicable |
Operación correcta o cancelada |
1 |
USMT_DISPLAY_HELP |
Command line help requested |
No aplicable |
Operación correcta o cancelada |
2 |
USMT_STATUS_CANCELED |
Gather was aborted because of an EFS file |
No aplicable |
|
User chose to cancel (such as pressing CTRL+C) |
No aplicable |
Operación correcta o cancelada |
||
3 |
USMT_WOULD_HAVE_FAILED |
At least one error was skipped as a result of /c |
Revisa el registro de ScanState, LoadState o UsmtUtils para ver detalles sobre los errores de la línea de comandos. |
|
11 |
USMT_INVALID_PARAMETERS |
/all conflicts with /ui, /ue or /uel |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|
/auto expects an optional parameter for the script folder |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/encrypt can't be used with /nocompress |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/encrypt requires /key or /keyfile |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/genconfig can't be used with most other options |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/genmigxml can't be used with most other options |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/hardlink requires /nocompress |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/key and /keyfile both specified |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/key or /keyfile used without enabling encryption |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/lae is only used with /lac |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/listfiles cannot be used with /p |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/offline requires a valid path to an XML file describing offline paths |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/offlinewindir requires a valid path to offline windows folder |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
/offlinewinold requires a valid path to offline windows folder |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
A command was already specified |
Verifica que la sintaxis de la línea de comandos sea correcta y que no haya comandos duplicados. |
|||
An option argument is missing |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
An option is specified more than once and is ambiguous |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
By default /auto selects all users and uses the highest log verbosity level. Switches like /all, /ui, /ue, /v are not allowed. |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Command line arguments are required. Specify /? for options. |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Command line option is not valid |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
EFS parameter specified is not valid for /efs |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
File argument is invalid for /genconfig |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
File argument is invalid for /genmigxml |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Invalid space estimate path. Comprueba los parámetros o los permisos del sistema de archivos. |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
List file path argument is invalid for /listfiles |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Retry argument must be an integer |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Settings store argument specified is invalid |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. |
|||
Specified encryption algorithm is not supported |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
The /efs:hardlink requires /hardlink |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
The /targetWindows7 option is only available for Windows XP, Windows Vista®, and Windows 7 |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
The store parameter is required but not specified |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
The source-to-target domain mapping is invalid for /md |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
The source-to-target user account mapping is invalid for /mu |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Undefined or incomplete command line option |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
Líneas de comandos no válidas |
||
Use /nocompress, or provide an XML file path with /p"pathtoafile" to get a compressed store size estimate |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
User exclusion argument is invalid |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Verbosity level must be specified as a sum of the desired log options: Verbose (0x01), Record Objects (0x04), Echo to debug port (0x08) |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Volume shadow copy feature is not supported with a hardlink store |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
Wait delay argument must be an integer |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
12 |
USMT_ERROR_OPTION_PARAM_TOO_LARGE |
Command line arguments cannot exceed 256 characters |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
Líneas de comandos no válidas |
Specified settings store path exceeds the maximum allowed length of 256 characters |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
13 |
USMT_INIT_LOGFILE_FAILED |
Log path argument is invalid for /l |
Cuando se especifica /l en la línea de comandos ScanState, USMT valida la ruta de acceso. Comprueba que la unidad y otros datos, como los caracteres del sistema de archivos, sean correctos. |
Líneas de comandos no válidas |
14 |
USMT_ERROR_USE_LAC |
Unable to create a local account because /lac was not specified |
Cuando se crean cuentas locales, deben usarse las opciones /lac y /lae de la línea de comandos. |
Líneas de comandos no válidas |
26 |
USMT_INIT_ERROR |
Multiple Windows installations found |
Listfiles.txt could not be created. Verifica que la ubicación que especificaste para la creación de este archivo es válida. |
Instalación e inicialización |
Software malfunction or unknown exception |
Comprueba que no haya errores en todos los archivos .xml cargados; este es un error común cuando se usa /I para cargar el archivo Config.xml. |
|||
Unable to find a valid Windows directory to proceed with requested offline operation; Check if offline input file is present and has valid entries |
Comprueba que existe el archivo de salida sin conexión y que tiene entrada válidas. USMT no pudo encontrar un sistema operativo válido sin conexión. Comprueba la asignación de directorio sin conexión. |
|||
27 |
USMT_INVALID_STORE_LOCATION |
A store path can't be used because an existing store exists; specify /o to overwrite |
Especifica /o para sobrescribir un almacén intermedio o de migración existente. |
Instalación e inicialización |
A store path is missing or has incomplete data |
Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. |
|||
An error occurred during store creation |
Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. Especifica /o para sobrescribir un almacén intermedio o de migración existente. |
|||
An inappropriate device such as a floppy disk was specified for the store |
Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. |
|||
Invalid store path; check the store parameter and/or file system permissions |
Invalid store path; check the store parameter and/or file system permissions |
|||
The file layout and/or file content is not recognized as a valid store |
Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. Especifica /o para sobrescribir un almacén intermedio o de migración existente. |
|||
The store path holds a store incompatible with the current USMT version |
Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. |
|||
The store save location is read-only or does not support a requested storage option |
Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. |
|||
28 |
USMT_UNABLE_GET_SCRIPTFILES |
Script file is invalid for /i |
Comprueba que no haya errores en todos los archivos .xml de migración especificados. Este es un error común cuando se usa /i para cargar el archivo Config.xml. |
Instalación e inicialización |
Unable to find a script file specified by /i |
Verifica la ubicación de los archivos de script y asegúrate de que las opciones de la línea de comandos sean correctas. |
|||
29 |
USMT_FAILED_MIGSTARTUP |
A minimum of 250 MB of free space is required for temporary files |
Verifica que el sistema cumpla con el requisito mínimo de espacio de 250 MB en el disco temporal. Como solución alternativa, puedes establecer que la variable de entorno USMT_WORKING_DIR=<path> redirija el directorio de trabajo de los archivos temporales. |
Instalación e inicialización |
Another process is preventing migration; only one migration tool can run at a time |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo.xml de migración. |
|||
Failed to start main processing, look in log for system errors or check the installation |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo.xml de migración. |
|||
Migration failed because of an XML error; look in the log for specific details |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo.xml de migración. |
|||
Unable to automatically map the drive letters to match the online drive letter layout; Use /offline to provide a mapping table |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo.xml de migración. |
|||
31 |
USMT_UNABLE_FINDMIGUNITS |
An error occurred during the discover phase; the log should have more specific information |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo.xml de migración. |
Instalación e inicialización |
32 |
USMT_FAILED_SETMIGRATIONTYPE |
An error occurred processing the migration system |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo .xml de migración o escribe /? en la línea de comandos para obtener acceso a la ayuda en pantalla. |
Instalación e inicialización |
33 |
USMT_UNABLE_READKEY |
Error accessing the file specified by the /keyfile parameter |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo .xml de migración o escribe /? en la línea de comandos para obtener acceso a la ayuda en pantalla. |
Instalación e inicialización |
The encryption key must have at least one character |
Revisa el archivo de registro de ScanState para ver si hay errores en el archivo .xml de migración o escribe /? en la línea de comandos para obtener acceso a la ayuda en pantalla. |
|||
34 |
USMT_ERROR_INSUFFICIENT_RIGHTS |
Directory removal requires elevated privileges |
Inicia sesión como administrador y ejecuta con privilegios elevados. |
Instalación e inicialización |
No rights to create user profiles Inicia sesión como administrador y ejecuta con privilegios elevados |
Inicia sesión como administrador y ejecuta con privilegios elevados. |
|||
No rights to read or delete user profiles Inicia sesión como administrador y ejecuta con privilegios elevados |
Inicia sesión como administrador y ejecuta con privilegios elevados. |
|||
35 |
USMT_UNABLE_DELETE_STORE |
A reboot is required to remove the store |
Reinicia para eliminar los archivos que no se pudieron eliminar cuando se ejecutó el comando. |
Instalación e inicialización |
A store path can't be used because it contains data that could not be overwritten |
No se pudo eliminar el almacén de migración. Si usas un almacén de migración de vínculo permanente, es posible que encuentres allí un archivo bloqueado. Elimina el almacén manualmente o con el comando usmtutils /rd. |
|||
There was an error removing the store |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
36 |
USMT_ERROR_UNSUPPORTED_PLATFORM |
Compliance check failure; please check the logs for details |
Investiga si hay un perfil temporal activo en el sistema. |
Instalación e inicialización |
Use of /offline is not supported during apply |
No se usó el comando /offline durante la ejecución en el Entorno de preinstalación de Windows (Windows PE). |
|||
Use /offline to run gather on this platform |
No se usó el comando /offline durante la ejecución en Windows PE. |
|||
37 |
USMT_ERROR_NO_INVALID_KEY |
The store holds encrypted data but the correct encryption key was not provided |
Verifica que hayas incluido el elemento /key o /keyfile de cifrado correcto. |
Instalación e inicialización |
38 |
USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE |
An error occurred during store access |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. Asegúrate de que se pueda acceder a la ruta de acceso del almacén y de que estén establecidos los niveles de permisos correctos. |
Instalación e inicialización |
39 |
USMT_UNABLE_TO_READ_CONFIG_FILE |
Error reading Config.xml |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos en el archivo Config.xml. |
Instalación e inicialización |
File argument is invalid for /config |
Comprueba la línea de comandos que usaste para cargar el archivo Config.xml. Puedes escribir /? en la línea de comandos para obtener acceso a la ayuda en pantalla. |
|||
40 |
USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG |
Error writing to the progress log |
No se pudo crear el registro de progreso. Verifica que la ubicación sea válida y que tienes acceso de escritura. |
Instalación e inicialización |
Progress log argument is invalid for /progress |
No se pudo crear el registro de progreso. Verifica que la ubicación sea válida y que tienes acceso de escritura. |
|||
41 |
USMT_PREFLIGHT_FILE_CREATION_FAILED |
Can't overwrite existing file |
No se pudo crear el registro de progreso. Verifica que la ubicación sea válida y que tienes acceso de escritura. |
Instalación e inicialización |
Invalid space estimate path. Comprueba los parámetros o los permisos del sistema de archivos. |
Revisa el registro de ScanState o LoadState para ver detalles sobre los errores de la línea de comandos. |
|||
42 |
USMT_ERROR_CORRUPTED_STORE |
The store contains one or more corrupted files |
Revisa el registro de UsmtUtils log para ver detalles sobre los archivos dañados. Para obtener información sobre cómo extraer los archivos que no están dañados, consulta el tema sobre la Extraer archivos de un almacén de migración comprimido de USMT. |
|
61 |
USMT_MIGRATION_STOPPED_NONFATAL |
Processing stopped due to an I/O error |
USMT se cerró, pero puede continuar con la opción de línea de comandos /c, con la sección opcional configurable <ErrorControl> o con la opción de línea de comandos /vsc. |
Errores no irrecuperables |
71 |
USMT_INIT_OPERATING_ENVIRONMENT_FAILED |
A Windows Win32 API error occurred |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
Errores irrecuperables |
An error occurred when attempting to initialize the diagnostic mechanisms such as the log |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
|||
Failed to record diagnostic information |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
|||
Unable to start. Asegúrate de ejecutar USMT con privilegios elevados. |
Sal de USMT y vuelve a iniciar sesión con privilegios elevados. |
|||
72 |
USMT_UNABLE_DOMIGRATION |
An error occurred closing the store |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
Errores irrecuperables |
An error occurred in the apply process |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
|||
An error occurred in the gather process |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
|||
Out of disk space while writing the store |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
|||
Out of temporary disk space on the local system |
Empezó la transferencia de datos y se produjo un error durante la creación del almacén de migración o durante la fase de aplicación. Revisa el registro de ScanState o LoadState para ver los detalles. |
Consulte también
Otros recursos
Solución de problemas de la Herramienta de migración de estado de usuario (USMT)
Archivos de registro