Share via

Sintaxe de UsmtUtils

  • Artigo

Este tópico descreve a sintaxe dos utilitários disponíveis na USMT (Ferramenta de Migração de Estado do Usuário) 5.0 através da interface de linha de comando. Esses utilitários:

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

  • Auxiliam na remoção de repositórios de link físico que, de outra forma, não podem ser excluídos devido a um bloqueio de compartilhamento.

  • Verificam se o arquivo de catálogo ou qualquer um dos demais arquivos no repositório de migração compactado se tornaram corrompidos.

  • Extrai arquivos do repositório de migração compactado quando você faz a migração de arquivos e configurações para o computador de destino.

Neste tópico

Usmtutils.exe

Opções de verificação

Opções de extração

Usmtutils.exe

A tabela a seguir lista opções de linha de comando para USMTutils.exe. As próximas seções fornecem opções de linha de comando adicionais para as opções /verify e /extract.

A sintaxe de UsmtUtils.exe é:

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

Opção da linha de comando Descrição

/ec

Retorna uma lista de algoritmos criptográficos (AlgIDs) com suporte no sistema atual. Essa lista pode ser usada em um computador de destino para determinar qual algoritmo deve ser usado com o comando /encrypt antes que a ferramenta ScanState seja executada no computador de origem.

/rd <storeDir>

Remove o caminho de diretório especificado pelo argumento <storeDir> no computador. Esse comando pode ser usado para excluir repositórios de migração de link físico que, de outra forma, não podem ser excluídos em um prompt de comando devido a um bloqueio de compartilhamento. Se o repositório de migração se estender entre vários volumes em uma determinada unidade, ele será excluído de todos esses volumes.

Por exemplo:

usmtutils /rd D:\MyHardLinkStore

/y

Substitui o prompt para aceitar exclusões quando usado com a opção /rd. Quando você usar a opção /y junto com a opção /rd, não precisará aceitar as exclusões antes de a USMT excluir os diretórios.

/verify

Retorna informações que especificam se o repositório de migração compactado está intacto ou se ele contém arquivos corrompidos ou um catálogo corrompido.

Consulte Opções de verificação para conhecer a sintaxe e as opções que podem ser usadas com a /verify.

/extract

Recupera arquivos de um repositório de migração da USMT compactado.

Consulte Opções de extração para conhecer a sintaxe e as opções que podem ser usadas com a /extract.

Opções de verificação

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

A sintaxe de /verify é:

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

Opção da linha de comando Descrição

<reportType>

Especifica se um relatório deve ser gerado sobre todos os arquivos, apenas sobre os arquivos corrompidos ou sobre o status do catálogo.

  • Summary. Retorna o número de arquivos 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.

  • all. Retorna uma lista delimitada por tabulação de todos os arquivos no repositório de migração compactado, bem como o status de cada um desses arquivos. Cada linha contém o nome do arquivo seguido de um espaçamento de tabulação e de “CORRUPTED” ou “OK”, dependendo do status do arquivo. A última entrada expressa o status de corrupção do catálogo "CATALOG" do repositório. 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" quando o arquivo de catálogo está intacto e LoadState pode abrir o repositório de migração. Retorna "CORRUPTED" quando o repositório de migração está corrompido.

  • failureonly. Retorna uma lista delimitada por tabulação apenas dos arquivos que estão corrompidos no repositório de migração compactado.

  • Catalog. Retorna apenas o status do arquivo de catálogo.

/l: <logfilePath>

Especifica o local e o nome do arquivo de log.

/v: <VerbosityLevel>

(Verbosity)

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

Você pode definir o NívelDeDetalhe como um dos seguintes níveis:

 

Nível Explicação

0

Apenas os erros e avisos padrão são permitidos.

1

Permite a saída detalhada.

4

Permite a saída de erros e status.

5

Permite a saída detalhada e de status.

8

Permite a saída de erros em um depurador.

9

Permite a saída detalhada em um depurador.

12

Permite a saída de erros e status em um depurador.

13

Permite a saída detalhada, de status e no depurador.

/decrypt: <AlgID> /key:<KeyString>

ou

/decrypt: <AlgID> /key:<“Key String”>

ou

/decrypt: <AlgID> /keyfile:<FileName>

Especifica que a opção /encrypt foi usada para criar o repositório de migração com a ferramenta ScanState. Para descriptografar o repositório de migração, especifique uma opção /key ou /keyfile da seguinte maneira:

  • <AlgID> especifica o algoritmo criptográfico que foi usado para criar o repositório de migração na linha de comando de ScanState. Se nenhum algoritmo for especificado, ScanState e UsmtUtils usarão o algoritmo 3DES como padrão.

    Os valores válidos de <AlgID> incluem: AES_128, AES_192, AES_256, 3DES ou 3DES_112.

  • /key: <KeyString> especifica a chave de criptografia. Se houver um espaço em <KeyString>, será necessário colocar o argumento entre aspas.

  • /keyfile: <FileName> especifica a localização 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, veja Criptografia do repositório de migração.

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

Opções de extração

Use a opção /extract para recuperar arquivos de um repositório de migração da USMT compactado caso eles não sejam restaurados normalmente com loadstate. Para obter mais informações sobre como usar a opção /extract, veja Extrair arquivos de um repositório de migração compactado da USMT.

A sintaxe de /extract é:

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

Opção da linha de comando Descrição

<filePath>

Caminho para o repositório de migração da USMT.

Por exemplo:

D:\MyMigrationStore\USMT\store.mig

<destinationPath>

Caminho para a pasta onde a ferramenta coloca arquivos individuais.

/i:<includePattern>

Especifica um padrão para arquivos a serem incluídos na extração. É possível especificar mais de um padrão. Separe padrões com uma vírgula ou um ponto-e-vírgula. É possível usar as opções /i: <includePattern> e /e: <excludePattern> no mesmo comando. Quando padrões de inclusão e exclusão são usados ao mesmo tempo 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 arquivos a serem omitidos da extração. É possível especificar mais de um padrão. Separe padrões com uma vírgula ou um ponto-e-vírgula. É possível usar as opções /i: <includePattern> e /e: <excludePattern> no mesmo comando. Quando padrões de inclusão e exclusão são usados ao mesmo tempo 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>

(Verbosity)

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

Você pode definir o NívelDeDetalhe como um dos seguintes níveis:

 

Nível Explicação

0

Apenas os erros e avisos padrão são permitidos.

1

Permite a saída detalhada.

4

Permite a saída de erros e status.

5

Permite a saída detalhada e de status.

8

Permite a saída de erros em um depurador.

9

Permite a saída detalhada em um depurador.

12

Permite a saída de erros e status em um depurador.

13

Permite a saída detalhada, de status e no depurador.

/decrypt: <AlgID> /key:<KeyString>

ou

/decrypt: <AlgID> /key:<“Key String”>

ou

/decrypt: <AlgID> /keyfile:<FileName>

Especifica que a opção /encrypt foi usada para criar o repositório de migração com a ferramenta ScanState. Para descriptografar o repositório de migração, também é necessário especificar uma opção /key ou /keyfile da seguinte maneira:

  • <AlgID> especifica o algoritmo criptográfico que foi usado para criar o repositório de migração na linha de comando de ScanState. Se nenhum algoritmo for especificado, ScanState e UsmtUtils usarão o algoritmo 3DES como padrão.

    Os valores válidos de <AlgID> incluem: AES_128, AES_192, AES_256, 3DES ou 3DES_112.

  • /key: <KeyString> especifica a chave de criptografia. Se houver um espaço em <KeyString>, será necessário colocar o argumento 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, veja Criptografia do repositório de migração.

/o

Substitui arquivos de saída existentes.

Alguns exemplos 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 também

Outros Recursos

Sintaxe de linha de comando da USMT (ferramenta de transferência do Windows)
Códigos de retorno