Sintaxe de UsmtUtils

Este artigo descreve a sintaxe dos utilitários disponíveis na USMT (User State Migration Tool) por meio da interface de linha de comando. Esses utilitários:

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

  • Ajuda para remover repositórios de links rígidos que, de outra forma, não podem ser excluídos devido a um bloqueio de compartilhamento.

  • Verifique se o arquivo de catálogo ou qualquer um dos outros arquivos no repositório de migração compactado estão corrompidos.

  • Extraia arquivos do repositório de migração compactado criado quando arquivos e configurações são migrados para o computador de destino.

UsmtUtils.exe

A tabela a seguir lista as opções de linha de comando para UsmtUtils.exe. As seções a seguir fornecem mais opções de linha de comando para as /verify e as /extract opções.

A sintaxe para UsmtUtils.exe é:

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

Opção de linha de comando Descrição
/ec Retorna uma lista de algoritmos criptográficos suportados (AlgIDs) no sistema atual. Essa opção pode ser usada em um computador de destino para determinar qual algoritmo usar 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. Esse comando pode ser usado para excluir repositórios de migração de link rígido que, de outra forma, não poderiam ser excluídos em um prompt de comando devido a um bloqueio de compartilhamento. Se o repositório de migração abrange vários volumes em uma determinada unidade, o repositório de migração é excluído de todos esses volumes.

Por exemplo:
UsmtUtils.exe /rd D:\MyHardLinkStore
/y Substitui o prompt para aceitar exclusões quando usado com a /rd opção. Quando a /y opção é usada com a /rd opção, não é exibido um prompt para aceitar as exclusões antes que a USMT exclua os diretórios.
/verificar Retorna informações sobre se o repositório de migração compactado está intacto ou se contém arquivos corrompidos ou um catálogo corrompido.

Consulte Verificar opções de sintaxe e opções para usar com /verify.
/extrair Recupera arquivos de um repositório de migração compactado da USMT.

Consulte Opções de extração para sintaxe e opções para usar com /extract.

Opções de verificação

Use a opção para determinar se um repositório de migração compactado está intacto /verify ou se contém arquivos corrompidos ou um catálogo corrompido. Para obter mais informações sobre como usar a /verify opção, consulte Verificar a condição de um repositório de migração compactado.

A sintaxe para /verify é:

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

Opção de linha de comando Descrição
<reportType> Especifica se você deseja gerar relatórios sobre todos os arquivos, apenas arquivos corrompidos ou o status do catálogo.
  • Resumo. Retorna o número de arquivos que estão intactos e o número de arquivos que estão corrompidos no repositório de migração. Se nenhum algoritmo for especificado, o relatório de resumo será exibido como padrão.
  • todos. Retorna uma lista delimitada por tabulação de todos os arquivos no repositório de migração compactado e o status de cada arquivo. Cada linha contém o nome do arquivo seguido por um espaçamento de tabulação e CORROMPIDO ou OK, dependendo do status do arquivo. A última entrada informa o status de corrupção do CATÁLOGO da loja. Um arquivo de catálogo contém metadados para todos os arquivos em um repositório de migração. A ferramenta LoadState requer um arquivo de catálogo válido para abrir o repositório de migração. Retorna "OK" se o arquivo de catálogo estiver intacto e LoadState puder abrir o repositório de migração e "CORROMPIDO" se o repositório de migração estiver corrompido.
  • failureonly. Retorna uma lista delimitada por tabulação apenas dos arquivos corrompidos no repositório de migração compactado.
  • Catálogo. Retorna apenas o status do arquivo de catálogo.
/l:
<logfilePath>		 Especifica o local e o nome do arquivo de log.
/v:<VerbosityLevel> (Verbosidade)

Habilita a saída detalhada no arquivo de log UsmtUtils . O valor padrão é 0.

O VerbosityLevel pode ser definido como um dos seguintes níveis:
  • 0 - Somente os erros e avisos padrão estão habilitados.
  • 1 – Habilita a saída detalhada.
  • 4 – Habilita a saída de erro e status.
  • 5 – Habilita a saída detalhada e de status.
  • 8 – Habilita a saída de erro para um depurador.
  • 9 – Habilita a saída detalhada para um depurador.
  • 12 – Habilita a saída de erro e status para um depurador.
  • 13 – Habilita a saída detalhada, de status e de depurador.
/decrypt<AlgID:>/<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>		 Especifica que a /encrypt opção foi usada para criar o repositório de migração com a ferramenta ScanState . Para descriptografar o repositório de migração, especifique uma /key opção ou /keyfile da seguinte maneira:
  • <AlgID> especifica o algoritmo criptográfico usado para criar o ScanState.exe repositório de migração na linha de comando. Se nenhum algoritmo for especificado, ScanState e UsmtUtils usarão o algoritmo 3DES como padrão.
    <Os valores válidos do AlgID> incluem: AES_128, AES_192, AES_256, 3DESou 3DES_112.
  • /key: <KeyString> especifica a chave de criptografia. Se houver um espaço em <KeyString>, o argumento deverá ser colocado entre aspas.
  • /keyfile: <FileName> especifica o local e o nome de um arquivo de texto (.txt) que contém a chave de criptografia.

Para obter mais informações sobre algoritmos de criptografia com suporte, consulte Criptografia do repositório 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

Use a /extract opção para recuperar arquivos de um repositório de migração compactado da USMT se ele não restaurar normalmente com LoadState. Para obter mais informações sobre como usar a /extract opção, consulte Extrair arquivos de um repositório de migração compactado da USMT.

A sintaxe para /extract é:

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

Opção de linha de comando Descrição
<filePath> Caminho para o repositório de migração da USMT.

Por exemplo:
D:\MyMigrationStore\USMT\store.mig
<caminho de destino> Caminho para a pasta em que a ferramenta coloca os arquivos individuais.
/i:<includePattern> Especifica um padrão para os arquivos a serem incluídos na extração. Mais de um padrão pode ser especificado. Separe os padrões com uma vírgula ou um ponto e vírgula. As /iopções : <includePattern> e /e: <excludePattern> podem ser usadas no mesmo comando. Quando os padrões de inclusão e exclusão são usados na linha de comando, os padrões de inclusão têm precedência sobre os padrões de exclusão.
/e:<excludePattern> Especifica um padrão para os arquivos a serem omitidos da extração. Mais de um padrão pode ser especificado. Separe os padrões com uma vírgula ou um ponto e vírgula. As /iopções : <includePattern> e /e: <excludePattern> podem ser usadas no mesmo comando. Quando os padrões de inclusão e exclusão são usados na linha de comando, os padrões de inclusão têm precedência sobre os padrões de exclusão.
/l:<logfilePath> Especifica o local e o nome do arquivo de log.
/v:<VerbosityLevel> (Verbosidade)

Habilita a saída detalhada no arquivo de log UsmtUtils . O valor padrão é 0.

O VerbosityLevel pode ser definido como um dos seguintes níveis:
  • 0 - Somente os erros e avisos padrão estão habilitados.
  • 1 – Habilita a saída detalhada.
  • 4 – Habilita a saída de erro e status.
  • 5 – Habilita a saída detalhada e de status.
  • 8 – Habilita a saída de erro para um depurador.
  • 9 – Habilita a saída detalhada para um depurador.
  • 12 – Habilita a saída de erro e status para um depurador.
  • 13 – Habilita a saída detalhada, de status e de depurador.
/decrypt*<AlgID>/key:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>*		 Especifica que a /encrypt opção foi usada para criar o repositório de migração com a ferramenta ScanState . Para descriptografar o repositório de migração, a /key opção ou /keyfile também deve ser especificada da seguinte maneira:
  • <AlgID> especifica o algoritmo criptográfico usado para criar o ScanState.exe repositório de migração na linha de comando. Se nenhum algoritmo for especificado, ScanState e UsmtUtils usarão o algoritmo 3DES como padrão.
    <Os valores válidos do AlgID> incluem: AES_128, AES_192, AES_256, 3DESou 3DES_112.
  • /key: <KeyString> especifica a chave de criptografia. Se houver um espaço em <KeyString>, o argumento deverá ser colocado entre aspas.
  • /keyfile:<FileName> especifica um arquivo de texto (.txt) que contém a chave de criptografia

Para obter mais informações sobre algoritmos de criptografia com suporte, consulte Criptografia do repositório de migração.
/o Substitui os arquivos 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

  • Last updated on