Personalizzare i file XML USMT

Panoramica

Per usare uno qualsiasi dei file .xml di migrazione con gli strumenti ScanState e LoadState , specificare questi file nella riga di comando usando l'opzione /i . Poiché gli strumenti ScanState e LoadState richiedono i file .xml per controllare la migrazione, specificare lo stesso set di file di.xml per entrambi i ScanState.exe comandi e LoadState.exe . Tuttavia, il Config.xml file con l'opzione /config non deve essere specificato, a meno che alcuni dei file e delle impostazioni migrati dall'archivio non debbano essere esclusi. Ad esempio, per eseguire la migrazione della cartella Documenti all'archivio, ma non al computer di destinazione. Per ottenere questo scenario, modificare il Config.xml file e specificare il file aggiornato con il LoadState.exe comando . Il LoadState.exe comando esegue quindi la migrazione solo dei file e delle impostazioni desiderate.

Se un file .xml viene escluso dal LoadState.exe comando , viene eseguita la migrazione di tutti i dati nell'archivio di cui è stata eseguita la migrazione con i file .xml mancanti. Tuttavia, le regole di migrazione specificate con il ScanState.exe comando non si applicano. Ad esempio, se un file .xml viene escluso e contiene una regola di reindirizzamento, ad esempio:

MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")

USMT non reindirizza i file e viene eseguita la migrazione a C:\data.

Per modificare la migrazione, eseguire una o più delle operazioni seguenti.

• Modificare i file di .xml migrazione. Per escludere una parte di un componente, modificare i file di.xml . Ad esempio, per eseguire la migrazione di C:\ ma escludere tutti i file .mp3 o per spostare i dati in un nuovo percorso nel computer di destinazione. Per modificare questi file, è necessario acquisire familiarità con le regole di migrazione e la sintassi. Affinché ScanState e LoadState usino questi file, specificarli nella riga di comando quando viene immesso ogni comando.

• Creare un file di .xml personalizzato. È anche possibile creare un file di.xml personalizzato per eseguire la migrazione delle impostazioni per un'altra applicazione o per modificare il comportamento di migrazione in base alle esigenze dell'organizzazione. Affinché ScanState e LoadState usino questo file, specificarli in entrambe le righe di comando.

• Creare e modificare un file Config.xml. Creare e modificare un Config.xml file per escludere un intero componente dalla migrazione. Ad esempio, un Config.xml file può essere usato per escludere l'intera cartella Documenti o escludere le impostazioni per un'applicazione. L'esclusione dei componenti che usano un Config.xml file è più semplice rispetto alla modifica della migrazione .xml file perché non è necessaria familiarità con le regole di migrazione e la sintassi. Inoltre, l'uso di un Config.xml file è l'unico modo per escludere la migrazione delle impostazioni del sistema operativo.

Per altre informazioni sull'esclusione dei dati, vedere l'articolo Escludere file e impostazioni .

File di .xml di migrazione

Questa sezione descrive la migrazione .xml file inclusi in USMT. Ogni file contiene regole di migrazione che controllano i componenti di cui viene eseguita la migrazione e dove vengono migrati nel computer di destinazione.

• File MigApp.xml. Specificare questo file con i comandi e LoadState.exe per eseguire la ScanState.exe migrazione delle impostazioni dell'applicazione.

• File MigDocs.xml. Specificare questo file con gli strumenti ScanState e LoadState per eseguire la migrazione di tutte le cartelle utente e i file trovati dalla funzione helper MigXmlHelper.GenerateDocPatterns . Questa funzione helper trova i dati utente che si trovano nella radice di qualsiasi unità e nella directory Users. Tuttavia, non trova ed esegue la migrazione di dati dell'applicazione, file di programma o file nella directory di Windows. Il MigDocs.xml file può essere modificato.

• File MigUser.xml. Specificare questo file con i comandi e LoadState.exe per eseguire la ScanState.exe migrazione di cartelle utente, file e tipi di file. Il MigUser.xml file può essere modificato. Questo file non contiene regole per la migrazione di account utente specifici. L'unico modo per specificare gli account utente di cui eseguire la migrazione è nella riga di comando usando le opzioni ScanState User e LoadState User.

File di .xml personalizzati

È possibile creare file .xml personalizzati per personalizzare la migrazione in base alle esigenze specifiche dell'organizzazione. Ad esempio, è possibile creare un file di.xml personalizzato per eseguire la migrazione di un'applicazione line-of-business o per modificare il comportamento di migrazione predefinito. Per ScanState.exe e LoadState.exe per usare questo file, specificarlo con entrambi i comandi. Per altre informazioni, vedere l'articolo Esempi XML personalizzati .

File Config.xml

Il Config.xml file è un file facoltativo creato usando l'opzione /genconfig con il ScanState.exe comando . Questo file deve essere creato e modificato per escludere determinati componenti dalla migrazione. Inoltre, questo file deve essere creato e modificato per escludere la migrazione di una qualsiasi delle impostazioni del sistema operativo. Il Config.xml formato di file è diverso dalla migrazione .xml file perché non contiene regole di migrazione. Contiene solo un elenco dei componenti del sistema operativo, delle applicazioni e dei documenti utente di cui è possibile eseguire la migrazione. Per un esempio, vedere l'articolo Config.xml File . Per questo motivo, l'esclusione dei componenti che usano il Config.xml file è più semplice rispetto alla modifica della migrazione .xml file. Config.xmlCon , la familiarità con le regole di migrazione e la sintassi non lo è. Tuttavia, i caratteri jolly non possono essere usati in un Config.xml file.

Per includere tutti i componenti predefiniti, non è necessario creare un Config.xml file. In alternativa, se il comportamento di migrazione predefinito definito nei MigApp.xmlfile , MigDocs.xmle MigUser.xml è soddisfacente e solo alcuni componenti devono essere esclusi, è possibile creare un Config.xml file. Gli altri file.xml possono essere lasciati nello stato originale.

Quando il ScanState.exe comando viene eseguito con l'opzione /genconfig , ScanState.exe legge gli altri file.xml specificati usando l'opzione /i per creare un elenco personalizzato di componenti di cui è possibile eseguire la migrazione dal computer. Questo file contiene solo i componenti del sistema operativo, le applicazioni e le sezioni del documento utente presenti in entrambi i file .xml e installati nel computer quando il ScanState.exe comando viene eseguito con l'opzione /genconfig . Di conseguenza, questo file deve essere creato in un computer di origine che contiene tutti i componenti, le applicazioni e le impostazioni presenti nei computer di destinazione. La creazione del file nel computer di origine garantisce che questo file contenga ogni componente di cui è possibile eseguire la migrazione. I componenti sono organizzati in sezioni: <Applicazioni>, <WindowsComponents> e <Documenti>. Per scegliere di non eseguire la migrazione di un componente, modificare la voce in migrate="no".

Dopo aver creato questo file, è necessario specificarlo solo con il ScanState.exe comando usando l'opzione /Config per influire sulla migrazione. Tuttavia, se è necessario escludere dati aggiuntivi di cui è stata eseguita la migrazione all'archivio, modificare il Config.xml file e specificare il file aggiornato con il LoadState.exe comando . Ad esempio, se la cartella Documenti viene raccolta nell'archivio, ma non è necessario eseguire la migrazione della cartella Documenti a un computer di destinazione, il Config.xml file può essere modificato per indicare migrate="no" prima dell'esecuzione del LoadState.exe comando e non viene eseguita la migrazione del file. Per altre informazioni sulla precedenza che si verifica quando si escludono i dati, vedere l'articolo Escludere file e impostazioni .

Si noti inoltre la funzionalità seguente con il Config.xml file:

• Se un componente padre viene rimosso dalla migrazione nel Config.xml file specificando migrate="no", tutti i relativi componenti figlio vengono rimossi automaticamente dalla migrazione, anche se il componente figlio è impostato su migrate="yes".

• Se erroneamente esistono due righe di codice per lo stesso componente in cui una riga specifica migrate="no" e l'altra riga specifica migrate="yes", viene eseguita la migrazione del componente.

• In USMT sono disponibili diversi criteri di migrazione che possono essere configurati nel Config.xml file. Ad esempio, è possibile configurare altre <opzioni ErrorControl>, <ProfileControl> e <HardLinkStoreControl> . Per altre informazioni, vedere l'articolo Config.xml File .

Esempi

• Il comando seguente crea un Config.xml file nella directory corrente, ma non crea un archivio:

  ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:5

• Il comando seguente crea un archivio crittografato usando il Config.xml file e la migrazione predefinita .xml file:

  ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:5 /encrypt /key:"mykey"

• Il comando seguente decrittografa l'archivio ed esegue la migrazione dei file e delle impostazioni:

  LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

Altre informazioni

• Per altre informazioni su come modificare i file e le impostazioni di cui viene eseguita la migrazione, vedere gli articoli sulle procedure dello Strumento di migrazione dello stato utente (USMT).
• Per altre informazioni su ogni elemento.xml , vedere l'articolo della libreria di elementi XML .
• Per risposte alle domande comuni, vedere ".xml file" nell'articolo Domande frequenti .

Articoli correlati

• Sintassi della riga di comando di User State Migration Tool (USMT).
• Risorse USMT.