Compartir a través de

Códigos de retorno

  • Artículo

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