Sintaxe de UsmtUtils
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:
|
/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.
|
||||||||||||||||||
/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:
|
||||||||||||||||||
/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:
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:
|
||||||||||||||||||
<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:
|
||||||||||||||||||
/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:
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