In questo argomento vengono descritte la sintassi e le opzioni del comando LoadState.
In questo argomento
Prima di iniziare
Sintassi
Opzioni di archiviazione
Opzioni per le regole di migrazione
Opzioni di monitoraggio
Opzioni utente
Opzioni della riga di comando incompatibili
Prima di iniziare
Prima di eseguire il comando LoadState, tieni presente quanto segue:
Per assicurarti che venga eseguita la migrazione di tutte le impostazioni del sistema operativo, è consigliabile eseguire i comandi LoadState in modalità amministratore da un account con credenziali amministrative.
Dopo aver eseguito il comando LoadState devi disconnetterti. Alcune impostazioni, come quelle relative ai tipi di carattere, allo sfondo e allo screensaver, diventeranno effettive solo al successivo accesso dell'utente.
Se non diversamente specificato, ogni opzione di uno strumento della riga di comando può essere usata una sola volta.
LoadState non richiede l'accesso al controller di dominio per applicare i profili di dominio. Questa funzionalità è disponibile senza alcuna configurazione aggiuntiva. Non è necessario che il computer di origine disponga dell'accesso al controller di dominio quando il profilo utente viene acquisito tramite ScanState. I profili di dominio sono tuttavia inaccessibili finché il computer di destinazione non viene unito al dominio.
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.
Sintassi
In questa sezione viene illustrata la sintassi delle opzioni della riga di comando disponibili con il comando LoadState. Le opzioni possono essere specificate in qualsiasi ordine. Se l'opzione contiene un parametro, puoi specificare come separatore una virgola o uno spazio.
Ad esempio, per decrittografare l'archivio ed eseguire la migrazione di file e impostazioni in un computer che esegue Windows Vista o Windows 7, nella riga di comando digita quanto segue:
Le opzioni seguenti di USMT ti consentono di specificare come e dove archiviare i dati sottoposti a migrazione.
Opzioni della riga di comando
Descrizione
PercorsoArchivio
Indica la cartella in cui vengono archiviati i dati relativi a file e impostazioni. Devi specificare PercorsoDiArchiviazione quando usi il comando LoadState. Non puoi specificare più di un PercorsoDiArchiviazione.
/decrypt/key:StringaChiave
oppure
/decrypt/key:"StringaChiave"
oppure
/decrypt/keyfile:[Percorso\]NomeFile
Decrittografa l'archivio con la chiave specificata. Con questa opzione devi specificare la chiave di crittografia in uno dei modi seguenti:
/key:StringaChiave specifica la chiave di crittografia. Se StringaChiave contiene uno spazio, devi racchiudere l'argomento tra virgolette.
/keyfile:PercorsoENomeFile specifica un file di testo (txt) contenente la chiave di crittografia
StringaChiave non può superare i 256 caratteri.
Le opzioni /key e /keyfile non possono essere usate nella stessa riga di comando.
Le opzioni /decrypt 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 LoadState avrà anche accesso alla chiave di crittografia.
>
L'opzione /decrypt accetta un parametro della riga di comando per definire il livello di crittografia dell'archivio delle migrazioni. Per altre informazioni sugli algoritmi di crittografia supportati, vedi Crittografia dell'archivio delle migrazioni.
/hardlink
Consente il ripristino dei dati relativi allo stato utente da un archivio delle migrazioni con collegamento reale. Il parametro /nocompress deve essere specificato con l'opzione /hardlink.
/nocompress
Specifica che l'archivio non è compresso. Usa questa opzione solo negli ambienti di test. Durante la migrazione reale è consigliabile usare un archivio compresso. Questa opzione non può essere usata insieme all'opzione /decrypt.
USMT fornisce le seguenti opzioni per specificare i file di cui eseguire la migrazione.
Opzioni della riga di comando
Descrizione
/i:[Percorso\]NomeFile
(include)
Specifica un file xml contenente regole che definiscono quale stato sottoporre a migrazione Puoi specificare questa opzione più volte per includere tutti i tuoi file xml (MigApp.xml, MigSys.xml, MigDocs.xml e ogni ulteriore file xml personalizzato appositamente 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.
/config:[Percorso\]NomeFile
Specifica il file Config.xml che dovrà essere usato dal comando LoadState. Non puoi specificare questa opzione più di una volta nella riga di comando. Percorso può essere un percorso relativo o completo. Se non specifichi la variabile Percorso, NomeFile dovrà trovarsi nella directory corrente.
In questo esempio viene eseguita la migrazione di file e impostazioni in base alle regole specificate nei file Config.xml, MigDocs.xml e MigApp.xml:
Questa opzione consente di specificare il percorso dei file xml predefiniti e di avviare la migrazione. Se non specifichi alcun percorso, USMT userà la directory contenente i file binari di USMT. Usare l'opzione /auto equivale a usare le opzioni seguenti /i:MigDocs.xml/i:MigApp.xml /v:5.
Opzioni di monitoraggio
USMT dispone di diverse opzioni della riga di comando che consentono di analizzare i problemi che dovessero verificarsi durante la migrazione.
Opzioni della riga di comando
Descrizione
/l:[Percorso\]NomeFile
Specifica il percorso e il nome del file di log di LoadState. 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 specificare l'opzione /v per regolare la quantità di output.
Se esegui il comando LoadState da una risorsa di rete condivisa, devi specificare questa opzione. In caso contrario, USMT genererà un errore che indica che USMT non è riuscito a creare i file di log. Per risolvere questo problema, usa l'opzione /l:load.log.
/v:<LivelloDettaglio>
(Verbosity)
Abilita l'output dettagliato nel file di log di LoadState. 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.
</div>
<p>Ad esempio:</p>
<p>
<code>loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml</code>
</p>
</td>
</tr>
<tr>
<td colspan="1">
<p>
<strong>/progress:</strong>[<em>Percorso\</em>]<em>NomeFile</em></p>
</td>
<td colspan="1">
<p>Consente di creare il log di stato facoltativo. Non puoi archiviare alcuno dei file di log in <em>PercorsoArchivio</em>. <em>Percorso</em> può essere un percorso relativo o completo. Se non specifichi la variabile <em>Percorso</em>, <em>NomeFile</em> verrà creato nella directory corrente.</p>
<p>Ad esempio:</p>
<p>
<code>loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
</p>
</td>
</tr>
<tr>
<td>
<p>
<strong>/c</strong>
</p>
</td>
<td>
<p>Quando si specifica questa opzione, il comando <strong>LoadState</strong> continuerà l'esecuzione anche se si verificano errori non irreversibili. Tutti i file o le impostazioni che causano un errore vengono registrati nel log di stato. Se ad esempio lo spazio disponibile nel computer non è sufficiente per contenere un file di grandi dimensioni, il comando <strong>LoadState</strong> registrerà un errore e la migrazione continuerà. Senza l'opzione <strong>/c</strong> il comando <strong>LoadState</strong> termina al primo errore. Puoi usare la nuova sezione <<strong>ErrorControl</strong>> del file Config.xml per specificare quali errori di lettura o scrittura di file o del Registro di sistema possono essere ignorati senza conseguenze e quali possono comportare l'esito negativo della migrazione. Questo consente all'opzione della riga di comando <strong>/c</strong> di ignorare senza conseguenze tutti gli errori di input/output (I/O) dell'ambiente. Inoltre, l'opzione <strong>/genconfig</strong> ora genera una sezione <<strong>ErrorControl</strong>> di esempio che viene abilitata specificando i messaggi di errore e i comportamenti desiderati nel file Config.xml.</p>
</td>
</tr>
<tr>
<td colspan="1">
<p>
<strong>/r:</strong>
<em><NumeroTentativi></em>
</p>
</td>
<td colspan="2">
<p>
<strong>(Tentativi)</strong>
</p>
<p>Specifica il numero di tentativi da eseguire quando si verifica un errore durante la migrazione dello stato utente da un server. L'impostazione predefinita è tre volte. Questa opzione è utile negli ambienti in cui la connettività di rete non è affidabile.</p>
<p>Durante il ripristino dello stato utente, l'opzione <strong>/r</strong> non recupera i dati persi per un errore hardware della rete, come quelli provocati da un cavo di rete difettoso o scollegato o dall'esito negativo di una connessione a una rete privata virtuale (VPN). L'opzione per i tentativi è destinata alle reti di grandi dimensioni e con traffico elevato, in cui la connettività è soddisfacente ma la latenza delle comunicazioni rappresenta un problema.</p>
</td>
</tr>
<tr>
<td colspan="1">
<p>
<strong>/w:</strong>
<em><SecondiPrimaDiRiprovare></em>
</p>
</td>
<td colspan="2">
<p>
<strong>(Attesa)</strong>
</p>
<p>Specifica il tempo da attendere, in secondi, prima di riprovare a eseguire un'operazione su un file in rete. L'impostazione predefinita è 1 secondo.</p>
</td>
</tr>
<tr>
<td colspan="1">
<p>
<strong>/?</strong> o <strong>/help</strong></p>
</td>
<td colspan="2">
<p>Visualizza la Guida nella riga di comando.</p>
</td>
</tr>
</table>
Opzioni utente
Per 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 utenti nei file xml della migrazione o mediante l'uso del file Config.xml. Per altre informazioni, vedi Identificare gli utenti.
Opzioni della riga di comando
Descrizione
/all
Esegue la migrazione di tutti gli utenti del computer.
USMT esegue la migrazione di tutti gli account utente del computer, a meno che non escludi espressamente un account con l'opzione /ue o /uel. Per tale motivo, non è necessario specificare questa opzione nella riga di comando. Se comunque scegli di usare l'opzione /all non potrai usare anche l'opzione /ui, /ue o /uel.
/ui:NomeDominio\NomeUtente
oppure
/ui:"NomeDominio\Nome utente"
oppure
/ui:NomeComputer\NomeUtenteLocale
(Inclusione utenti)
Esegue la migrazione dell'utente specificato. Per impostazione predefinita, tutti gli utenti vengono inclusi nella migrazione. Per questo motivo, l'opzione è utile solo quando viene usata con l'opzione /ue. Puoi specificare più opzioni /ui, ma non puoi usare l'opzione /ui insieme all'opzione /all. NomeDominio e NomeUtente possono contenere il carattere jolly asterisco (*). Quando specifichi un nome utente che contiene spazi, devi racchiuderlo tra virgolette.
Ad esempio:
Per includere solo l'utente User2 del dominio aziendale, digita:
/ue:*\* /ui:corporate\user2
Nota
Se un utente è specificato per l'inclusione con l'opzione /ui ed è anche specificato per l'esclusione con l'opzione /ue o /uel, verrà incluso nella migrazione.
Per altri esempi, vedi le descrizioni delle opzioni /uel, /ue e /ui in questa tabella.
/uel:<NumeroDiGiorni>
oppure
/uel:<AAAA/MM/GG>
oppure
/uel:0
(Esclusione utenti in base all'ultimo accesso)
Esegue la migrazione dei soli utenti che hanno eseguito l'accesso al computer di origine nel periodo specificato, in base alla data Last Modified del file Ntuser.dat del computer di origine. L'opzione /uel opera come una regola di inclusione. Ad esempio, l'opzione /uel:30 esegue la migrazione degli utenti che hanno eseguito l'accesso o il cui account utente è stato modificato nei 30 giorni precedenti alla data di esecuzione del comando ScanState.
Puoi specificare un numero di giorni o una data. Non puoi usare questa opzione con l'opzione /all. USMT recupera le informazioni sull'ultimo accesso dal computer locale, per cui non è necessario che il computer sia connesso alla rete quando si esegue questa opzione. Inoltre, se un utente di dominio ha eseguito l'accesso a un altro computer, tale istanza di accesso non viene considerata da USMT.
Nota
L'opzione /uel non è valida nelle migrazioni offline.
Esempi:
/uel:0 esegue la migrazione degli account che erano connessi al computer di origine al momento dell'esecuzione del comando ScanState.
/uel:90 esegue la migrazione degli utenti che hanno eseguito l'accesso o i cui account sono stati modificati in altro modo negli ultimi 90 giorni.
/uel:1 esegue la migrazione degli utenti i cui account sono stati modificati nelle ultime 24 ore.
/uel:2002/1/15 esegue la migrazione degli utenti che hanno eseguito l'accesso o i cui account sono stati modificati dopo il 15 gennaio 2002.
Esclude gli utenti specificati dalla migrazione. Puoi specificare più opzioni /ue ma non puoi usare l'opzione /ue insieme all'opzione /all. NomeDominio e NomeUtente possono contenere il carattere jolly asterisco (*). Quando si specifica un nome utente che contiene spazi, è necessario racchiuderlo tra virgolette.
Per altri esempi, vedi le descrizioni delle opzioni /uel, /ue e /ui in questa tabella.
/md:VecchioDominio:NuovoDominio
oppure
/md:NomeComputerLocale:NuovoDominio
(spostamento dominio)
Specifica un nuovo dominio per l'utente. Usa questa opzione per modificare il dominio degli utenti di un computer o per eseguire la migrazione di un utente locale in un account di dominio. VecchioDominio può contenere il carattere jolly asterisco (*).
Puoi specificare questa opzione più di una volta. Se vuoi consolidare gli utenti di più domini in un unico dominio, puoi specificare più opzioni /md. Ad esempio, per consolidare gli utenti dei domini Corporate e FarNorth nel dominio Fabrikam, potresti specificare: /md:corporate:fabrikam e /md:farnorth:fabrikam.
In caso di conflitto tra due comandi /md viene applicata la regola specificata per prima. Se ad esempio specifichi i comandi /md:corporate:fabrikam e /md:corporate:farnorth, gli utenti Corporate verranno mappati al dominio Fabrikam.
Nota
Se specifichi un VecchioDominio che non esiste nel computer di origine, il comando LoadState risulterà eseguito correttamente, senza errori né avvisi. Gli utenti, tuttavia, non verranno spostati in NuovoDominio, ma resteranno nel proprio dominio originale. Se ad esempio digiti erroneamente "contoso" e specifichi "/md:contso:fabrikam", gli utenti rimarranno in contoso nel computer di destinazione.
Specifica un nuovo nome per l'utente specificato. Se l'archivio contiene più utenti, puoi specificare più opzioni /mu. Non puoi usare caratteri jolly con questa opzione.
Specifica che se un account utente è un account locale (non di dominio) e non esiste nel computer di destinazione, USMT creerà l'account nel computer di destinazione ma sarà disabilitato. Per abilitare l'account, devi usare anche l'opzione /lae.
Se l'opzione /lac non viene specificata, la migrazione di tutti gli account utente locali che non sono già presenti nel computer di destinazione non verrà eseguita.
Password è la password del nuovo account creato. Per impostazione predefinita, viene usata una password vuota.
Attenzione
Usa la variabile Password con cautela perché viene fornita in testo normale e può essere letta da chiunque abbia accesso al computer che esegue il comando LoadState.
Inoltre, se nel computer sono presenti più utenti, tutti gli utenti migrati avranno la stessa password.
Gli esempi seguenti si applicano sia all'opzione /ui che all'opzione /ue. Puoi sostituire l'opzione /ue con l'opzione /ui per includere gli utenti specificati, anziché escluderli.
Comportamento
Comando
Escludere l'utente denominato Utente uno nel dominio Corporate.
/ue:"corporate\user one"
Escludere l'utente denominato Utente1 nel dominio Corporate.
/ue:corporate\user1
Escludere l'utente locale denominato Utente1.
/ue:%computername%\user1
Escludere tutti gli utenti di dominio.
/ue:Domain\*
Escludere tutti gli utenti locali.
/ue:%computername%\*
Escludere gli utenti in tutti i domini denominati Utente1, Utente2 e così via.
/ue:*\user*
Usare le opzioni in combinazione
Puoi 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 /ui:contoso\* /ue:contoso\user1, la migrazione di Utente1 verrà eseguita, perché l'opzione /ui ha la precedenza sull'opzione /ue.
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 usando l'opzione /ue. Se ad esempio specifichi /ue:contoso\user1 /uel:14, la migrazione di User1 verrà eseguita se ha eseguito l'accesso al computer negli ultimi 14 giorni.
Comportamento
Comando
Includere solo Utente2 del dominio Fabrikam ed escludere tutti gli altri utenti.
/ue:*\* /ui:fabrikam\user2
Includere solo l'utente locale denominato Utente1 ed escludere tutti gli altri utenti.
/ue:*\* /ui:user1
Includere solo gli utenti di dominio di Contoso, tranne Contoso\Utente1.
Questo comportamento non può essere completato usando un singolo comando. Per eseguire la migrazione di questo set di utenti, è invece necessario specificare quanto segue:
Usando lo strumento della riga di comando ScanState, digita: /ue:*\* /ui:contoso\*
Usando lo strumento della riga di comando LoadState, digita: /ue:contoso\user1
Includere solo gli utenti locali (non di dominio).
/ue:*\* /ui:%computername%\*
Opzioni della riga di comando incompatibili
Nella tabella seguente vengono indicate le opzioni della riga di comando non compatibili con il comando LoadState. 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.
Opzioni della riga di comando
/keyfile
/nocompress
/genconfig
/all
/i
/v
/nocompress
N/D
X
/key
X
X
/decrypt
Obbligatorio*
X
X
/keyfile
N/D
X
/l
/progress
X
/r
X
/w
X
/c
X
/p
X
N/D
/all
X
/ui
X
X
/ue
X
X
/uel
X
X
/genconfig
N/D
/config
X
PercorsoArchivio
/md
/mu
/lae
/lac
Nota
Devi specificare l'opzione /key o /keyfile insieme all'opzione /encrypt.
.gif "note")
Nota .gif "Caution")
Attenzione