Condividi tramite

Sintassi di UsmtUtils

  • Articolo

Questo argomento descrive la sintassi per le utilità disponibili in Utilità di migrazione stato utente (USMT) 5.0 tramite l'interfaccia della riga di comando. Queste utilità consentono di:

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

  • Rimuovere archivi con collegamento reale che non potrebbero essere altrimenti eliminati a causa di un blocco di condivisione.

  • Verificare se il file di catalogo o altri file sono danneggiati nell'archivio delle migrazioni compresso.

  • Estrarre i file dall'archivio delle migrazioni compresso quando esegui la migrazione di file e impostazioni nel computer di destinazione.

In questo argomento

Usmtutils.exe

Opzioni di verifica

Opzioni di estrazione

Usmtutils.exe

La tabella seguente elenca le opzioni della riga di comando per USMTutils.exe. Le sezioni successive descrivono ulteriori opzioni della riga di comando per le opzioni /verify e /extract.

La sintassi per UsmtUtils.exe è:

usmtutils [/ec | /rd <dirArchivio> | /verify <percorsoFile> [opzioni] | /extract <percorsoFile><percorsoDestinazione> [opzioni]]

Opzioni della riga di comando Descrizione

/ec

Restituisce un elenco degli algoritmi di crittografia (IDAlg) supportati nel sistema corrente. Puoi usare questa opzione in un computer di destinazione per determinare quale algoritmo usare con il comando /encrypt prima di usare lo strumento ScanState nel computer di origine.

/rd <dirArchivio>

Rimuove il percorso di directory specificato dall'argomento <dirArchivio> nel computer. Puoi usare questo comando per eliminare gli archivi delle migrazioni con collegamento reale che altrimenti non possono essere eliminati da un prompt dei comandi a causa di un blocco di condivisione. Se l'archivio delle migrazioni si estende su più volumi in una determinata unità, verrà eliminato da tutti i volumi.

Ad esempio:

usmtutils /rd D:\MyHardLinkStore

/y

Ignora la richiesta di conferma delle eliminazioni quando si usa questa opzione con l'opzione /rd. Quando usi l'opzione /y con l'opzione /rd, non ti verrà richiesto di confermare le eliminazioni prima che USMT proceda con l'eliminazione delle directory.

/verify

Restituisce informazioni che indicano se l'archivio delle migrazioni compresso è intatto oppure contiene file o un catalogo danneggiati.

Vedi Opzioni di verifica per informazioni sulla sintassi e le opzioni da usare con /verify.

/extract

Recupera i file da un archivio delle migrazioni USMT compresso.

Vedi Opzioni di estrazione per informazioni sulla sintassi e le opzioni da usare con /extract.

Opzioni di verifica

Usa l'opzione /verify quando vuoi stabilire se un archivio delle migrazioni compresso è intatto oppure contiene file o un catalogo danneggiati. Per altre informazioni su come usare l'opzione /verify, vedi Verificare la condizione di un archivio delle migrazioni compresso.

La sintassi per /verify è:

usmtutils /verify[:<tipoRapporto>] <percorsoFile> [/l:<fileLog>] [/v:<LivelloDettaglio>] [/decrypt [:<IDAlg>] {/key:<stringaChiave> | /keyfile:<nomeFile>}]

Opzioni della riga di comando Descrizione

<tipoRapporto>

Specifica se includere nel rapporto informazioni su tutti i file, solo sui file danneggiati o sullo stato del catalogo.

  • Summary. Restituisce sia il numero di file intatti che il numero di file danneggiati nell'archivio delle migrazioni. Se non si specifica alcun algoritmo, viene visualizzato per impostazione predefinita il rapporto di riepilogo.

  • all. Restituisce un elenco con valori delimitati da tabulazioni di tutti i file nell'archivio delle migrazioni compresso e lo stato di ogni file. Ogni riga contiene il nome del file seguito da TAB e dalla dicitura "CORRUPTED" o "OK" a seconda dello stato del file. L'ultima voce indica lo stato di danneggiamento del catalogo dell'archivio. Il file di catalogo contiene i metadati per tutti i file in un archivio delle migrazioni. Per aprire l'archivio delle migrazioni con lo strumento LoadState è necessario un file di catalogo valido. Restituisce "OK" se il file di catalogo è intatto e LoadState può aprire l'archivio delle migrazioni, "CORRUPTED" se l'archivio delle migrazioni è danneggiato.

  • failureonly. Restituisce un elenco con valori delimitati da tabulazioni dei file danneggiati nell'archivio delle migrazioni compresso.

  • Catalog. Restituisce solo lo stato del file di catalogo.

/l: <fileLog>

Specifica il percorso e il nome del file di log.

/v: <LivelloDettaglio>

(Verbosity)

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

Puoi impostare LivelloDettaglio su uno dei livelli seguenti:

 

Livello Spiegazione

0

Sono abilitati solo gli errori e gli avvisi predefiniti.

1

Abilita l'output dettagliato.

4

Abilita l'output per gli errori e lo stato.

5

Abilita l'output dettagliato e per lo stato.

8

Abilita l'output per gli errori a un debugger.

9

Abilita l'output dettagliato a un debugger.

12

Abilita l'output per gli errori e lo stato a un debugger.

13

Abilita l'output dettagliato, per lo stato e a un debugger.

/decrypt: <IDAlg> /key:<StringaChiave>

oppure

/decrypt: <IDAlg> /key:<"StringaChiave">

oppure

/decrypt: <IDAlg> /keyfile:<NomeFile>

Specifica che l'opzione /encrypt è stata usata per creare l'archivio delle migrazioni con lo strumento ScanState. Per decrittografare l'archivio delle migrazioni, specificare un'opzione /key o /keyfile come segue:

  • <IDAlg> specifica l'algoritmo di crittografia usato per creare l'archivio delle migrazioni nella riga di comando di ScanState. Se non è specificato alcun algoritmo, ScanState e UsmtUtils usano l'algoritmo 3DES per impostazione predefinita.

    I valori validi di <IDAlg> includono: AES_128, AES_192, AES_256, 3DES o 3DES_112.

  • /key: <StringaChiave> specifica la chiave di crittografia. Se è presente uno spazio in <StringaChiave>, devi racchiudere l'argomento tra virgolette.

  • /keyfile: <NomeFile> specifica il percorso e il nome del file di testo (con estensione txt) che contiene la chiave di crittografia.

Per altre informazioni sugli algoritmi di crittografia supportati, vedi Crittografia dell'archivio delle migrazioni

Alcuni esempi del comando /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

Opzioni di estrazione

Usa l'opzione /extract per ripristinare file da un archivio delle migrazioni USMT compresso, se non è possibile ripristinarlo normalmente con LoadState. Per altre informazioni su come usare l'opzione /extract, vedi Estrarre i file da un archivio delle migrazioni USMT compresso.

La sintassi per /extract è:

/extract <percorsoFile><percorsoDestinazione> [/i:<patternInclusione>] [/e: <patternEsclusione>] [/l: <filelog>] [/v: <LivelloDettaglio>] [/decrypt[:<IDAlg>] {key: <stringachiave> | /keyfile: <nomefile>}] [/o]

Opzioni della riga di comando Descrizione

<percorsoFile>

Percorso dell'archivio delle migrazioni USMT.

Ad esempio:

D:\MyMigrationStore\USMT\store.mig

<percorsoDestinazione>

Percorso della cartella in cui lo strumento posiziona i singoli file.

/i:< patternInclusione>

Specifica un pattern per i file da includere nell'estrazione. Puoi specificare più di un pattern. Separa i pattern con una virgola o un punto e virgola. Puoi usare le opzioni /i: <patternInclusione> ed /e: <patternEsclusione> nello stesso comando. Quando si usano sia pattern di inclusione che pattern di esclusione nella riga di comando, i pattern di inclusione hanno la precedenza su quelli di esclusione.

/e:<patternEsclusione>

Specifica un pattern per i file da escludere dall'estrazione. Puoi specificare più di un pattern. Separa i pattern con una virgola o un punto e virgola. Puoi usare le opzioni /i: <patternInclusione> ed /e: <patternEsclusione> nello stesso comando. Quando si usano sia pattern di inclusione che pattern di esclusione nella riga di comando, i pattern di inclusione hanno la precedenza su quelli di esclusione.

/l:<filelog>

Specifica il percorso e il nome del file di log.

/v: <LivelloDettaglio>

(Verbosity)

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

Puoi impostare LivelloDettaglio su uno dei livelli seguenti:

 

Livello Spiegazione

0

Sono abilitati solo gli errori e gli avvisi predefiniti.

1

Abilita l'output dettagliato.

4

Abilita l'output per gli errori e lo stato.

5

Abilita l'output dettagliato e per lo stato.

8

Abilita l'output per gli errori a un debugger.

9

Abilita l'output dettagliato a un debugger.

12

Abilita l'output per gli errori e lo stato a un debugger.

13

Abilita l'output dettagliato, per lo stato e a un debugger.

/decrypt: <IDAlg> /key:<StringaChiave>

oppure

/decrypt: <IDAlg> /key:<"StringaChiave">

oppure

/decrypt: <IDAlg> /keyfile:<NomeFile>

Specifica che l'opzione /encrypt è stata usata per creare l'archivio delle migrazioni con lo strumento ScanState. Per decrittografare l'archivio delle migrazioni, devi anche specificare un'opzione /key o /keyfile come segue:

  • <IDAlg> specifica l'algoritmo di crittografia usato per creare l'archivio delle migrazioni nella riga di comando di ScanState. Se non è specificato alcun algoritmo, ScanState e UsmtUtils usano l'algoritmo 3DES per impostazione predefinita.

    I valori validi di <IDAlg> includono: AES_128, AES_192, AES_256, 3DES o 3DES_112.

  • /key: <StringaChiave> specifica la chiave di crittografia. Se è presente uno spazio in <StringaChiave>, devi racchiudere l'argomento tra virgolette.

  • /keyfile: <NomeFile> specifica un file di testo (con estensione txt) che contiene la chiave di crittografia.

Per altre informazioni sugli algoritmi di crittografia supportati, vedi Crittografia dell'archivio delle migrazioni

/o

Sovrascrive i file di output esistenti.

Alcuni esempi dei comandi /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

Vedere anche

Altre risorse

Sintassi della riga di comando per Utilità di migrazione stato utente (USMT)
Codici restituiti