Informazioni sui file di migrazione XML
Puoi modificare il comportamento di una migrazione di Utilità di migrazione stato utente (USMT) 5.0 di base usando file XML che forniscono istruzioni su dove e come gli strumenti di USMT devono raccogliere e applicare file e impostazioni. USMT include tre file XML che puoi usare per personalizzare una migrazione di base: i file MigDocs.xml e MigUser.xml che modificano la modalità di individuazione dei file nel computer di origine e il file MigApps.xml che è necessario per la migrazione delle impostazioni delle applicazioni supportate. Puoi anche creare e modificare file XML personalizzati, nonché un file Config.xml per personalizzare ulteriormente la migrazione.
Questo argomento offre una panoramica dei file di migrazione XML predefiniti e personalizzati e include indicazioni per la creazione e la modifica di una versione personalizzata del file MigDocs.xml. Il file MigDocs.xml usa la nuova funzione GenerateDocPatterns, disponibile in USMT, per trovare automaticamente i documenti utente in un computer di origine.
In questo argomento
Panoramica del file Config.xml
Panoramica del file MigApp.xml
Panoramica del file MigDocs.xml
Panoramica del file MigUser.xml
Usare più file XML
Regole XML per la migrazione dei file utente
Creare e modificare un file XML personalizzato
Funzione GenerateDocPatterns
Informazioni sui contesti utente e di sistema
Esempio di regole di migrazione per versioni personalizzate dei file XML
Esempi di uso delle regole di esclusione
Esempi di uso delle regole di inclusione
Passaggi successivi
Panoramica del file Config.xml
Il file Config.xml è il file di configurazione creato dall'opzione /genconfig dello strumento ScanState e può essere usato per modificare i componenti del sistema operativo di cui USMT esegue la migrazione. Il file Config.xml può essere usato insieme ad altri file XML, come nell'esempio seguente: scanstate /i:migapps.xml /i:migdocs.xml /genconfig:c:\myFolder\config.xml. Quando usato in questo modo, il file Config.xml controlla rigidamente gli aspetti della migrazione, inclusi dati, impostazioni e profili utente, senza modificare o creare altri file XML. Per altre informazioni sul file Config.xml, vedi Personalizzare i file XML di USMT e File Config.xml.
Nota
Quando modifichi gli elementi XML nel file Config.xml, devi modificare un elemento e impostare la proprietà migrate su no, piuttosto che eliminare l'elemento dal file. Se elimini l'elemento invece che impostare la proprietà, la migrazione del componente potrebbe venire comunque eseguita dalle regole presenti in altri file XML.
Panoramica del file MigApp.xml
Il file MigApp.xml installato con USMT include le istruzioni per la migrazione delle applicazioni elencate in Di quali elementi viene eseguita la migrazione da USMT?. Quando usi gli strumenti ScanState e LoadState, devi includere il file MigApp.xml tramite l'opzione /i per eseguire la migrazione delle impostazioni delle applicazioni. I file MigDocs.xml e MigUser.xml non eseguono la migrazione delle impostazioni delle applicazioni. Puoi creare un file XML personalizzato per includere ulteriori applicazioni. Per altre informazioni, vedi Personalizzare i file XML di USMT.
Importante
Il file MigApps.xml rileva ed esegue la migrazione solo dei file PST collegati a Microsoft® Office Outlook®. Per altre informazioni sulla migrazione dei file PST non collegati ad Outlook, vedi la sezione Esempio di regole di migrazione per versioni personalizzate dei file XML di questo documento.
Panoramica del file MigDocs.xml
Il file MigDocs.xml usa la nuova funzione helper GenerateDocPatterns per creare istruzioni per USMT relative alla migrazione dei file dal computer di origine, in base alla posizione dei file. Puoi usare il file MigDocs.xml con gli strumenti ScanState e LoadState per eseguire una migrazione più mirata rispetto all'uso di USMT senza istruzioni XML.
Il file MigDocs.xml predefinito esegue la migrazione di quanto segue:
Tutti i file nella radice dell'unità, ad eccezione di %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% o %USERS%.
Tutte le cartelle nella directory radice di tutte le unità fisse. Ad esempio: c:\data_mail\*[*]
Tutti i file nella radice della cartella dei profili, ad eccezione dei file nel profilo di sistema. Ad esempio: c:\utenti\nome[mail.pst]
Tutte le cartelle nella radice della cartella dei profili, ad eccezione delle cartelle del profilo di sistema. Ad esempio: c:\utenti\nome\nuova cartella\*[*]
Cartelle condivise standard:
CSIDL_COMMON_DESKTOPDIRECTORY
CSIDL_COMMON_FAVORITES
CSIDL_COMMON_DOCUMENTS
CSIDL_COMMON_MUSIC
CSIDL_COMMON_PICTURES
CSIDL_COMMON_VIDEO
FOLDERID_PublicDownloads
Cartelle del profilo utente standard per ogni utente:
CSIDL_MYDOCUMENTS
CSIDL_MYPICTURES
FOLDERID_OriginalImages
CSIDL_MYMUSIC
CSIDL_MYVIDEO
CSIDL_FAVORITES
CSIDL_DESKTOP
CSIDL_QUICKLAUNCH
FOLDERID_Contacts
FOLDERID_Libraries
FOLDERID_Downloads
FOLDERID_SavedGames
FOLDERID_RecordedTV
Il file MigDocs.xml predefinito non esegue la migrazione di quanto segue:
File contrassegnati con gli attributi nascosto e sistema.
File e cartelle in unità rimovibili.
Dati delle cartelle %WINDIR%, %PROGRAMDATA% e %PROGRAMFILES%.
Cartelle contenenti applicazioni installate.
Puoi anche usare l'opzione /genmigxml con lo strumento ScanState per rivedere e modificare i file di cui verrà eseguita la migrazione. Per altre informazioni, vedi la sezione relativa alla Creare e modificare un file XML personalizzato di questo documento.
Panoramica del file MigUser.xml
Il file MigUser.xml include istruzioni per consentire a USMT di eseguire la migrazione dei file in base alle estensioni dei nomi di file. Puoi usare il file MigUser.xml con gli strumenti ScanState e LoadState per eseguire una migrazione più mirata rispetto all'uso di USMT senza istruzioni XML. Il file MigUser.xml raccoglie tutti i file dalle cartelle dei profili utente standard e tutti i file presenti nel computer con le estensioni specificate.
Il file MigUser.xml predefinito esegue la migrazione di quanto segue:
Tutti i file dalle cartelle dei profili utente standard descritti come:
CSIDL_MYVIDEO
CSIDL_MYMUSIC
CSIDL_DESKTOP
CSIDL_STARTMENU
CSIDL_PERSONAL
CSIDL_MYPICTURES
CSIDL_FAVORITES
CSIDL_QUICK LAUNCH
File con le estensioni seguenti:
qdf, qsd, qel, qph, doc*, dot*, rtf, mcw, wps, scd, wri, wpd, xl*, csv, iqy, dqy, oqy, rqy, wk*, wq1, slk, dif, ppt*, pps*, pot*, sh3, ch3, pre, ppa, txt, pst, one*, vl*, vsd, mpp, or6, accdb, mdb, pub
Il file MigUser.xml predefinito non esegue la migrazione di quanto segue:
File contrassegnati con gli attributi nascosto e sistema.
File e cartelle in unità rimovibili.
Dati delle cartelle %WINDIR%, %PROGRAMFILES%, e %PROGRAMDATA%.
Elenchi di controllo di accesso (ACL) per file in cartelle esterne al profilo utente.
Puoi creare una copia del file MigUser.xml e modificarla per includere o escludere le estensioni di file e le cartelle dei profili utente standard. Se conosci tutte le estensioni dei file di cui vuoi eseguire la migrazione dal computer di origine, usa il file MigUser.xml per spostare tutti i dati rilevanti, indipendentemente dalla posizione dei file. Questa operazione potrebbe però comportare una migrazione contenente più file del previsto. Se ad esempio scegli di eseguire la migrazione di tutti i file con estensione jpg, potrebbero venire inclusi file di immagine come anteprime e logo di applicazioni legacy installate nel computer di origine.
Nota
Ogni estensione di file che includi nelle regole nel file MigUser.xml comporta un aumento del tempo necessario allo strumento ScanState per raccogliere i file per la migrazione. Se esegui la migrazione di più di trecento tipi di file, il processo potrebbe essere lento. Per altre informazioni su come organizzare la migrazione dei dati, vedi la sezione Usare più file XML in questo documento.
Usare più file XML
Con gli strumenti ScanState e LoadState puoi usare più file XML. Ogni file XML predefinito incluso in o generato da USMT è configurato per un componente specifico della migrazione. Puoi usare anche file XML personalizzati per integrare questi file predefiniti con regole di migrazione aggiuntive.
| File di migrazione XML | Modifica i componenti seguenti: |
|---|---|
File Config.xml |
Componenti del sistema operativo, come sfondo del desktop e tema dello sfondo. Puoi anche eseguire l'overload del file config.xml per includere alcune impostazioni di applicazioni e documenti generando il file config.xml con gli altri file XML predefiniti. Per altre informazioni, vedi Personalizzare i file XML di USMT e File Config.xml. |
File MigApps.xml |
Impostazioni delle applicazioni. |
File MigUser.xml o MigDocs.xml |
Impostazioni dei profili e file utente. |
File XML personalizzati |
Impostazioni delle applicazioni, impostazioni dei profili utente o file utente, oltre alle regole incluse in altri file XML. |
Puoi ad esempio usare tutti i tipi di file di migrazione XML per una singola migrazione, come nell'esempio seguente:
Scanstate <store> /config:c:\myFolder\config.xml /i:migapps.xml /i:migdocs.xml /i:customrules.xml
Regole XML per la migrazione dei file utente
Importante
Non usare i file MigUser.xml e MigDocs.xml insieme nello stesso comando. Se usi entrambi i file, alcuni file migrati potrebbero venire duplicati. Questo si verifica quando in ogni file XML sono presenti istruzioni sulla posizione di destinazione in conflitto. Il file di destinazione verrà archiviato una volta durante la migrazione, ma verrà applicato da ogni file XML in una posizione diversa nel computer di destinazione.
Se il set di dati è sconosciuto o se molti file sono archiviati al di fuori delle cartelle dei profili utente standard, il file MigDocs.xml è una soluzione migliore rispetto al file MigUser.xml, perché raccoglierà un ambito dei dati più ampio. Il file MigDocs.xml esegue la migrazione delle cartelle di dati in base alla posizione. Il file MigUser.xml esegue la migrazione solo dei file con le estensioni specificate.
Se vuoi avere un controllo maggiore sulla migrazione, puoi creare file XML personalizzati. Vedi la sezione Creare e modificare un file XML personalizzato di questo documento.
Creare e modificare un file XML personalizzato
Puoi usare l'opzione della riga di comando /genmigxml per determinare quali file verranno inclusi nella migrazione. L'opzione /genmigxml crea un file in una posizione specificata, quindi puoi rivedere le regole XML e apportare le modifiche necessarie.
Nota
Se reinstalli USMT, i file di migrazione XML predefiniti verranno sovrascritti e le personalizzazioni apportate direttamente a questi file andranno perse. Ti consigliamo di creare file XML separati per le regole di migrazione personalizzate e di salvare questi file in una posizione sicura.
Per generare il file delle regole di migrazione XML per un computer di origine:
Fai clic sul pulsante Start, scegli Tutti i programmi, Accessori, fai clic con il pulsante destro del mouse su Prompt dei comandi e quindi scegli Esegui come amministratore.
Seleziona un account con privilegi di amministratore, specifica la password e quindi fai clic su OK.
Al prompt dei comandi digita:
cd /d <percorsoUSMT> scanstate.exe /genmigxml: <percorsofile.xml>Dove <percorsoUSMT> è il percorso nel computer di origine in cui hai salvato i file e gli strumenti di USMT e <percorsofile.xml> è il percorso completo di un file in cui salvare il rapporto. Digita ad esempio:
cd /d c:\USMT scanstate.exe /genmigxml:"C:\Documents and Settings\USMT Tester\Desktop\genMig.xml"
Funzione GenerateDocPatterns
Il file MigDocs.xml chiama la funzione GenerateDocPatterns, che accetta tre valori booleani. Puoi cambiare le impostazioni per modificare il modo in cui il file MigDocs.xml genera le regole XML per la migrazione.
| Impostazione | Valore | Valore predefinito |
|---|---|---|
ScanProgramFiles |
L'argomento ScanProgramFiles è valido solo quando la funzione GenerateDocPatterns viene chiamata in un contesto di sistema. Questo argomento determina se è o meno necessario analizzare la directory Programmi per raccogliere le estensioni di file registrate per le applicazioni note. Quando l'impostazione è TRUE, ad esempio, la funzione rileva tutti i file con estensione doc presenti nella directory Microsoft Office e ne esegue la migrazione perché doc è un'estensione di file registrata di un'applicazione di Microsoft Office. La funzione GenerateDocPatterns genera questo pattern di inclusione per i file con estensione doc: Se una cartella figlio di una cartella inclusa contiene un'applicazione installata, ScanProgramFiles crea anche una regola di esclusione per la cartella figlio. Tutte le cartelle incluse nella cartella dell'applicazione saranno analizzate in modo ricorsivo per cercare estensioni di file registrate. |
False |
IncludePatterns |
L'argomento IncludePatterns determina se generare pattern di esclusione o di inclusione nel codice XML. Quando questo argomento è impostato su TRUE, la funzione GenerateDocPatterns genera pattern di inclusione e deve essere aggiunta nell'elemento <include>. Se questo argomento viene impostato su FALSE, vengono generati pattern di esclusione e la funzione deve essere aggiunta nell'elemento <exclude>. |
True |
SystemDrive |
L'argomento SystemDrive determina se generare pattern per tutte le unità fisse o solo per l'unità di sistema. Se questo argomento viene impostato su TRUE, limita tutti i pattern all'unità di sistema. |
False |
Uso:
MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")
Per creare pattern di dati di inclusione solo per l'unità di sistema:
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>
</objectSet>
</include>
Per creare una regola di inclusione per raccogliere file per le estensioni registrate dalla directory %PROGRAMFILES%:
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
</objectSet>
</include>
Per creare pattern di dati di esclusione:
<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
</objectSet>
</exclude>
Informazioni sui contesti utente e di sistema
I file XML di migrazione contengono due elementi <component> con impostazioni di contesto diverse. Il contesto di sistema si applica ai file nel computer che non sono archiviati nella directory dei profili utente, mentre il contesto utente si applica ai file specifici di un determinato utente.
Contesto di sistema
Il contesto di sistema include regole per i dati al di fuori della directory dei profili utente. Quando ad esempio viene chiamata in un contesto di sistema nel file MigDocs.xml, la funzione GenerateDocPatterns crea pattern per tutti i file nella directory radice dei dischi rigidi, le cartelle nella radice dei dischi rigidi e le cartelle shell comuni. Sono incluse le cartelle seguenti:
CSIDL_COMMON_DESKTOPDIRECTORY
CSIDL_COMMON_FAVORITES
CSIDL_COMMON_DOCUMENTS
CSIDL_COMMON_MUSIC
CSIDL_COMMON_PICTURES
CSIDL_COMMON_VIDEO
FOLDERID_PublicDownloads
Contesto utente
Il contesto utente include regole per i dati nella directory dei profili utente. Quando viene chiamata in un contesto utente nel file MigDocs.xml, la funzione GenerateDocPatterns crea pattern per tutti i file nella directory radice del profilo, le cartelle nella radice del profilo e le cartelle shell degli utenti. Sono incluse le cartelle seguenti:
CSIDL_MYDOCUMENTS
CSIDL_MYPICTURES
FOLDERID_OriginalImages
CSIDL_MYMUSIC
CSIDL_MYVIDEO
CSIDL_FAVORITES
CSIDL_DESKTOP
CSIDL_QUICKLAUNCH
FOLDERID_Contacts
FOLDERID_Libraries
FOLDERID_Downloads
FOLDERID_SavedGames
FOLDERID_RecordedTV
Nota
Le regole contenute in un componente assegnato al contesto utente vengono eseguite per ogni profilo utente nel computer. I file analizzati più volte dai file MigDocs.xml vengono copiati nell'archivio delle migrazioni una sola volta, tuttavia se sono presenti troppe regole nel contesto utente, la migrazione può venire rallentata. Quando possibile, usa il contesto di sistema.
Esempio di regole di migrazione per versioni personalizzate dei file XML
Nota
Per le procedure consigliate e i requisiti per i file XML personalizzati in USMT, vedi gli argomenti Personalizzare i file XML di USMT e Convenzioni generali.
Esempi di uso delle regole di esclusione
Negli esempi seguenti il computer di origine include un file con estensione txt personalizzato denominato "new text document" in una directory denominata "new folder". Il comportamento predefinito di MigDocs.xml prevede la migrazione del file "new text document.txt" e di tutti i file inclusi nella cartella "new folder". Le regole generate dalla funzione sono:
Regola 1 |
|
Regola 2 |
|
Per escludere il file "new text document.txt" e tutti i file con estensione txt presenti in "new folder", ecco come fare:
Esempio 1: Escludere tutti i file con estensione txt in una cartella
Per escludere la regola 1, deve esserci una corrispondenza esatta del nome file. Per la regola 2 puoi tuttavia creare un pattern per escludere i file usando l'estensione di file.
<exclude>
<objectSet>
<pattern type="File">D:\Newfolder\[new text document.txt]</pattern>
<pattern type="File">D:\New folder\*[*.txt]</pattern>
</objectSet>
</exclude>
Esempio 2: Usare l'elemento UnconditionalExclude per assegnare un ordine di precedenza alle regole di inclusione
Se non conosci il nome o la posizione del file ma conosci l'estensione di file, puoi usare la funzione GenerateDrivePatterns. La regola sarà tuttavia meno specifica della regola di inclusione predefinita generata dal file MigDocs.xml, quindi non avrà la precedenza. Per assegnare a questa regola la precedenza rispetto alla regola di inclusione predefinita, devi usare l'elemento <UnconditionalExclude>. Per altre informazioni sull'ordine di precedenza per le regole di migrazione XML, vedi Conflitti e precedenza.
<unconditionalExclude>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
</objectSet>
</unconditionalExclude>
Esempio 3: Usare il componente di contesto UserandSystem per eseguire le regole in entrambi i contesti
Se vuoi che l'elemento <UnconditionalExclude> si applichi sia al contesto utente che di sistema, puoi creare un terzo componente usando il contesto UserandSystem. Le regole in questo componente verranno eseguite in entrambi i contesti.
<component type="Documents" context="UserandSystem">
<displayName>MigDocExcludes</displayName>
<role role="Data">
<rules>
<unconditionalExclude>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
</objectSet>
</unconditionalExclude>
</rules>
</role>
</component>
Per altri esempi di regole di esclusione che puoi usare nei file di migrazione XML personalizzati, vedi Escludere file e impostazioni.
Esempi di uso delle regole di inclusione
La directory dei dati delle applicazioni rappresenta la posizione più comune per la quale è necessario aggiungere una regola di inclusione. La funzione GenerateDocPatterns esclude questa posizione per impostazione predefinita. Se la tua società usa un'applicazione che salva i dati importanti in questa posizione, puoi creare regole di inclusione per la migrazione dei dati. La posizione predefinita per i file PST è ad esempio: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Il file Migapp.xml contiene le regole di migrazione per lo spostamento solo dei file PST collegati a Microsoft Outlook. Per includere i file PST non collegati, ecco come fare:
Esempio 1: Includere un'estensione di file in una cartella utente nota
Questa regola include i file PST che si trovano nella posizione predefinita ma non sono collegati a Microsoft Outlook. Usa il contesto utente per eseguire questa regola per ogni utente del computer.
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>
</objectSet>
</include>
Esempio 2: Includere un'estensione di file in Programmi
Per le posizioni esterne al profilo utente, ad esempio la cartella Programmi, puoi aggiungere la regola al componente del contesto di sistema.
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
</objectSet>
</include>
Per altri esempi di regole di inclusione che puoi usare nei file di migrazione XML personalizzati, vedi Includere file e impostazioni.
Nota
Per altre informazioni sull'ordine di precedenza per le regole di migrazione XML, vedi Conflitti e precedenza.
Passaggi successivi
Puoi includere regole aggiuntive per la migrazione nel file MigDocs.xml o altri file di migrazione XML. Puoi ad esempio usare l'elemento <locationModify> per spostare i file dalla cartella in cui sono stati raccolti a una cartella diversa, dove vengono applicati al computer di destinazione. Per altre informazioni, vedi la Riferimento XML per USMT.
Puoi usare uno schema XML (MigXML.xsd) per convalidare la sintassi dei file XML personalizzati. Per altre informazioni, vedi Risorse per Utilità di migrazione stato utente (USMT).