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

Artigos relacionados

• Sintaxe da linha de comando da USMT (Ferramenta de Migração de Estado do Usuário).
• Códigos de retorno.