Compartir a través de


Sintaxis de UsmtUtils

En este artículo se describe la sintaxis de las utilidades disponibles en User State Migration Tool (USMT) a través de la interfaz de la línea de comandos. Estas utilidades:

  • Mejorar la capacidad de determinar las opciones criptográficas para la migración.

  • Ayuda a quitar almacenes de vínculos duros que, de lo contrario, no se pueden eliminar debido a un bloqueo de uso compartido.

  • Compruebe si el archivo de catálogo o cualquiera de los demás archivos del almacén de migración comprimido están dañados.

  • Extraiga archivos del almacén de migración comprimido creado cuando los archivos y la configuración se migren al equipo de destino.

UsmtUtils.exe

En la tabla siguiente se enumeran las opciones de línea de comandos para UsmtUtils.exe. Las secciones siguientes proporcionan más opciones de línea de comandos para /verify las opciones y /extract .

La sintaxis de UsmtUtils.exe es:

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

Opción de línea de comandos Descripción
/EC Devuelve una lista de algoritmos criptográficos admitidos (AlgID) en el sistema actual. Esta opción se puede usar en un equipo de destino para determinar qué algoritmo usar con el /encrypt comando antes de ejecutar la herramienta ScanState en el equipo de origen.
/rd<storeDir> Quita la ruta de acceso del directorio especificada por el <argumento storeDir> en el equipo. Este comando se puede usar para eliminar almacenes de migración de vínculos duros que, de lo contrario, no se pueden eliminar en un símbolo del sistema debido a un bloqueo de uso compartido. Si el almacén de migración abarca varios volúmenes en una unidad determinada, el almacén de migración se elimina de todos estos volúmenes.

Por ejemplo:
UsmtUtils.exe /rd D:\MyHardLinkStore
/y Invalida el símbolo del sistema para aceptar eliminaciones cuando se usa con la /rd opción . Cuando se usa la /y opción con la /rd opción , no se muestra un símbolo del sistema para aceptar las eliminaciones antes de que USMT elimine los directorios.
/verificar Devuelve información sobre si el almacén de migración comprimido está intacto o si contiene archivos dañados o un catálogo dañado.

Consulte Verify options for syntax and options to use with /verify.
/extraer Recupera archivos de un almacén de migración de USMT comprimido.

Consulte Extracción de opciones para ver la sintaxis y las opciones que se usarán con /extract.

Comprobar las opciones

Use la /verify opción para determinar 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 /verify opción, vea Comprobar la condición de un almacén de migración comprimido.

La sintaxis de /verify es:

UsmtUtils.exe /verify[:<reportType>] <filePath> [/l:<logfile>] [/v:VerbosityLevel] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<filename>}]

Opción de línea de comandos Descripción
<reportType> Especifica si se debe informar sobre todos los archivos, solo los archivos dañados o el estado del catálogo.
  • Resumen. Devuelve tanto el número de archivos que están intactos como el número de archivos dañados en el almacén de migración. Si no se especifica ningún algoritmo, el informe de resumen se muestra como valor predeterminado.
  • todo. Devuelve una lista delimitada por tabulaciones de todos los archivos del almacén de migración comprimido y el estado de cada archivo. Cada línea contiene el nombre de archivo seguido de un espaciado de tabulación y DAÑADO o Correcto según el estado del archivo. La última entrada notifica el estado de daños del CATÁLOGO del almacén. Un archivo de catálogo contiene metadatos para todos los archivos de un almacén de migración. La herramienta LoadState requiere un archivo de catálogo válido para abrir el almacén de migración. Devuelve "Ok" si el archivo de catálogo está intacto y LoadState puede abrir el almacén de migración y "CORRUPTED" si el almacén de migración está dañado.
  • failureonly. Devuelve una lista delimitada por tabulaciones de solo los archivos dañados en el almacén de migración comprimido.
  • Catálogo. Devuelve solo el estado del archivo de catálogo.
/l:
<logfilePath>
Especifica la ubicación y el nombre del archivo de registro.
/v:<VerbosityLevel> (Detalle)

Habilita la salida detallada en el archivo de registro UsmtUtils . El valor predeterminado es 0.

VerbosityLevel se puede establecer en uno de los siguientes niveles:
  • 0 : solo se habilitan los errores y advertencias predeterminados.
  • 1 : habilita la salida detallada.
  • 4 : habilita la salida de estado y error.
  • 5 : habilita la salida detallada y de estado.
  • 8 : habilita la salida de error en un depurador.
  • 9 : habilita la salida detallada en un depurador.
  • 12 : habilita la salida de estado y error en un depurador.
  • 13 : habilita la salida detallada, de estado y del depurador.
/decrypt<AlgID>/:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>
Especifica que la /encrypt opción se usó para crear el almacén de migración con la herramienta ScanState . Para descifrar el almacén de migración, especifique una /key opción o /keyfile como se indica a continuación:
  • <AlgID> especifica el algoritmo criptográfico que se usó para crear el almacén de migración en la línea de ScanState.exe comandos. Si no se especifica ningún algoritmo, ScanState y UsmtUtils usan el algoritmo 3DES como valor predeterminado.
    Los valores válidos de AlgID> incluyen: , , , o .<3DES_1123DESAES_256AES_192AES_128
  • /key: <KeyString> especifica la clave de cifrado. Si hay un espacio en <KeyString>, el argumento debe estar entre comillas.
  • /keyfile: <FileName> 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 sobre los algoritmos de cifrado admitidos, consulte Cifrado del almacén de migración.

Algunos ejemplos de /verify comandos:

  • UsmtUtils.exe /verify D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:catalog D:\MyMigrationStore\store.mig

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

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

Opciones de extracción

Use la /extract opción para recuperar archivos de un almacén de migración de USMT comprimido si no se restaura normalmente con LoadState. Para obtener más información sobre cómo usar la /extract opción, consulte Extracción de archivos de un almacén de migración de USMT comprimido.

La sintaxis de /extract es:

/extract <filePath><destinationPath> [/i:<includePattern>] [/e: <excludePattern>] [/l: <logfile>] [/v: VerbosityLevel>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <filename>}] [/o]

Opción de línea de comandos Descripción
<filePath> Ruta de acceso al almacén de migración de USMT.

Por ejemplo:
D:\MyMigrationStore\USMT\store.mig
<destinationPath> Ruta de acceso a la carpeta donde la herramienta coloca los archivos individuales.
/i:<includePattern> Especifica un patrón para que los archivos se incluyan en la extracción. Se puede especificar más de un patrón. Separe los patrones con una coma o un punto y coma. Las /iopciones : <includePattern> y /e: <excludePattern> se pueden usar en el mismo comando. Cuando se usan patrones de inclusión y exclusión en la línea de comandos, los patrones de inclusión tienen prioridad sobre los patrones de exclusión.
/e:<excludePattern> Especifica un patrón para que los archivos se omitan de la extracción. Se puede especificar más de un patrón. Separe los patrones con una coma o un punto y coma. Las /iopciones : <includePattern> y /e: <excludePattern> se pueden usar en el mismo comando. Cuando se usan patrones de inclusión y exclusión en la línea de comandos, los patrones de inclusión tienen prioridad sobre los patrones de exclusión.
/l:<logfilePath> Especifica la ubicación y el nombre del archivo de registro.
/v:<VerbosityLevel> (Detalle)

Habilita la salida detallada en el archivo de registro UsmtUtils . El valor predeterminado es 0.

VerbosityLevel se puede establecer en uno de los siguientes niveles:
  • 0 : solo se habilitan los errores y advertencias predeterminados.
  • 1 : habilita la salida detallada.
  • 4 : habilita la salida de estado y error.
  • 5 : habilita la salida detallada y de estado.
  • 8 : habilita la salida de error en un depurador.
  • 9 : habilita la salida detallada en un depurador.
  • 12 : habilita la salida de estado y error en un depurador.
  • 13 : habilita la salida detallada, de estado y del depurador.
/decrypt*<AlgID>/key:<KeyString>
or
/descifrar
<AlgID>/:<"Cadena de clave">
or
/descifrar:
<AlgID>/keyfile:<FileName>*
Especifica que la /encrypt opción se usó para crear el almacén de migración con la herramienta ScanState . Para descifrar el almacén de migración, la opción o /keyfile también debe especificarse de la /key siguiente manera:
  • <AlgID> especifica el algoritmo criptográfico que se usó para crear el almacén de migración en la línea de ScanState.exe comandos. Si no se especifica ningún algoritmo, ScanState y UsmtUtils usan el algoritmo 3DES como valor predeterminado.
    Los valores válidos de AlgID> incluyen: , , , o .<3DES_1123DESAES_256AES_192AES_128
  • /key: <KeyString> especifica la clave de cifrado. Si hay un espacio en <KeyString>, el argumento debe estar entre comillas.
  • /keyfile:<FileName> especifica un archivo de texto (.txt) que contiene la clave de cifrado.

Para obtener más información sobre los algoritmos de cifrado admitidos, consulte Cifrado del almacén de migración.
/o Sobrescribe los archivos de salida existentes.

Algunos ejemplos de /extract comandos:

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

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

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

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