Compartilhar via

Sintaxe de UsmtUtils

Este artigo descreve a sintaxe dos utilitários disponíveis na User State Migration Tool (USMT) através da interface de linha de comandos. Estes utilitários:

  • Melhore a capacidade de determinar opções criptográficas para a migração.

  • Ajude a remover arquivos hard-link que, de outra forma, não podem ser eliminados devido a um bloqueio de partilha.

  • Verifique se o ficheiro de catálogo ou qualquer um dos outros ficheiros no arquivo de migração comprimido está danificado.

  • Extraia ficheiros do arquivo de migração comprimido criado quando os ficheiros e as definições são migrados para o computador de destino.

UsmtUtils.exe

A tabela seguinte lista as opções da linha de comandos para UsmtUtils.exe. As secções que se seguem fornecem mais opções de linha de comandos para as /verify opções e /extract .

A sintaxe para UsmtUtils.exe é:

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [opções] | /extract <filepath><destinationPath> [opções]]

Opção da linha de comandos Descrição
/ec Devolve uma lista de algoritmos criptográficos suportados (AlgIDs) no sistema atual. Esta opção pode ser utilizada num computador de destino para determinar que algoritmo utilizar com o /encrypt comando antes de executar a ferramenta ScanState no computador de origem.
/rd<storeDir> Remove o caminho do diretório especificado pelo <argumento storeDir> no computador. Este comando pode ser utilizado para eliminar arquivos de migração de ligações fixas que, de outra forma, não podem ser eliminados numa linha de comandos devido a um bloqueio de partilha. Se o arquivo de migração abranger vários volumes numa determinada unidade, o arquivo de migração é eliminado de todos estes volumes.

Por exemplo:
UsmtUtils.exe /rd D:\MyHardLinkStore
/y Substitui o pedido para aceitar eliminações quando utilizado com a opção /rd . Quando a opção /y é utilizada com a opção /rd , não é apresentado um pedido para aceitar as eliminações antes de o USMT eliminar os diretórios.
/verify Devolve informações sobre se o arquivo de migração comprimido está intacto ou se contém ficheiros danificados ou um catálogo danificado.

Veja Verificar opções de sintaxe e opções para utilizar com /verify.
/extract Recupera ficheiros de um arquivo de migração USMT comprimido.

Veja Opções de extração para sintaxe e opções a utilizar com /extract.

Verificar opções

Utilize a opção /verify para determinar se um arquivo de migração comprimido está intacto ou se contém ficheiros danificados ou um catálogo danificado. Para obter mais informações sobre como utilizar a opção /verify , veja Verificar a condição de um arquivo de migração comprimido.

A sintaxe para /verify é:

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

Opção da linha de comandos Descrição
<reportType> Especifica se pretende reportar todos os ficheiros, apenas ficheiros danificados ou o estado do catálogo.
  • Resumo. Devolve o número de ficheiros intactos e o número de ficheiros danificados no arquivo de migração. Se não for especificado nenhum algoritmo, o relatório de resumo é apresentado como uma predefinição.
  • todos. Devolve uma lista delimitada por tabulações de todos os ficheiros no arquivo de migração comprimido e o estado de cada ficheiro. Cada linha contém o nome do ficheiro seguido de um espaçamento entre separadores e DANIFICADO ou OK , consoante o estado do ficheiro. A última entrada comunica o estado de danos do CATÁLOGO do arquivo. Um ficheiro de catálogo contém metadados para todos os ficheiros num arquivo de migração. A ferramenta LoadState requer um ficheiro de catálogo válido para abrir o arquivo de migração. Devolve "OK" se o ficheiro de catálogo estiver intacto e LoadState conseguir abrir o arquivo de migração e "DANIFICADO" se o arquivo de migração estiver danificado.
  • failureonly. Devolve uma lista delimitada por tabulações apenas dos ficheiros danificados no arquivo de migração comprimido.
  • Catálogo. Devolve apenas o estado do ficheiro de catálogo.
/l:
<logfilePath>		 Especifica a localização e o nome do ficheiro de registo.
/v:<VerbosityLevel> (Verbosidade)

Ativa a saída verbosa no ficheiro de registo UsmtUtils . O valor padrão é 0.

O VerbosityLevel pode ser definido para um dos seguintes níveis:
  • 0 - Apenas os erros e avisos predefinidos estão ativados.
  • 1 - Ativa a saída verbosa.
  • 4 - Ativa o erro e a saída do estado.
  • 5 - Ativa a saída verbosa e de estado.
  • 8 - Ativa a saída do erro para um depurador.
  • 9 - Ativa a saída verbosa para um depurador.
  • 12 - Ativa o erro e a saída de estado para um depurador.
  • 13 - Ativa a saída verbosa, de estado e depurador.
/decrypt<AlgID>/:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>		 Especifica que a opção /encrypt foi utilizada para criar o arquivo de migração com a ferramenta ScanState . Para desencriptar o arquivo de migração, especifique uma /key opção ou /keyfile da seguinte forma:
  • <AlgID> especifica o algoritmo criptográfico que foi utilizado para criar o arquivo de migração na ScanState.exe linha de comandos. Se não for especificado nenhum algoritmo, ScanState e UsmtUtils utilizam o algoritmo 3DES como predefinição.
    Os valores válidos de AlgID> incluem: , , , ou .<3DES3DES_112AES_256AES_192AES_128
  • /key: <KeyString> especifica a chave de encriptação. Se existir um espaço em <KeyString>, o argumento tem de estar entre aspas.
  • /keyfile: <FileName> especifica a localização e o nome de um ficheiro de texto (.txt) que contém a chave de encriptação.

Para obter mais informações sobre os algoritmos de encriptação suportados, veja Encriptação do Arquivo de Migração.

Alguns exemplos 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

Opções de extração

Utilize a opção /extract para recuperar ficheiros de um arquivo de migração USMT comprimido se não restaurar normalmente com LoadState. Para obter mais informações sobre como utilizar a opção /extract , veja Extrair ficheiros de um arquivo de migração USMT comprimido.

A sintaxe para /extract é:

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

Opção da linha de comandos Descrição
<filePath> Caminho para o arquivo de migração USMT.

Por exemplo:
D:\MyMigrationStore\USMT\store.mig
<destinationPath> Caminho para a pasta onde a ferramenta coloca os ficheiros individuais.
/i:<includePattern> Especifica um padrão para os ficheiros incluírem na extração. Pode especificar mais do que um padrão. Separe padrões com uma vírgula ou ponto e vírgula. As /iopções : <includePattern> e /e: <excludePattern> podem ser utilizadas no mesmo comando. Quando ambos incluem e excluem padrões são utilizados na linha de comandos, os padrões de inclusão têm precedência sobre padrões de exclusão.
/e:<excludePattern> Especifica um padrão para os ficheiros omitir da extração. Pode especificar mais do que um padrão. Separe padrões com uma vírgula ou ponto e vírgula. As /iopções : <includePattern> e /e: <excludePattern> podem ser utilizadas no mesmo comando. Quando ambos incluem e excluem padrões são utilizados na linha de comandos, os padrões de inclusão têm precedência sobre padrões de exclusão.
/l:<logfilePath> Especifica a localização e o nome do ficheiro de registo.
/v:<VerbosityLevel> (Verbosidade)

Ativa a saída verbosa no ficheiro de registo UsmtUtils . O valor padrão é 0.

O VerbosityLevel pode ser definido para um dos seguintes níveis:
  • 0 - Apenas os erros e avisos predefinidos estão ativados.
  • 1 - Ativa a saída verbosa.
  • 4 - Ativa o erro e a saída do estado.
  • 5 - Ativa a saída verbosa e de estado.
  • 8 - Ativa a saída do erro para um depurador.
  • 9 - Ativa a saída verbosa para um depurador.
  • 12 - Ativa o erro e a saída de estado para um depurador.
  • 13 - Ativa a saída verbosa, de estado e depurador.
/decrypt*<AlgID>/key:<KeyString>
or
/desencriptar<AlgID>/:<"Cadeia de Chaves">
or
/decrypt:<AlgID>/keyfile:<FileName>*		 Especifica que a opção /encrypt foi utilizada para criar o arquivo de migração com a ferramenta ScanState . Para desencriptar o arquivo de migração, a opção /key ou /keyfile também tem de ser especificada da seguinte forma:
  • <AlgID> especifica o algoritmo criptográfico que foi utilizado para criar o arquivo de migração na ScanState.exe linha de comandos. Se não for especificado nenhum algoritmo, ScanState e UsmtUtils utilizam o algoritmo 3DES como predefinição.
    Os valores válidos de AlgID> incluem: , , , ou .<3DES3DES_112AES_256AES_192AES_128
  • /key: <KeyString> especifica a chave de encriptação. Se existir um espaço em <KeyString>, o argumento tem de estar entre aspas.
  • /keyfile:<FileName> especifica um ficheiro de texto (.txt) que contém a chave de encriptação

Para obter mais informações sobre os algoritmos de encriptação suportados, veja Encriptação do arquivo de migração.
/o Substitui os ficheiros de saída existentes.

Alguns exemplos 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