Sintassi di ScanState
Il comando ScanState viene usato insieme a Utilità di migrazione stato utente (USMT) 5.0 per analizzare il computer di origine, raccogliere i file e le impostazioni e creare un archivio.
In questo argomento
Informazioni preliminari
Sintassi
Opzioni di archiviazione
Opzioni per le regole di migrazione
Opzioni di monitoraggio
Opzioni utente
Opzioni per i file crittografati
Opzioni della riga di comando incompatibili
Informazioni preliminari
Prima di eseguire il comando ScanState, verifica le opzioni seguenti:
Per garantire la migrazione di tutte le impostazioni del sistema operativo, nella maggior parte dei casi devi eseguire i comandi ScanState in modalità amministratore da un account con credenziali amministrative.
Se l'archivio delle migrazioni viene crittografato, verrà richiesto di immettere una chiave di crittografia o il percorso di un file che contiene la chiave di crittografia. Prendi nota della chiave o del percorso del file di chiave perché le informazioni non sono conservate nell'archivio delle migrazioni. Questa informazione sarà necessaria quando esegui il comando LoadState per decrittografare l'archivio delle migrazioni o nel caso sia necessario eseguire l'utilità di ripristino. Una chiave o un file di chiave non corretto o mancante comporterà un messaggio di errore.
Per informazioni sui requisiti software per l'esecuzione del comando ScanState, vedi Requisiti per Utilità di migrazione stato utente (USMT).
Importante
Windows XP e Windows Vista® sono supportati solo come sistemi operativi sul computer di origine.
A meno che non sia indicato diversamente, ogni opzione può essere usata una sola volta durante l'esecuzione di uno strumento nella riga di comando.
Per raccogliere gli account di dominio non è necessario che il computer di origine abbia accesso al controller di dominio. Questa funzionalità è disponibile senza alcuna configurazione aggiuntiva.
Nella tabella Opzioni della riga di comando incompatibili sono elencate le opzioni della riga di comando che è possibile usare insieme e quelle che sono incompatibili.
Il percorso della directory in cui salvi l'archivio delle migrazioni verrà escluso dall'analisi. Ad esempio, se salvi l'archivio delle migrazioni nella radice dell'unità D, questa unità e tutte le rispettive sottodirectory verranno escluse dall'analisi.
Sintassi
In questa sezione vengono descritti la sintassi e l'uso delle opzioni della riga di comando ScanState. Le opzioni possono essere specificate in qualsiasi ordine. Se l'opzione contiene un parametro, puoi usare i due punti o uno spazio come separatore.
La sintassi del comando ScanState è:
scanstate [PercorsoArchivio] [/i:[Percorso\]NomeFile] [/o] [/v:LivelloDettaglio] [/nocompress] [/localonly] [/encrypt /key:StringaChiave|/keyfile:[Percorso\]NomeFile] [/l:[Percorso\]NomeFile] [/progress:[Percorso\]NomeFile] [/r:NumeroTentativi] [/w:SecondiPrimaDiRiprovare] [/c] [/p] [/all] [/ui:[NomeDominio|NomeComputer\]NomeUtente] [/ue:[NomeDominio|NomeComputer\]NomeUtente] [/uel:NumeroDiGiorni|AAAA/MM/GG|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Percorso\]NomeFile[/config:[Percorso\]NomeFile] [/?|help]
Ad esempio:
Per creare un file Config.xml nella directory corrente, usa:
scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13
Per creare un archivio crittografato con il file Config.xml e i file XML predefiniti della migrazione, usa:
scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"
Opzioni di archiviazione
Opzioni della riga di comando | Descrizione |
---|---|
PercorsoArchivio |
Indica una cartella in cui verranno salvati i file e le impostazioni. Tieni presente che PercorsoArchivio non può essere c:\. Devi sempre specificare l'opzione PercorsoArchivio nel comando ScanState, tranne quando viene usata l'opzione /genconfig. Non puoi specificare più di un percorso PercorsoArchivio. |
/o |
Richiesto per sovrascrivere i dati esistenti nell'archivio delle migrazioni o il file Config.xml. Se non specificato, il comando ScanState avrà esito negativo nel caso in cui siano già presenti dati nell'archivio delle migrazioni. Questa opzione non può essere usata più di una volta nella riga di comando. |
/vsc |
Abilita il servizio Copia Shadow del volume per eseguire la migrazione di file bloccati o in uso. Questa opzione della riga di comando elimina la maggior parte degli errori di blocco dei file che in genere si verificano nella sezione <ErrorControl>. Può essere usata solo con il file eseguibile ScanState e non può essere combinata con l'opzione /hardlink. |
/hardlink |
Abilita la creazione di un archivio delle migrazioni con collegamento reale nel percorso specificato. L'opzione /nocompress deve essere specificata con l'opzione /hardlink. |
/encrypt [{/key:<StringaChiave> | /keyfile:<file>]} |
L'archivio viene crittografato con la chiave specificata. Per impostazione predefinita, la crittografia è disabilitata. Con questa opzione devi specificare la chiave di crittografia in uno dei modi seguenti:
È consigliabile che StringaChiave contenga almeno otto caratteri, ma non può superare i 256 caratteri. Le opzioni /key e /keyfile non possono essere usate nella stessa riga di comando. Le opzioni /encrypt e /nocompress non possono essere usate nella stessa riga di comando. > [!IMPORTANT] > Questa opzione deve essere usata con cautela perché chiunque abbia accesso allo script della riga di comando ScanState avrà accesso anche alla chiave di crittografia. >L'esempio seguente mostra il comando ScanState e l'opzione /key:
|
/encrypt:<LivelloCrittografia> |
L'opzione /encrypt accetta un parametro della riga di comando per definire il livello di crittografia da usare per la crittografia dell'archivio delle migrazioni. Per altre informazioni sugli algoritmi di crittografia supportati, vedi Crittografia dell'archivio delle migrazioni. |
/nocompress |
Disabilita la compressione dei dati e salva i file in una cartella nascosta denominata "File" in PercorsoArchivio\USMT. Per impostazione predefinita, la compressione è abilitata. La combinazione dell'opzione /nocompress con l'opzione /hardlink genera un archivio delle migrazioni con collegamento reale. Puoi usare l'archivio non compresso per visualizzare gli elementi archiviati da USMT, risolvere un problema o eseguire un'utilità antivirus sui file. Questa opzione deve essere usata solo in ambienti di testing poiché è consigliabile usare un archivio compresso durante la migrazione, a meno che l'opzione /nocompress non venga combinata con l'opzione /hardlink. Le opzioni /nocompress e /encrypt non possono essere usate insieme in una stessa istruzione nella riga di comando. Tuttavia, se scegli di eseguire la migrazione di un archivio non compresso, il comando LoadState eseguirà la migrazione di ciascun file direttamente dall'archivio al percorso corretto nel computer di destinazione senza un percorso temporaneo. Ad esempio:
|
Eseguire il comando ScanState in un sistema Windows offline
Puoi eseguire il comando ScanState in Windows PE. USMT supporta inoltre le migrazioni da installazioni precedenti di Windows contenute nelle directory Windows.old. La directory offline può essere una directory Windows quando esegui il comando ScanState in Windows PE o una directory Windows.old quando esegui il comando ScanState in Windows.
L'esecuzione del comando ScanState in un'immagine di Windows offline offre diversi vantaggi, tra cui:
Prestazioni migliorate.
Poiché Windows PE è un sistema operativo thin, sono presenti meno servizi in esecuzione. In questo ambiente il comando ScanState ha maggiore accesso alle risorse hardware locali, consentendo a ScanState di eseguire le operazioni di migrazione più velocemente.
Processo di distribuzione end-to-end semplificato.
La migrazione dei dati da Windows.old semplifica il processo di distribuzione end-to-end consentendo al processo di migrazione di venire avviato dopo l'installazione del nuovo sistema operativo.
Miglioramento del numero di migrazioni completate.
Il tasso di migrazioni riuscite aumenta perché i file non verranno bloccati per eseguire le modifiche offline e perché Windows PE fornisce l'accesso come amministratore al file system Windows offline, eliminando la necessità dell'accesso a livello amministratore al sistema online.
Capacità di ripristinare un computer non avviabile.
Potrebbe essere possibile ripristinare ed eseguire la migrazione dei dati da un computer non avviabile.
Opzioni della migrazione offline
Opzioni della riga di comando | Definizione |
---|---|
/offline: "percorso di un file offline.xml" |
Questa opzione viene usata per definire un percorso di un file XML offline che potrebbe specificare altre opzioni di migrazione offline, ad esempio, una directory Windows o qualsiasi reindirizzamento di dominio o cartella richiesto nella migrazione. |
/offlinewindir: "percorso di una directory Windows" |
Questa opzione specifica la directory Windows offline da cui il comando ScanState raccoglie lo stato dell'utente. La directory offline può essere una directory Windows.old quando esegui il comando ScanState in Windows o una directory Windows quando esegui il comando ScanState in Windows PE. |
/offlinewinold: "directory Windows.old" |
Questa opzione della riga di comando abilita la modalità di migrazione offline e avvia la migrazione dal percorso specificato. Deve essere usata solo negli scenari di migrazione Windows.old, dove la migrazione viene eseguita da una directory Windows.old. |
Opzioni per le regole di migrazione
USMT fornisce le seguenti opzioni per specificare i file di cui eseguire la migrazione.
Opzioni della riga di comando | Descrizione | ||||||||
---|---|---|---|---|---|---|---|---|---|
/i:[Percorso\]NomeFile |
(inclusione) Specifica un file con estensione XML che contiene le regole che definiscono di quale stato utente, applicazione o sistema eseguire la migrazione. Puoi specificare questa opzione più volte per includere tutti i file XML (MigApp.xml, MigDocs.xml e qualsiasi altro file XML personalizzato che hai creato). Percorso può essere un percorso relativo o completo. Se non si specifica la variabile Percorso, NomeFile deve essere posizionato nella directory corrente. Per altre informazioni su quali file specificare, vedi la sezione "File XML" dell'argomento Domande frequenti. |
||||||||
/genconfig:[Percorso\]NomeFile |
(generazione di Config.xml) Genera il file opzionale Config.xml, ma non crea un archivio delle migrazioni. Per verificare che il file contenga tutti i componenti, le applicazioni e le impostazioni di cui è possibile eseguire la migrazione, il file deve essere creato in un computer di origine che contiene tutti i componenti, le applicazioni e le impostazioni che saranno presenti nei computer di destinazione. Inoltre, devi specificare gli altri file XML della migrazione usando l'opzione /i quando specifichi questa opzione. Una volta creato, il file dovrà essere usato con il comando ScanState usando l'opzione /config. Le uniche opzioni che puoi specificare con questa opzione sono /i, /v e /l. Non puoi specificare PercorsoArchivio, perché l'opzione /genconfig non crea un archivio. Percorso può essere un percorso relativo o completo. Se non specifichi la variabile Percorso, NomeFile verrà creato nella directory corrente. Esempi:
|
||||||||
/config:[Percorso\]NomeFile |
Specifica il file Config.xml che deve essere usato dal comando ScanState per creare l'archivio. Questa opzione non può essere usata più di una volta nella riga di comando. Percorso può essere un percorso relativo o completo. Se non si specifica la variabile Percorso, NomeFile deve essere posizionato nella directory corrente. Nell'esempio seguente viene creato un archivio usando il file Config.xml e i file MigDocs.xml e MigApp.xml:
Nell'esempio seguente viene eseguita una migrazione di file e impostazioni nel computer di destinazione usando i file Config.xml, MigDocs.xml e MigApp.xml:
|
||||||||
/auto: percorso dei file script |
Questa opzione consente di specificare il percorso dei file XML predefiniti e quindi iniziare la migrazione. Se non è specificato alcun percorso, USMT farà riferimento alla directory in cui si trovano i file binari USMT. L'opzione /auto ha lo stesso effetto delle opzioni seguenti: /i:MigDocs.xml/i:MigApp.xml /v:5. |
||||||||
/genmigxml: percorso di un file |
Questa opzione specifica che il comando ScanState deve usare lo strumento di ricerca dei documenti per creare ed esportare un file XML che definisce in che modo eseguire la migrazione di tutti i file del computer in cui è in esecuzione il comando ScanState. |
||||||||
/localonly |
Esegue la migrazione dei soli file archiviati nel computer locale, indipendentemente dalle regole contenute nei file XML specificati nella riga di comando. Puoi usare questa opzione quando vuoi escludere i dati dalle unità rimovibili nel computer di origine, quali unità memoria flash USB, dischi rigidi esterni e così via, e quando esistono unità di rete mappate nel computer di origine. Se non viene specificata l'opzione /localonly, il comando ScanState copierà i file dalle unità rimovibili o di rete all'archivio. Tutto ciò che non è considerato come unità fissa dal sistema operativo verrà escluso da /localonly. In alcuni casi, i dischi rigidi esterni di grandi dimensioni vengono considerati unità fisse. Queste unità possono essere escluse in modo esplicito dalla migrazione usando un file custom.xml. Per altre informazioni su come escludere tutti i file in un'unità specifica, vedi Escludere file e impostazioni. L'opzione /localonly della riga di comando include o esclude i dati nella migrazione come indicato nella tabella seguente:
|
Opzioni di monitoraggio
USMT fornisce diverse opzioni che possono essere usate per analizzare i problemi che si verificano durante la migrazione.
Nota
Il file di log di ScanState viene creato per impostazione predefinita, ma puoi specificarne il nome e il percorso con l'opzione /l.
Opzioni della riga di comando | Descrizione | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/listfiles:<NomeFile> |
Puoi usare l'opzione /listfiles della riga di comando con il comando ScanState per generare un file di testo con l'elenco di tutti i file inclusi nella migrazione. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/l:[Percorso\]NomeFile |
Specifica il percorso e il nome del file di log di ScanState. Non puoi archiviare alcuno dei file di log in PercorsoArchivio. Percorso può essere un percorso relativo o completo. Se non specifichi la variabile Percorso, il log verrà creato nella directory corrente. Puoi usare l'opzione /v per modificare la quantità di output. Se esegui i comandi ScanState o LoadState da una risorsa di rete condivisa, devi specificare questa opzione. In caso contrario USMT restituirà un errore che indica che non è stato possibile creare i file di log. Per risolvere questo problema, usa il comando /l:scan.log. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <LivelloDettaglio> |
(Verbosity) Abilita l'output dettagliato nel file di log ScanState. Il valore predefinito è 0. Puoi impostare LivelloDettaglio su uno dei livelli seguenti:
Opzioni utentePer impostazione predefinita, viene eseguita la migrazione di tutti gli utenti. L'unico modo per specificare gli utenti da includere ed escludere è l'uso delle opzioni seguenti. Non puoi escludere gli utenti usando i file XML della migrazione o il file Config.xml. Per altre informazioni, vedi Identificare gli utenti e Eseguire la migrazione di account utente.
Come usare /ui e /ueGli esempi seguenti si applicano sia all'opzione /ui che all'opzione /ue. Puoi sostituire l'opzione /ue con l'opzione /ui per includere, anziché escludere, gli utenti specificati.
Usare le opzioni in combinazionePuoi usare insieme le opzioni /uel, /ue e /ui per eseguire la migrazione dei soli utenti desiderati. L'opzione /ui ha la precedenza sulle opzioni /ue e /uel. Se un utente è specificato per l'inclusione con l'opzione /ui ed è anche specificato per l'esclusione con l'opzione /ue o /uel, l'utente verrà incluso nella migrazione. Se ad esempio specifichi L'opzione /uel ha la precedenza sull'opzione /ue. Se un utente ha eseguito l'accesso nel periodo di tempo definito dall'opzione /uel, verrà eseguita la migrazione del profilo di tale utente anche se escluso con l'opzione /ue. Se ad esempio specifichi
Opzioni per i file crittografatiPuoi usare le seguenti opzioni per eseguire la migrazione dei file crittografati. In tutti i casi, per impostazione predefinita, USMT ha esito negativo se viene trovato un file crittografato, a meno che non specifichi un'opzione /efs. Per eseguire la migrazione dei file crittografati, devi modificare il comportamento predefinito. Per altre informazioni, vedi Eseguire la migrazione di file e certificati di EFS. Nota Verrà eseguita la migrazione automatica dei certificati di EFS quando si esegue la migrazione a Windows Vista, Windows 7 o Windows 8. Per questo motivo, devi specificare l'opzione /efs:copyraw con il comando ScanState per eseguire la migrazione dei file crittografati. Avviso Esegui la migrazione dei file crittografati con cautela. Se esegui la migrazione di un file crittografato senza eseguire anche la migrazione del certificato, gli utenti finali non riusciranno ad accedere al file dopo la migrazione.
Opzioni della riga di comando incompatibiliLa tabella seguente indica quali opzioni della riga di comando non sono compatibili con il comando ScanState. Se la voce nella tabella per una particolare combinazione è vuota, le opzioni sono compatibili ed è possibile usarle insieme. Il simbolo X indica che le opzioni non sono compatibili. Ad esempio, non puoi usare l'opzione /nocompress con l'opzione /encrypt.
Nota Devi specificare l'opzione /key o /keyfile insieme all'opzione /encrypt. Vedere ancheAltre risorse |