Compartir a través de

Sintaxis de UsmtUtils

  • Artículo

En este tema se explica la sintaxis de las utilidades que hay disponibles en la Herramienta de migración de estado de usuario (USMT) 5.0 a través de la interfaz de línea de comandos. Estas utilidades:

  • Mejoran la capacidad de elegir las opciones de cifrado para la migración.

  • Ayudan a quitar los almacenes de vínculo físico que, de otro modo, no se pueden eliminar (por un bloqueo de archivos compartidos).

  • Comprueban si el archivo de catálogo u otros archivos del almacén de migración comprimido están dañados.

  • Extraen los archivos del almacén de migración comprimido al migrar archivos y configuraciones al equipo de destino.

En este tema

Usmtutils.exe

Opciones de comprobación

Opciones de extracción

Usmtutils.exe

En la siguiente tabla se enumeran las opciones de línea de comandos de USMTutils.exe. Las secciones que siguen a continuación contienen más opciones de línea de comandos para las opciones /verify y /extract.

La sintaxis de UsmtUtils.exe es la siguiente:

usmtutils [/ec | /rd <directorioAlmacén> | /verify <rutaArchivo> [options] | /extract <rutaArchivo><rutaDestino> [options]]

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

/ec

Devuelve una lista de los algoritmos de cifrado admitidos (IdAlg) en el sistema actual. Puedes usar esta opción en un equipo de destino para saber qué algoritmo usar con el comando /encrypt antes de ejecutar la herramienta ScanState en el equipo de origen.

/rd <directorioAlmacén>

Quita la ruta de acceso al directorio especificada por el argumento <directorioAlmacén> en el equipo. Puedes usar este comando para quitar almacenes de migración de vínculo físico que, de otro modo, no se podrían eliminar con un símbolo del sistema, debido a un bloqueo de archivos compartidos. Si el almacén de migración abarca varios volúmenes de una unidad determinada, se quitará de todos estos volúmenes.

Por ejemplo:

usmtutils /rd D:\MyHardLinkStore

/y

Invalida la solicitud de aceptación de eliminaciones cuando se usa con la opción /rd. Cuando usas la opción /y con la opción /rd, no tendrás que aceptar las eliminaciones antes de que USMT elimine los directorios.

/verify

Devuelve información acerca de si el almacén de migración comprimido está intacto o contiene archivos dañados o un catálogo dañado.

Consulta Opciones de comprobación para obtener información sobre la sintaxis y las opciones que se deben usar con /verify.

/extract

Recupera archivos de un almacén de migración comprimido de USMT.

Consulta Opciones de extracción para obtener información sobre la sintaxis y las opciones que se deben usar con /extract.

Opciones de comprobación

Usa la opción /verify cuando quieras saber si un almacén de migración comprimido está intacto o si contiene archivos dañados o un catálogo dañado. Para obtener más información sobre cómo usar la opción /verify, consulta el tema sobre Comprobar la condición de un almacén de migración comprimido.

La sintaxis de /verify es la siguiente:

usmtutils /verify[:<tipoInforme>] <rutaArchivo> [/l:<archivoRegistro>] [/v:<nivelDetalle>] [/decrypt [:<IdAlg>] {/key:<cadenaClave> | /keyfile:<nombreArchivo>}]

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

<tipoInforme>

Especifica si se informará acerca de todos los archivos, solo de los archivos dañados o del estado del catálogo.

  • Summary. Devuelve el número de archivos que están intactos y el número de archivos que están dañados en el almacén de migración. Si no se especifica ningún algoritmo, se muestra el informe de resumen de forma predeterminada.

  • all. Devuelve una lista delimitada por tabulaciones de todos los archivos del almacén de migración comprimido, además del estado de cada archivo. Cada línea contiene el nombre de archivo, seguido de un espaciado de tabulación, más el mensaje “CORRUPTED” (dañado) u “OK” (correcto), según el estado del archivo. La última entrada informa del estado de daño del "CATALOG" (catálogo) del almacén. Un archivo de catálogo contiene metadatos de todos los archivos del almacén de migración. La herramienta LoadState necesita un archivo de catálogo válido para abrir el almacén de migración. Devuelve el mensaje "OK" si el archivo de catálogo está intacto y LoadState puede abrir el almacén de migración, o bien devuelve el mensaje "CORRUPTED" si el almacén de migración está dañado.

  • failureonly. Devuelve una lista delimitada por tabulaciones con únicamente los archivos dañados en el almacén de migración.

  • Catalog. Devuelve el estado del archivo de catálogo únicamente.

/l: <rutaArchivoRegistro>

Especifica la ubicación y el nombre del archivo de registro.

/v: <nivelDetalle>

(Verbosity)

Permite que se incluyan distintos tipos de información detallada en el archivo de registro de UsmtUtils. 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.

/decrypt: <Idalg> /key:<cadenaClave>

o

/decrypt: <Idalg> /key:<“Cadena de clave”>

o

/decrypt: <IDalg> /keyfile:<nombreArchivo>

Especifica que se usó la opción /encrypt para crear el almacén de migración con la herramienta ScanState. Para descifrar el almacén de migración, especifica una opción /key o /keyfile de la siguiente manera:

  • <IDalg> especifica el algoritmo criptográfico que se usó para crear el almacén de migración en la línea de comandos de ScanState. Si no se especifica ningún algoritmo, ScanState y UsmtUtils usan el algoritmo 3DES de forma predeterminada.

    Entre los valores válidos de <IDalg> se incluyen AES_128, AES_192, AES_256, 3DES o 3DES_112.

  • /key: <cadenaClave> especifica la clave de cifrado. Si hay un espacio en <cadenaClave>, deberás entrecomillar el argumento.

  • /keyfile: <nombreArchivo> especifica la ubicación y el nombre de un archivo de texto (.txt) que contiene la clave de cifrado.

Para obtener más información acerca de los algoritmos de cifrado admitidos, consulta el tema sobre el Cifrado del almacén de migración.

Algunos ejemplos de comandos /verify:

  • usmtutils /verify D:\MyMigrationStore\store.mig

  • usmtutils /verify:catalog D:\MyMigrationStore\store.mig

  • usmtutils /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txt

  • usmtutils /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt

Opciones de extracción

Usa la opción /extract para recuperar archivos de un almacén de migración de USMT comprimido, si no se va a restaurar con normalidad mediante LoadState. Para obtener más información acerca de cómo usar la opción /extract, consulta el tema sobre Extraer archivos de un almacén de migración comprimido de USMT.

La sintaxis de /extract es la siguiente:

/extract <rutaArchivo><rutaDestino> [/i:<patrónInclusión>] [/e: <patrónExclusión>] [/l: <archivoRegistro>] [/v: <nivelDetalle>] [/decrypt[:<IDalg>] {key: <cadenaClave> | /keyfile: <nombreArchivo>}] [/o]

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

<rutaArchivo>

Ruta de acceso al almacén de migración de USMT.

Por ejemplo:

D:\MyMigrationStore\USMT\store.mig

<rutaDestino>

Ruta de acceso a la capeta en la que la herramienta deposita los archivos individuales.

/i:<patrónInclusión>

Especifica un patrón para incluir los archivos en la extracción. Puedes especificar más de un patrón. Separa los patrones por una coma o por un punto y coma. Puedes usar las opciones /i: <patrónInclusión> y /e: <patrónExclusión> en el mismo comando. Cuando se combinan patrones de inclusión y de exclusión en la línea de comandos, los primeros tienen precedencia sobre los segundos.

/e:<patrónExclusión>

Especifica un patrón para excluir los archivos de la extracción. Puedes especificar más de un patrón. Separa los patrones por una coma o por un punto y coma. Puedes usar las opciones /i: <patrónInclusión> y /e: <patrónExclusión> en el mismo comando. Cuando se combinan patrones de inclusión y de exclusión en la línea de comandos, los primeros tienen precedencia sobre los segundos.

/l:<rutaArchivoRegistro>

Especifica la ubicación y el nombre del archivo de registro.

/v: <nivelDetalle>

(Verbosity)

Permite que se incluyan distintos tipos de información detallada en el archivo de registro de UsmtUtils. 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.

/decrypt: <Idalg> /key:<cadenaClave>

o

/decrypt: <Idalg> /key:<“Cadena de clave”>

o

/decrypt: <IDalg> /keyfile:<nombreArchivo>

Especifica que se usó la opción /encrypt para crear el almacén de migración con la herramienta ScanState. Para descifrar el almacén de migración, también debes especificar una opción /key o /keyfile de la siguiente manera:

  • <IDalg> especifica el algoritmo criptográfico que se usó para crear el almacén de migración en la línea de comandos de ScanState. Si no se especifica ningún algoritmo, ScanState y UsmtUtils usan el algoritmo 3DES de forma predeterminada.

    Entre los valores válidos de <IDalg> se incluyen AES_128, AES_192, AES_256, 3DES o 3DES_112.

  • /key: <cadenaClave> especifica la clave de cifrado. Si hay un espacio en <cadenaClave>, deberás entrecomillar el argumento.

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

Para obtener más información acerca de los algoritmos de cifrado admitidos, consulta el tema sobre el Cifrado del almacén de migración.

/o

Sobrescribe los archivos de salida existentes.

Algunos ejemplos de comandos /extract:

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStore

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txt

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txt

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o

Consulte también

Otros recursos

Sintaxis de línea de comandos de la Herramienta de migración de estado de usuario (USMT)
Códigos de retorno