Informazioni sui file XML di migrazione

Il comportamento di una migrazione USMT (User State Migration Tool) di base può essere modificato usando file XML. Questi file forniscono istruzioni su dove e come gli strumenti USMT devono raccogliere e applicare file e impostazioni. USMT include tre file XML che possono essere usati per personalizzare una migrazione di base: i file eMigUser.xml, che modificano la MigDocs.xml modalità di individuazione dei file nel computer di origine, e il file MigApps.xml, necessario per eseguire la migrazione delle impostazioni dell'applicazione supportate. I file XML personalizzati e un Config.xml file possono essere creati e modificati per personalizzare ulteriormente la migrazione.

Questo articolo offre una panoramica dei file XML di migrazione predefiniti e personalizzati e include linee guida per la creazione e la modifica di una versione personalizzata del MigDocs.xml file. Il MigDocs.xml file usa la nuova GenerateDocPatterns funzione disponibile in USMT per trovare automaticamente i documenti utente in un computer di origine.

Panoramica del file Config.xml

Il Config.xml file è il file di configurazione creato dall'opzione /genconfig dello strumento ScanState . Può essere usato per modificare i componenti del sistema operativo di cui viene eseguita la migrazione da USMT. Il Config.xml file può essere usato con altri file XML, ad esempio nell'esempio seguente:

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

Se usato in questo modo, il Config.xml file controlla strettamente gli aspetti della migrazione, inclusi profili utente, dati e impostazioni, senza modificare o creare altri file XML. Per altre informazioni sul Config.xml file, vedere Personalizzare file XML USMT e fileConfig.xml.

Panoramica del file MigApp.xml

Il MigApp.xml file installato con USMT include istruzioni per eseguire la migrazione delle impostazioni per le applicazioni elencate in What Does USMT Migrate?. Per eseguire la migrazione delle impostazioni dell'applicazione, è necessario includere il MigApp.xml file quando si usano gli strumenti ScanState e LoadState usando l'opzione /i . I MigDocs.xml file e MigUser.xml non esedono le impostazioni dell'applicazione. È possibile creare un file XML personalizzato per includere applicazioni aggiuntive. Per altre informazioni, vedere Personalizzare file XML USMT.

Panoramica del file MigDocs.xml

Il MigDocs.xml file usa la nuova GenerateDocPatterns funzione helper per creare istruzioni per USMT per la migrazione dei file dal computer di origine, in base al percorso dei file. Il MigDocs.xml file può essere usato con gli strumenti ScanState e LoadState per eseguire una migrazione più mirata rispetto all'uso di USMT senza istruzioni XML.

Il file predefinito MigDocs.xml esegue la migrazione dei dati seguenti:

• Tutti i file nella radice dell'unità tranne %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA%o %USERS%.

• Tutte le cartelle nella directory radice di tutte le unità fisse. Ad esempio: c:\data_mail\*[*].

• Tutti i file dalla radice della cartella Profiles, ad eccezione dei file nel profilo di sistema. Ad esempio: c:\users\name[mail.pst].

• Tutte le cartelle dalla radice della cartella Profiles, ad eccezione delle cartelle del profilo di sistema. Ad esempio: c:\users\name\new folder\*[*].

• Standard cartelle condivise:

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

• Standard cartelle del profilo utente 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 predefinito MigDocs.xml non esegue la migrazione dei dati seguenti:

• File contrassegnati con attributi nascosti e di sistema .

• File e cartelle in unità rimovibili.

• Dati delle cartelle %WINDIR%, %PROGRAMDATA% e %PROGRAMFILES%.

• Cartelle che contengono applicazioni installate.

L'opzione /genmigxml può essere usata con lo strumento ScanState per esaminare e modificare i file di cui viene eseguita la migrazione.

Panoramica del file MigUser.xml

Il MigUser.xml file include istruzioni per la migrazione dei file utente da parte di USMT in base alle estensioni del nome file. Il MigUser.xml file può essere usato con gli strumenti ScanState e LoadState per eseguire una migrazione più mirata rispetto all'uso di USMT senza istruzioni XML. Il MigUser.xml file raccoglie tutti i file dalle cartelle del profilo utente standard e tutti i file nel computer con le estensioni del nome file specificate.

Il file predefinito MigUser.xml esegue la migrazione dei dati seguenti:

• Tutti i file delle cartelle del profilo 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:

  .accdb, .ch3, .csv, .dif, .doc*, .dot*, .dqy, .iqy, .mcw, .mdb*, .mpp, .one*, .oqy, .or6, .pot*, .ppa, .pps*, .ppt*, .pre, .pst, .pub, .qdf, .qel, .qph, .qsd, .rqy, .rtf, .scd, .sh3, .slk, .txt, .vl*, .vsd, .wk*, .wpd, .wps, .wq1, .wri, .xl*, .xla, .xlb, .xls*

  Nota

  L'asterisco (*) indica zero o più caratteri.

  Nota

  Le estensioni OpenDocument (*.odt, *.odp, *.ods) che le applicazioni di Microsoft Office possono usare non vengono migrate per impostazione predefinita.

Il file predefinito MigUser.xml non esegue la migrazione dei dati seguenti:

• File contrassegnati con gli attributi Hidden e System .

• File e cartelle in unità rimovibili.

• Dati delle %WINDIR%cartelle , %PROGRAMFILES%, %PROGRAMDATA% .

• ACLS per i file in cartelle esterne al profilo utente.

Il MigUser.xml file può essere copiato e quindi la copia modificata per includere o escludere le cartelle del profilo utente standard e le estensioni del nome file. Se tutte le estensioni per i file di cui è necessario eseguire la migrazione dal computer di origine sono note, usare il MigUser.xml file per spostare tutti i dati pertinenti, indipendentemente dal percorso dei file. Tuttavia, l'aggiunta di tutte le estensioni di file di cui è necessario eseguire la migrazione al MigUser.xml file può comportare una migrazione che contiene più file del previsto. Ad esempio, se viene eseguita la migrazione di tutti i file .jpg , può anche eseguire la migrazione di file di immagine, ad esempio anteprime e logo da applicazioni legacy installate nel computer di origine.

Uso di più file XML

È possibile usare più file XML con gli strumenti ScanState e LoadState . Ognuno dei file XML predefiniti inclusi in o generati da USMT è configurato per un componente specifico della migrazione. I file XML personalizzati possono essere usati anche per integrare questi file predefiniti con altre regole di migrazione.

Ad esempio, tutti i tipi di file di migrazione XML possono essere usati per una singola migrazione, come nell'esempio seguente:

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

Regole XML per la migrazione di file utente

Se il set di dati è sconosciuto o se molti file sono archiviati al di fuori delle cartelle del profilo utente standard, MigDocs.xml è una scelta migliore rispetto al MigUser.xml file, perché il MigDocs.xml file raccoglie un ambito più ampio di dati. Il MigDocs.xml file esegue la migrazione di cartelle di dati in base alla posizione. Il MigUser.xml file esegue la migrazione solo dei file con le estensioni del nome file specificate.

Per un maggiore controllo sulla migrazione, creare file XML personalizzati. Per altre informazioni sulla creazione di file XML personalizzati, vedere Creazione e modifica di un file XML personalizzato.

Creazione e modifica di un file XML personalizzato

L'opzione /genmigxml della riga di comando può essere usata per determinare quali file sono inclusi nella migrazione. L'opzione /genmigxml crea un file in un percorso specificato. Le regole XML nel file possono quindi essere esaminate e, se necessario, apportate modifiche.

Per generare il file delle regole di migrazione XML per un computer di origine:

1. Selezionare Avvia>tutti i programmi>accessori

2. Fare clic con il pulsante destro del mouse su Prompt dei comandi e quindi scegliere Esegui con nome.

3. Selezionare un account con privilegi di amministratore, specificare una password e quindi selezionare OK.

4. Al prompt dei comandi immettere:

   cd /d <USMTpath>
   ScanState.exe /genmigxml: <filepath.xml>
   

   dove:

   • <USMTpath> : posizione nel computer di origine dei file e degli strumenti USMT salvati.
   • < >filepath.xml: percorso completo di un file in cui è possibile salvare il report.

   Ad esempio, immettere:

   cd /d c:\USMT
   ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"
   

Funzione GenerateDocPatterns

Il MigDocs.xml file chiama la GenerateDocPatterns funzione , che accetta tre valori booleani. Le impostazioni possono essere modificate per modificare il modo in cui il MigDocs.xml file genera le regole XML per la migrazione.

• ScanProgramFiles: questo argomento è valido solo quando la GenerateDocPatterns funzione viene chiamata in un contesto di sistema. Questo argomento determina se eseguire o meno l'analisi della directory Programmi per raccogliere le estensioni di file registrate per le applicazioni note.

  Valore predefinito: False

  Ad esempio, se impostata su TRUE, la funzione individua ed esegue la migrazione dei file.doc nella directory di Microsoft Office, perché .doc è un'estensione di file registrata in un'applicazione di Microsoft Office. La GenerateDocPatterns funzione genera questo modello di inclusione per i .doc file:

  <pattern type="File">C:\Program Files\Microsoft Office[.doc]</pattern>

  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 nella cartella dell'applicazione vengono analizzate in modo ricorsivo per le estensioni del nome file registrate.

• IncludePatterns: questo argomento determina se generare modelli di esclusione o inclusione nel codice XML. Quando questo argomento è impostato su TRUE, la GenerateDocPatterns funzione genera modelli di inclusione e la funzione deve essere aggiunta sotto l'elemento <include> . La modifica di questo argomento su FALSE genera modelli di esclusione e la funzione deve essere aggiunta sotto l'elemento <exclude> .

  Valore predefinito: True

• SystemDrive: questo argomento determina se generare modelli per tutte le unità fisse o solo per l'unità di sistema. La modifica di questo argomento su TRUE limita tutti i modelli all'unità di sistema.

  Valore predefinito: False

Uso:

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

Per creare modelli 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 i file per le estensioni registrate dalla directory %PROGRAMFILES%:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
     </objectSet>
</include>

Per creare modelli di dati di esclusione:

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
     </objectSet>
</exclude>

Informazioni sul contesto di sistema e utente

I file XML di migrazione contengono due <elementi componente> con impostazioni di contesto diverse:

• Il contesto di sistema si applica ai file nel computer che non sono archiviati nella directory Profili utente.
• Il contesto utente si applica ai file specifici di un singolo utente.

Contesto di sistema

Il contesto di sistema include regole per i dati all'esterno della directory Profili utente. Ad esempio, quando viene chiamato in un contesto di sistema nel MigDocs.xml file, la GenerateDocPatterns funzione crea modelli per tutte le cartelle della shell comuni, i file nella directory radice dei dischi rigidi e le cartelle che si trovano nella radice dei dischi rigidi. 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 Profili utente. Quando viene chiamato in un contesto utente nel MigDocs.xml file, la GenerateDocPatterns funzione crea modelli per tutte le cartelle della shell utente, i file che si trovano nella radice del profilo e le cartelle che si trovano nella radice del profilo. 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

Regole di migrazione di esempio per versioni personalizzate di file XML

Escludere gli esempi di utilizzo delle regole

Negli esempi seguenti il computer di origine ha un file .txt chiamato new text document in una directory denominata new folder. Il comportamento predefinito MigDocs.xml esegue la migrazione del nuovo file di testo document.txt e di tutti i file contenuti nella new folder directory. Le regole generate dalla funzione sono:

Per escludere il nuovo file di testo document.txt e tutti i file.txt in new folder, è possibile apportare le modifiche seguenti:

Esempio 1: Escludere tutti i file .txt in una cartella

Per escludere la regola 1, deve essere presente una corrispondenza esatta del nome del file. Tuttavia, per la regola 2, è possibile creare un modello per escludere i file usando l'estensione del nome 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 la precedenza a una regola rispetto alle regole di inclusione

Se il nome o il percorso del file non è noto, ma l'estensione del nome file è nota, è possibile usare la GenerateDrivePatterns funzione . Tuttavia, la regola è meno specifica della regola di inclusione predefinita generata dal MigDocs.xml file, quindi non ha la precedenza. L'elemento <UnconditionalExclude> deve essere usato per assegnare la precedenza a questa regola rispetto alla regola di inclusione predefinita. Per altre informazioni sull'ordine di precedenza per le regole di migrazione XML, vedere Conflitti e precedenza.

<unconditionalExclude>
     <objectSet>
        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
     </objectSet>
</unconditionalExclude>

Esempio 3: Usare un componente di contesto UserandSystem per eseguire regole in entrambi i contesti

Per applicare l'elemento <UnconditionalExclude> sia al contesto di sistema che a quello utente, è possibile creare un terzo componente usando il contesto UserandSystem . Le regole in questo componente vengono 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 possono essere usate nei file XML di migrazione personalizzati, vedere Escludere file e impostazioni.

Includere esempi di utilizzo delle regole

La directory dei dati dell'applicazione è il percorso più comune per cui deve essere aggiunta una regola di inclusione. La GenerateDocPatterns funzione esclude questa posizione per impostazione predefinita. Se l'organizzazione usa un'applicazione che salva i dati importanti in questo percorso, è possibile creare regole di inclusione per eseguire la migrazione dei dati. Ad esempio, il percorso predefinito per i file pst è: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Il MigApp.xml file contiene regole di migrazione per spostare solo i file pst collegati a Microsoft Outlook. Per includere file pst non collegati, è possibile apportare le modifiche seguenti:

Esempio 1: Includere un'estensione del nome file in una cartella utente nota

Questa regola include file pst che si trovano nel percorso predefinito, ma non sono collegati a Microsoft Outlook. Usare il contesto utente per eseguire questa regola per ogni utente nel computer.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>
     </objectSet>
</include>

Esempio 2: Includere un'estensione del nome file in Programmi

Per le posizioni esterne al profilo utente, ad esempio la cartella Programmi, la regola può essere aggiunta 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 possono essere usate nei file XML di migrazione personalizzati, vedere Includi file e impostazioni.

Passaggi successivi

È possibile includere regole aggiuntive per la migrazione nel MigDocs.xml file o in altri file di migrazione XML. Ad esempio, l'elemento <locationModify> può essere usato per spostare i file dalla cartella in cui sono stati raccolti in una cartella diversa, quando vengono applicati al computer di destinazione.

È possibile usare un file xml schema (MigXML.xsd) per convalidare la sintassi dei file XML personalizzati. Per altre informazioni, vedere Risorse USMT.

Articoli correlati

• Escludere file e impostazioni.
• Includere file e impostazioni.