Condividi tramite

Sintassi di UsmtUtils

Questo articolo descrive la sintassi per le utilità disponibili in User State Migration Tool (USMT) tramite l'interfaccia della riga di comando. Queste utilità:

  • Migliorare la possibilità di determinare le opzioni di crittografia per la migrazione.

  • Consente di rimuovere gli archivi con collegamento rigido che altrimenti non possono essere eliminati a causa di un blocco di condivisione.

  • Verificare se il file di catalogo o uno qualsiasi degli altri file nell'archivio di migrazione compresso è danneggiato.

  • Estrarre i file dall'archivio di migrazione compresso creato quando vengono migrati file e impostazioni nel computer di destinazione.

UsmtUtils.exe

Nella tabella seguente sono elencate le opzioni della riga di comando per UsmtUtils.exe. Le sezioni seguenti forniscono altre opzioni della riga di comando per /verify e le /extract opzioni.

La sintassi per UsmtUtils.exe è:

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

Opzione della riga di comando Descrizione
/Ce Restituisce un elenco di algoritmi di crittografia supportati (AlgID) nel sistema corrente. Questa opzione può essere usata in un computer di destinazione per determinare quale algoritmo usare con il /encrypt comando prima di eseguire lo strumento ScanState nel computer di origine.
/rd<storeDir> Rimuove il percorso della directory specificato dall'argomento <storeDir> nel computer. Questo comando può essere usato per eliminare gli archivi di migrazione con collegamento rigido che altrimenti non possono essere eliminati al prompt dei comandi a causa di un blocco di condivisione. Se l'archivio di migrazione si estende su più volumi in una determinata unità, l'archivio migrazione viene eliminato da tutti questi volumi.

Ad esempio:
UsmtUtils.exe /rd D:\MyHardLinkStore
/Y Esegue l'override del prompt per accettare le eliminazioni quando viene usato con l'opzione /rd . Quando l'opzione /y viene usata con l'opzione /rd , non viene visualizzato un prompt per accettare le eliminazioni prima che USMT elimini le directory.
/Verificare Restituisce informazioni sul fatto che l'archivio di migrazione compresso sia intatto o che contenga file danneggiati o un catalogo danneggiato.

Vedere Verificare le opzioni per la sintassi e le opzioni da usare con /verify.
/Estrarre Recupera i file da un archivio di migrazione USMT compresso.

Vedere Estrarre le opzioni per la sintassi e le opzioni da usare con /extract.

Verificare le opzioni

Usare l'opzione /verify per determinare se un archivio di migrazione compresso è intatto o se contiene file danneggiati o un catalogo danneggiato. Per altre informazioni su come usare l'opzione /verify , vedere Verificare la condizione di un archivio di migrazione compresso.

La sintassi per /verify è:

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

Opzione della riga di comando Descrizione
<reportType> Specifica se segnalare tutti i file, solo i file danneggiati o lo stato del catalogo.
  • Riepilogo. Restituisce sia il numero di file intatti che il numero di file danneggiati nell'archivio di migrazione. Se non viene specificato alcun algoritmo, il report di riepilogo viene visualizzato come predefinito.
  • tutto. Restituisce un elenco delimitato da tabulazioni di tutti i file nell'archivio di migrazione compresso e lo stato di ogni file. Ogni riga contiene il nome del file seguito da una spaziatura tra schede e DANNEGGIATO o OK a seconda dello stato del file. L'ultima voce segnala lo stato di danneggiamento del CATALOGO dell'archivio. Un file di catalogo contiene metadati per tutti i file in un archivio di migrazione. Lo strumento LoadState richiede un file di catalogo valido per aprire l'archivio migrazione. Restituisce "OK" se il file di catalogo è intatto e LoadState può aprire l'archivio migrazione e "CORRUPTED" se l'archivio di migrazione è danneggiato.
  • failureonly. Restituisce un elenco delimitato da tabulazioni dei soli file danneggiati nell'archivio di migrazione compresso.
  • Catalogo. Restituisce solo lo stato del file di catalogo.
/L:
<logfilePath>		 Specifica il percorso e il nome del file di log.
/v:<VerbosityLevel> (Dettaglio)

Abilita l'output dettagliato nel file di log UsmtUtils . Il valore predefinito è 0.

VerbosityLevel può essere impostato su uno dei livelli seguenti:
  • 0 - Sono abilitati solo gli errori e gli avvisi predefiniti.
  • 1 - Abilita l'output dettagliato.
  • 4 - Abilita l'output di errore e stato.
  • 5 - Abilita l'output dettagliato e di stato.
  • 8 - Abilita l'output degli errori a un debugger.
  • 9 - Abilita l'output dettagliato a un debugger.
  • 12 - Abilita l'output di errore e stato a un debugger.
  • 13 - Abilita l'output dettagliato, dello stato e del debugger.
/decrypt<AlgID>/:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>		 Specifica che l'opzione /encrypt è stata usata per creare l'archivio migrazione con lo strumento ScanState . Per decrittografare l'archivio migrazione, specificare un'opzione /key o /keyfile come indicato di seguito:
  • <AlgID> specifica l'algoritmo di crittografia usato per creare l'archivio migrazione nella ScanState.exe riga di comando. Se non viene specificato alcun algoritmo, ScanState e UsmtUtils usano l'algoritmo 3DES come impostazione predefinita.
    <I valori validi di AlgID> includono: AES_128, AES_192, AES_256, 3DESo 3DES_112.
  • /key:<KeyString> specifica la chiave di crittografia. Se è presente uno spazio in <KeyString>, l'argomento deve essere racchiuso tra virgolette.
  • /keyfile: <FileName> specifica il percorso e il nome di un file di testo (.txt) che contiene la chiave di crittografia.

Per altre informazioni sugli algoritmi di crittografia supportati, vedere Migration Store Encryption.

Alcuni esempi di /verify comandi:

  • 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

Opzioni di estrazione

Usare l'opzione /extract per ripristinare i file da un archivio di migrazione USMT compresso se non viene ripristinato normalmente con LoadState. Per altre informazioni su come usare l'opzione /extract , vedere Estrarre file da un archivio di migrazione USMT compresso.

La sintassi per /extract è:

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

Opzione della riga di comando Descrizione
<Filepath> Percorso dell'archivio migrazione USMT.

Ad esempio:
D:\MyMigrationStore\USMT\store.mig
<destinationPath> Percorso della cartella in cui lo strumento inserisce i singoli file.
/i:<includePattern> Specifica un modello per i file da includere nell'estrazione. È possibile specificare più di un modello. Separare i modelli con una virgola o un punto e virgola. Le /iopzioni : <includePattern> e /e: <excludePattern> possono essere usate nello stesso comando. Quando nella riga di comando vengono usati sia criteri di inclusione che di esclusione, i modelli di inclusione hanno la precedenza sui modelli di esclusione.
/e:<excludePattern> Specifica un modello per i file da omettere dall'estrazione. È possibile specificare più di un modello. Separare i modelli con una virgola o un punto e virgola. Le /iopzioni : <includePattern> e /e: <excludePattern> possono essere usate nello stesso comando. Quando nella riga di comando vengono usati sia criteri di inclusione che di esclusione, i modelli di inclusione hanno la precedenza sui modelli di esclusione.
/l:<logfilePath> Specifica il percorso e il nome del file di log.
/v:<VerbosityLevel> (Dettaglio)

Abilita l'output dettagliato nel file di log UsmtUtils . Il valore predefinito è 0.

VerbosityLevel può essere impostato su uno dei livelli seguenti:
  • 0 - Sono abilitati solo gli errori e gli avvisi predefiniti.
  • 1 - Abilita l'output dettagliato.
  • 4 - Abilita l'output di errore e stato.
  • 5 - Abilita l'output dettagliato e di stato.
  • 8 - Abilita l'output degli errori a un debugger.
  • 9 - Abilita l'output dettagliato a un debugger.
  • 12 - Abilita l'output di errore e stato a un debugger.
  • 13 - Abilita l'output dettagliato, dello stato e del debugger.
/decrypt*<AlgID>/key:<KeyString>
or
/Decrittografare<AlgID>/:<"Key String">
or
/Decrittografare:<AlgID>/keyfile:<FileName>*		 Specifica che l'opzione /encrypt è stata usata per creare l'archivio migrazione con lo strumento ScanState . Per decrittografare l'archivio migrazione, è necessario specificare anche l'opzione /key o /keyfile come indicato di seguito:
  • <AlgID> specifica l'algoritmo di crittografia usato per creare l'archivio migrazione nella ScanState.exe riga di comando. Se non viene specificato alcun algoritmo, ScanState e UsmtUtils usano l'algoritmo 3DES come impostazione predefinita.
    <I valori validi di AlgID> includono: AES_128, AES_192, AES_256, 3DESo 3DES_112.
  • /key: <KeyString> specifica la chiave di crittografia. Se è presente uno spazio in <KeyString>, l'argomento deve essere racchiuso tra virgolette.
  • /keyfile:<FileName> specifica un file di testo (.txt) che contiene la chiave di crittografia

Per altre informazioni sugli algoritmi di crittografia supportati, vedere Crittografia dell'archivio di migrazione.
/o Sovrascrive i file di output esistenti.

Alcuni esempi di /extract comandi:

  • 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