Sintassi di LoadState
Il LoadState.exe comando viene usato con lo Strumento di migrazione stato utente (USMT) per ripristinare un archivio acquisito in precedenza dal ScanState.exe comando in un computer di destinazione. Questo articolo illustra la sintassi dei LoadState.exe comandi e le opzioni disponibili.
Prima di iniziare
Prima di eseguire il LoadState.exe comando, prendere nota degli elementi seguenti:
Per assicurarsi che tutte le impostazioni del sistema operativo eseguano la migrazione, Microsoft consiglia di eseguire
LoadState.execomandi in modalità amministratore da un account con credenziali amministrative.Per informazioni sui requisiti software per l'esecuzione del
LoadState.execomando, vedere Requisiti USMT.Disconnettersi dopo aver eseguito il
LoadState.execomando. Alcune impostazioni, ad esempio i tipi di carattere, lo sfondo e le impostazioni dello screen saver, non saranno effettive fino al successivo accesso dell'utente.Se non diversamente specificato, ogni opzione può essere usata una sola volta quando si esegue uno strumento dalla riga di comando.
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 abbia accesso al controller di dominio quando il profilo utente è stato raccolto usando ScanState. Tuttavia, i profili di dominio non sono accessibili fino a quando il computer di destinazione non viene aggiunto al dominio.
La tabella delle opzioni della riga di comando Incompatibile elenca le opzioni che è possibile usare insieme e le opzioni della riga di comando incompatibili.
Sintassi
Questa sezione illustra la sintassi e l'utilizzo delle opzioni della riga di comando disponibili quando si usa il LoadState.exe comando . Le opzioni possono essere specificate in qualsiasi ordine. Se l'opzione contiene un parametro, è possibile specificare due punti o un separatore di spazio.
La LoadState.exe sintassi del comando è:
LoadState.exe 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 dei file e delle impostazioni in un computer, digitare il comando seguente:
LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"
Opzioni di archiviazione
USMT offre le opzioni seguenti che possono essere usate per specificare come e dove vengono archiviati i dati migrati.
| Opzione Command-Line | Descrizione |
|---|---|
| StorePath | Indica la cartella in cui sono archiviati i file e i dati delle impostazioni.
StorePath deve essere specificato quando si usa il LoadState.exe comando . Non è possibile specificare più storepath . |
|
/decrypt /key:KeyString or /decrypt /key:"Key String" or /decrypt /keyfile:[Path]FileName |
Decrittografa l'archivio con la chiave specificata. Con questa opzione, la chiave di crittografia deve essere specificata in uno dei modi seguenti:
KeyString non può superare i 256 caratteri. Le /key opzioni e /keyfile non possono essere usate nella stessa riga di comando.Le /decrypt opzioni e /nocompress non possono essere usate nella stessa riga di comando.
Importante Prestare attenzione quando si usano le /key opzioni o keyfile . Ad esempio, chiunque abbia accesso agli script che eseguono il LoadState.exe comando con queste opzioni ha anche accesso alla chiave di crittografia.Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /decrypt:"encryption strength" | L'opzione /decrypt accetta un parametro della riga di comando per definire il livello di crittografia specificato per la crittografia dell'archivio di migrazione. Per altre informazioni sugli algoritmi di crittografia supportati, vedere Migration Store Encryption. |
| /hardlink | Consente di ripristinare i dati dello stato utente da un archivio di migrazione con collegamento rigido. Il /nocompress parametro deve essere specificato con /hardlink l'opzione . |
| /nocompress | Specifica che l'archivio non è compresso. Questa opzione deve essere usata solo negli ambienti di test. Microsoft consiglia di usare un archivio compresso durante la migrazione effettiva. Questa opzione non può essere usata con l'opzione /decrypt .Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
Opzioni delle regole di migrazione
USMT offre le opzioni seguenti per specificare i file di cui eseguire la migrazione.
| Opzione Command-Line | Descrizione |
|---|---|
| /i:[Percorso]NomeFile |
(include) Specifica un file .xml che contiene regole che definiscono i dati di cui eseguire la migrazione. Questa opzione può essere specificata più volte per includere tutti i file .xml ( MigApp.xml, MigSys.xmlMigDocs.xml e tutti i file di.xml personalizzati creati).
Il percorso può essere un percorso relativo o completo. Se la variabile Path non è specificata, FileName deve trovarsi nella directory corrente.Per altre informazioni sui file da specificare, vedere la sezione "File XML" dell'articolo Domande frequenti . |
| /config:[Percorso]NomeFile | Specifica il Config.xml file che deve essere usato dal LoadState.exe comando. Questa opzione non può essere specificata più di una volta nella riga di comando.
Il percorso può essere un percorso relativo o completo. Se la variabile Path non è specificata, il fileName deve trovarsi nella directory corrente.In questo esempio vengono migrati i file e le impostazioni in base alle regole nei Config.xmlfile , MigDocs.xmle MigApp.xml :LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
| /auto:"percorso dei file di script" | Questa opzione consente di specificare il percorso dei file di.xml predefiniti. Se non viene specificato alcun percorso, USMT usa la directory in cui si trovano i file binari USMT. L'opzione /auto ha lo stesso effetto dell'uso delle opzioni seguenti: /i:MigDocs.xml/i:MigApp.xml /v:5. |
Opzioni di monitoraggio
USMT offre diverse opzioni della riga di comando che possono essere usate per analizzare i problemi che si verificano durante la migrazione.
| Opzione Command-Line | Descrizione |
|---|---|
| /l:[Percorso]NomeFile | Specifica il percorso e il nome del log LoadState . I file di log non possono essere archiviati in StorePath.
Il percorso può essere un percorso relativo o completo. Se la variabile Path non è specificata, il log viene creato nella directory corrente. È /v possibile specificare l'opzione per modificare il livello di dettaglio del log.Se si esegue il LoadState.exe comando da una risorsa di rete condivisa, è necessario specificare l'opzione l oppure USMT ha esito negativo con l'errore:USMT non è riuscito a creare i file di log Per risolvere questo problema, assicurarsi di specificare l'opzione durante l'esecuzione /lLoadState.exe da una risorsa di rete condivisa. |
/v:<VerbosityLevel> |
(Dettaglio) Abilita l'output dettagliato nel file di log LoadState . Il valore predefinito è 0. VerbosityLevel può essere impostato su uno dei livelli seguenti:
Ad esempio: LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml |
| /progress:[Path]FileName | Crea il log di stato facoltativo. I file di log non possono essere archiviati in StorePath.
Il percorso può essere un percorso relativo o completo. Se la variabile Path non è specificata, FileName viene creato nella directory corrente. Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log |
| /c | Quando si specifica questa opzione, il LoadState.exe comando continua a essere eseguito, anche se si verificano errori non irreversibili. Tutti i file o le impostazioni che causano un errore vengono registrati nel log di stato. Ad esempio, se è presente un file di grandi dimensioni che non rientra nel computer, il LoadState.exe comando registra un errore e continua con la migrazione. Senza l'opzione /c , il LoadState.exe comando esce dal primo errore. La < sezione ErrorControl> può essere usata nel Config.xml file per specificare il file o gli errori di lettura/scrittura del Registro di sistema che possono essere ignorati in modo sicuro e che potrebbero causare errori di migrazione. Questo controllo degli errori consente all'opzione della /c riga di comando di ignorare in modo sicuro tutti gli errori di input/output (I/O) nell'ambiente. Inoltre, l'opzione /genconfig genera ora una sezione ErrorControl> di esempio < abilitata specificando i messaggi di errore e i comportamenti desiderati nel Config.xml file. |
/r:<TimesToRetry> |
(Riprova) Specifica il numero di tentativi da ripetere quando si verifica un errore durante la migrazione dello stato utente da un server. Il valore predefinito è tre volte. Questa opzione è utile negli ambienti in cui la connettività di rete non è affidabile. Quando lo stato dell'utente viene ripristinato, l'opzione /r non recupera i dati persi a causa di un errore hardware di rete, ad esempio un cavo di rete guasto o disconnesso, o quando una connessione VPN (Virtual Private Network) non riesce. L'opzione di ripetizione dei tentativi è destinata a reti di grandi dimensioni e occupate in cui la connettività è soddisfacente, ma la latenza di comunicazione è un problema. |
/w:<SecondsBeforeRetry> |
(Attendere) Specifica il tempo di attesa, espresso in secondi, prima di ritentare un'operazione di file di rete. Il valore predefinito è 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 consiste nell'usare le opzioni seguenti. Gli utenti non possono essere esclusi nella migrazione .xml file o usando il Config.xml file . Per altre informazioni, vedere Identificare gli utenti.
| Opzione Command-Line | Descrizione |
|---|---|
| /tutto | Esegue la migrazione di tutti gli utenti nel computer. USMT esegue la migrazione di tutti gli account utente nel computer, a meno che un account non sia specificamente escluso con le /ue opzioni o /uel . Per questo motivo, questa opzione non deve essere specificata nella riga di comando. Tuttavia, se si usa l'opzione /all , non è possibile usare anche le /uiopzioni o /ue/uel . |
|
/ui:DomainName NomeUtente or /ui:"NomeDominio Nome utente" or /ui:ComputerName LocalUserName |
(Inclusione utente) Esegue la migrazione dell'utente specificato. Per impostazione predefinita, tutti gli utenti sono inclusi nella migrazione. Di conseguenza, questa opzione è utile solo se usata con l'opzione /ue . È possibile specificare più /ui opzioni, ma l'opzione /ui non può essere usata con l'opzione /all .
DomainName e UserName possono contenere il carattere jolly asterisco (*). Quando viene specificato il nome utente che contiene spazi, deve essere racchiuso tra virgolette (").Ad esempio, per includere solo User2 dal dominio aziendale, immettere: /ue:* /ui:corporate\user2
Nota Se un utente viene specificato per l'inclusione con l'opzione /ui e specificato anche per essere escluso con le /ue opzioni o /uel , l'utente viene incluso nella migrazione.Per altri esempi, vedere le descrizioni delle /uelopzioni , /uee /ui in questa tabella. |
/uel:<NumberOfDays>or /uel: <YYYY/MM/DD>or /uel:0 |
(L'utente esclude in base all'ultimo accesso) Esegue la migrazione solo degli utenti che hanno eseguito l'accesso al computer di origine entro il periodo di tempo specificato, in base alla data ultima modifica del file Ntuser.dat nel computer di origine. L'opzione /uel funge da regola di inclusione. Ad esempio, l'opzione esegue la /uel:30 migrazione degli utenti che hanno eseguito l'accesso o il cui account utente è stato modificato negli ultimi 30 giorni dalla data di esecuzione del ScanState.exe comando. È possibile specificare il numero di giorni o specificare una data. Questa opzione non può essere usata con l'opzione /all . USMT recupera le ultime informazioni di accesso dal computer locale, quindi non è necessario che il computer sia connesso alla rete quando si esegue questa opzione. Inoltre, se un utente di dominio accede a un altro computer, USMT non considera tale istanza di accesso.
Nota L'opzione /uel non è valida nelle migrazioni offline.Esempi:
Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0 |
|
/ue:DomainName\UserName or /ue"DomainName\User Name" or /ue:ComputerName\LocalUserName |
(Esclusione utente) Esclude gli utenti specificati dalla migrazione. È possibile usare più /ue opzioni, ma l'opzione /ue non può essere usata con l'opzione /all .
DomainName e UserName possono contenere il carattere jolly asterisco (*). Quando viene specificato un nome utente che contiene spazi, deve essere racchiuso tra virgolette (").Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1Per altri esempi, vedere le descrizioni delle /uelopzioni , /uee /ui in questa tabella. |
|
/md:OldDomain:NewDomain or /md:LocalComputerName:NewDomain |
(Sposta dominio) Specifica un nuovo dominio per l'utente. Usare questa opzione per modificare il dominio per gli utenti in un computer o per eseguire la migrazione di un utente locale a un account di dominio. OldDomain potrebbe contenere l'asterisco () carattere jolly. Questa opzione può essere specificata più volte. Se si consolidano gli utenti in più domini in un singolo dominio, potrebbe essere necessario specificare più /md opzioni. Ad esempio, per consolidare gli utenti dai domini Corporate e FarNorth nel dominio Fabrikam, specificare le impostazioni seguenti: /md:corporate:fabrikam e /md:farnorth:fabrikam.In caso di conflitti tra due /md comandi, viene applicata la prima regola specificata. Ad esempio, se vengono specificati i /md:corporate:fabrikam comandi e /md:corporate:farnorth , verrà eseguito il mapping degli utenti aziendali al dominio Fabrikam.
Nota Se viene specificato un dominio che non esiste nel computer di origine, il LoadState.exe comando sembra essere completato correttamente, senza un errore o un avviso. In questo caso, tuttavia, gli utenti non vengono spostati in NewDomain , ma rimangono nel dominio originale. Ad esempio, se contoso è scritto in modo errato e invece viene specificato /md:contso:fabrikam , gli utenti rimangono in contoso nel computer di destinazione.Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /md:contoso:fabrikam |
|
/mu:OldDomain OldUserName:[NewDomain]NewUserName or /mu:OldLocalUserName:NewDomain NewUserName |
(Sposta utente) Specifica un nuovo nome utente per l'utente specificato. Se l'archivio contiene più di un utente, è possibile specificare più /mu opzioni. Non è possibile usare caratteri jolly con questa opzione.Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1 |
| /lac:[Password] |
(Creazione dell'account locale) Se un account utente è:
/lae .Se l'opzione /lac non è specificata, gli account utente locali che non esistono già nel computer di destinazione non vengono migrati.Password è la password per l'account appena creato. Per impostazione predefinita viene usata una password vuota.
Attenzione Usare la variabile Password con cautela. La variabile Password viene fornita in testo normale e chiunque abbia accesso al computer che esegue il LoadState.exe comando può ottenere la password.Inoltre, se il computer ha più utenti, tutti gli utenti migrati hanno la stessa password. Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystorePer istruzioni, vedere Eseguire la migrazione degli account utente. |
/lae |
(Abilitazione dell'account locale) Abilita l'account creato con l'opzione /lac . L'opzione /lac deve essere specificata con questa opzione.Ad esempio: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /lac:password /laePer istruzioni, vedere Eseguire la migrazione degli account utente. |
Esempi per le opzioni /ui e /ue
Gli esempi seguenti si applicano sia alle opzioni /ui che /ue . L'opzione /ue può essere sostituita con l'opzione /ui per includere, anziché escludere, gli utenti specificati.
| Comportamento | Comando |
|---|---|
| Escludere l'utente denominato Utente 1 nel dominio aziendale. | /ue:"corporate\user one" |
| Escludere l'utente denominato User1 nel dominio aziendale. | /ue:corporate\user1 |
| Escludere l'utente locale denominato User1. | /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 User1, User2 e così via. | /ue:\user |
Uso delle opzioni insieme
Le /uelopzioni e /ui/ue possono essere usate insieme per eseguire la migrazione solo degli utenti di cui è necessario eseguire la migrazione.
L'opzione /ui ha la precedenza sulle opzioni /ue e /uel. Se un utente viene incluso usando l'opzione /ui ed è escluso usando le /ue opzioni o /uel , l'utente viene incluso nella migrazione. Ad esempio, se /ui:contoso\* /ue:contoso\user1 viene specificato, viene eseguita la migrazione di User1, 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 entro il periodo di tempo specificato impostato dall'opzione , viene eseguita la /uel migrazione del profilo dell'utente anche se sono esclusi usando l'opzione /ue . Ad esempio, se /ue:contoso\user1 /uel:14 viene specificato, viene eseguita la migrazione di User1 se è stato eseguito l'accesso al computer negli ultimi 14 giorni.
| Comportamento | Comando |
|---|---|
| Includere solo User2 dal dominio Fabrikam ed escludere tutti gli altri utenti. | /ue:* /ui:fabrikam\user2 |
| Includere solo l'utente locale denominato User1 ed escludere tutti gli altri utenti. | /ue:* /ui:user1 |
| Includere solo gli utenti di dominio di Contoso, ad eccezione di Contoso\User1. | Questo comportamento non può essere completato usando un singolo comando. Per eseguire la migrazione di questo set di utenti, specificare invece le opzioni seguenti:
|
| Includere solo utenti locali (non di dominio). | /ue: /ui:%computername%* |
Opzioni della riga di comando incompatibili
La tabella seguente indica quali opzioni della riga di comando non sono compatibili con il LoadState.exe comando. Se la voce di tabella per una combinazione specifica ha , ✅le opzioni sono compatibili e possono essere usate insieme. Il ❌ simbolo indica che le opzioni non sono compatibili. Ad esempio, l'opzione /nocompress non può essere usata con l'opzione /encrypt .
| Opzione Command-Line | /keyfile | /nocompress | /genconfig | /tutto |
|---|---|---|---|---|
| /io | ✅ | ✅ | ✅ | ✅ |
| /v | ✅ | ✅ | ✅ | ✅ |
| /nocompress | ✅ | N/D | ❌ | ✅ |
| /chiave | ❌ | ✅ | ❌ | ✅ |
| /decriptare | Obbligatorio* | ❌ | ❌ | ✅ |
| /keyfile | N/D | ✅ | ❌ | ✅ |
| /l | ✅ | ✅ | ✅ | ✅ |
| /progresso | ✅ | ✅ | ❌ | ✅ |
| /r | ✅ | ✅ | ❌ | ✅ |
| /w | ✅ | ✅ | ❌ | ✅ |
| /c | ✅ | ✅ | ❌ | ✅ |
| /p | ✅ | ✅ | ❌ | N/D |
| /tutto | ✅ | ✅ | ❌ | ✅ |
| /Ui | ✅ | ✅ | ❌ | ❌ |
| /ue | ✅ | ✅ | ❌ | ❌ |
| /uel | ✅ | ✅ | ❌ | ❌ |
| /genconfig | ✅ | ✅ | N/D | ✅ |
| /config | ✅ | ✅ | ❌ | ✅ |
| StorePath | ✅ | ✅ | ✅ | ✅ |
| /Md | ✅ | ✅ | ✅ | ✅ |
| /Mu | ✅ | ✅ | ✅ | ✅ |
| /Lae | ✅ | ✅ | ✅ | ✅ |
| /lacca | ✅ | ✅ | ✅ | ✅ |
Nota
L'opzione /key o /keyfile deve essere specificata con l'opzione /decrypt .