Sintassi di LoadState
Questo argomento illustra la sintassi e le opzioni del comando LoadState.
In questo argomento
Informazioni preliminari
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, ti consigliamo di eseguire i comandi LoadState in modalità amministratore da un account con credenziali amministrative.
Per informazioni sui requisiti software per l'esecuzione del comando LoadState, vedi Requisiti di USMT.
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 disponesse dell'accesso al controller di dominio nel momento in cui è stato raccolto il profilo utente con 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 in combinazione e quelle che sono incompatibili.
Sintassi
Questa sezione illustra la sintassi e l'uso 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.
La sintassi del comando LoadState è:
loadstate StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|help]
Ad esempio, per decrittografare l'archivio ed eseguire la migrazione di file e impostazioni in un computer che esegue Windows 7, nella riga di comando digita quanto segue:
loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"
Opzioni di archiviazione
USMT fornisce le opzioni seguenti per specificare come e dove archiviare i dati sottoposti a migrazione.
Opzione della riga di comando | Descrizione |
---|---|
StorePath |
Indica la cartella in cui vengono archiviati i dati relativi a file e impostazioni. Devi specificare StorePath quando usi il comando LoadState. Non puoi specificare più di un oggetto StorePath. |
/decrypt /key:KeyString oppure /decrypt /key:"Key String" oppure /decrypt /keyfile:[Path\]FileName |
Decrittografa l'archivio con la chiave specificata. Con questa opzione devi specificare la chiave di crittografia in uno dei modi seguenti:
KeyString 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. ImportanteUsa questa opzione con cautela perché chiunque abbia accesso allo script della riga di comando di LoadState avrà accesso anche alla chiave di crittografia. Ad esempio:
|
/decrypt:"encryption strength" |
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. Ad esempio:
|
Opzioni per le regole di migrazione
USMT fornisce le opzioni seguenti per specificare i file di cui eseguire la migrazione.
Opzione della riga di comando | Descrizione |
---|---|
/i:[Path\]FileName |
(include) Specifica un file XML contenente regole che definiscono di quale stato eseguire la migrazione. Puoi specificare questa opzione più volte per includere tutti i file XML (MigApp.xml, MigSys.xml, MigDocs.xml ed eventuali file XML personalizzati che hai creato). Path può essere un percorso relativo o completo. Se non specifichi la variabile Path, FileName deve trovarsi nella directory corrente. Per altre informazioni su quali file specificare, vedi la sezione "File XML" dell'argomento Domande frequenti. |
/config:[Path\]FileName |
Specifica il file Config.xml che deve essere usato dal comando LoadState. Non puoi specificare questa opzione più di una volta nella riga di comando. Path può essere un percorso relativo o completo. Se non specifichi la variabile Path, FileName deve trovarsi nella directory corrente. Questo esempio esegue la migrazione di file e impostazioni in base alle regole specificate nei file Config.xml, MigDocs.xml e MigApp.xml:
|
/auto:"path to script files" |
Questa opzione consente di specificare il percorso dei file XML predefiniti e quindi di avviare la migrazione. Se non specifichi alcun percorso, USMT userà la directory in cui si trovano i relativi file binari. L'opzione /auto ha lo stesso effetto delle opzioni seguenti: /i:MigDocs.xml /i:MigApp.xml /v:5. |
Opzioni di monitoraggio
USMT fornisce diverse opzioni della riga di comando che puoi usare per analizzare i problemi che si verificano durante la migrazione.
Opzione della riga di comando | Descrizione |
---|---|
/l:[Path\]FileName |
Specifica il percorso e il nome del log di LoadState. Non puoi archiviare alcuno dei file di log in StorePath. Path può essere un percorso relativo o completo. Se non specifichi la variabile Path, 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 restituirà un errore che indica che non è stato possibile creare i file di log. Per risolvere questo problema, usa l'opzione /l:load.log. |
/v:<VerbosityLevel> |
(Verbosity) Abilita l'output dettagliato nel file di log di LoadState. Il valore predefinito è 0. Puoi impostare VerbosityLevel su uno dei livelli seguenti:
LivelloSpiegazione
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.
Ad esempio:
|
/progress:[Path\]FileName |
Consente di creare il log di stato facoltativo. Non puoi archiviare alcuno dei file di log in StorePath. Path può essere un percorso relativo o completo. Se non specifichi la variabile Path, FileName verrà creato nella directory corrente. Ad esempio:
|
/c |
Quando specifichi questa opzione, il comando LoadState 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 LoadState registrerà un errore e la migrazione continuerà. Senza l'opzione /c il comando LoadState verrà interrotto al primo errore. Puoi usare la nuova sezione <ErrorControl> 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 /c di ignorare senza conseguenze tutti gli errori di input/output (I/O) dell'ambiente. Inoltre, l'opzione /genconfig genera ora una sezione <ErrorControl> di esempio che viene abilitata specificando i messaggi di errore e i comportamenti desiderati nel file Config.xml. |
/r:<TimesToRetry> |
(Nuovi tentativi) 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. Durante il ripristino dello stato utente, l'opzione /r non recupera i dati persi a causa di un errore dell'hardware di rete, ad esempio nel caso di un cavo di rete difettoso o scollegato, o a causa di un errore di 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. |
/w:<SecondsBeforeRetry> |
(Attesa) Specifica il tempo da attendere, in secondi, prima di riprovare a eseguire un'operazione su un file in rete. L'impostazione predefinita è 1 secondo. |
/? o /help |
Visualizza la Guida nella riga di comando. |
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 tuttavia scegli di usare l'opzione /all, non puoi usare anche le opzioni /ui, /ue e /uel. |
/ui:DomainName\UserName oppure /ui:"DomainName\User Name" oppure /ui:ComputerName\LocalUserName |
(Inclusione utenti) Esegue la migrazione dell'utente specificato. Per impostazione predefinita, tutti gli utenti vengono inclusi nella migrazione. Per questo motivo, questa opzione è utile solo quando viene usata con l'opzione /ue. Puoi specificare più opzioni /ui, ma non puoi usare l'opzione /ui con l'opzione /all. DomainName e UserName possono contenere il carattere jolly asterisco (*). Quando specifichi un nome utente che contiene spazi, devi racchiuderlo tra virgolette. Ad esempio:
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:<NumberOfDays> oppure /uel:<YYYY/MM/DD> oppure /uel:0 |
(Esclusione utenti in base all'ultimo accesso) Esegue la migrazione dei soli utenti che hanno eseguito l'accesso nel computer di origine nel periodo specificato, in base alla data di Ultima modifica del file Ntuser.dat nel computer di origine. L'opzione /uel opera come una regola di inclusione. Ad esempio, con l'opzione /uel:30 viene eseguita 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. NotaL'opzione /uel non è valida nelle migrazioni offline. Esempi:
Ad esempio:
|
/ue:DomainName\UserName oppure /ue:"DomainName\User Name" oppure /ue:ComputerName\LocalUserName |
(Esclusione utenti) Esclude gli utenti specificati dalla migrazione. Puoi specificare più opzioni /ue, ma non puoi usare l'opzione /ue insieme all'opzione /all. DomainName e UserName possono contenere il carattere jolly asterisco (*). Quando specifichi un nome utente che contiene spazi, devi racchiuderlo tra virgolette. Ad esempio:
Per altri esempi, vedi le descrizioni delle opzioni /uel, /ue e /ui in questa tabella. |
/md:OldDomain:NewDomain oppure /md:LocalComputerName:NewDomain |
(Spostamento dominio) Specifica un nuovo dominio per l'utente. Usa questa opzione per modificare il dominio degli utenti in un computer o per eseguire la migrazione di un utente locale in un account di dominio. OldDomain 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, puoi specificare quanto segue: In caso di conflitto tra due comandi /md, viene applicata la regola specificata per prima. Se, ad esempio, specifichi i comandi Se specifichi un elemento OldDomain che non è presente nel computer di origine, il comando LoadState risulterà eseguito correttamente, senza errori né avvisi. In questo caso, tuttavia, gli utenti non verranno spostati in NewDomain, 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. Ad esempio:
|
/mu:OldDomain\OldUserName:[NewDomain\]NewUserName oppure /mu:OldLocalUserName:NewDomain\NewUserName |
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. Ad esempio:
|
/lac:[Password] |
(Creazione account locale) Specifica che se un account utente è un account locale (non di dominio) e non è presente nel computer di destinazione, USMT creerà l'account nel computer di destinazione, che sarà però 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. AttenzioneUsa 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. Ad esempio:
Per istruzioni, vedi Eseguire la migrazione di account utente. |
/lae |
(abilitazione account locale) Abilita l'account creato con l'opzione /lac. Devi specificare l'opzione /lac con questa opzione. Ad esempio:
Per istruzioni, vedi Eseguire la migrazione di account utente. |
Esempi d'uso delle opzioni /ui e /ue
Gli esempi seguenti si applicano sia all'opzione /ui sia 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. |
|
Escludere l'utente denominato Utente1 nel dominio Corporate. |
|
Escludere l'utente locale denominato Utente1. |
|
Escludere tutti gli utenti di dominio. |
|
Escludere tutti gli utenti locali. |
|
Escludere gli utenti in tutti i domini denominati Utente1, Utente2 e così via. |
|
Usare le opzioni in combinazione
Puoi usare le opzioni /uel, /ue e /ui insieme 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 User1 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 è stato escluso usando l'opzione /ue. Se, ad esempio, specifichi /ue:contoso\user1 /uel:14
, la migrazione di User1 verrà eseguita se l'utente ha eseguito l'accesso al computer negli ultimi 14 giorni.
Comportamento | Comando |
---|---|
Includere solo Utente2 del dominio Fabrikam ed escludere tutti gli altri utenti. |
|
Includere solo l'utente locale denominato Utente1 ed escludere tutti gli altri utenti. |
|
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:
|
Includere solo gli utenti locali (non di dominio). |
|
Opzioni della riga di comando incompatibili
La tabella seguente indica quali opzioni della riga di comando non sono 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.