File di log USMT

Articolo
07/04/2024
Si applica a:

✅ Windows 11, ✅ Windows 10

I log di User State Migration Tool (USMT) possono essere usati per monitorare la migrazione e risolvere gli errori e le migrazioni non riuscite. Questo articolo descrive le opzioni della riga di comando disponibili per abilitare i log USMT. Vengono inoltre descritti i nuovi elementi XML che possono essere usati per configurare:

Quali tipi di errori sono irreversibili e devono interrompere la migrazione.
Quali tipi non sono irreversibili e devono essere ignorati in modo che la migrazione possa continuare.

Opzioni della riga di comando log

La tabella seguente descrive ogni opzione della riga di comando correlata ai log e fornisce il nome del log e una descrizione del tipo di informazioni contenute in ogni log.

Opzione della riga di comando	Nome file	Descrizione
/l"[Percorso]NomeFile	`ScanState.exe.log` o `LoadState.log`	Specifica il percorso e il nome del file del log ScanState o del log LoadState .
/progress:[Path]FileName	Specifica il percorso e il nome del file del log di stato.	Fornisce informazioni sullo stato della migrazione, per percentuale di completamento.
/v:[VerbosityLevel]	Non applicabile	Vedere Opzioni di monitoraggio nella sintassi ScanState.
/listfiles:[Path]FileName	Specifica il percorso e il nome file del log Listfiles.	Fornisce un elenco dei file di cui è stata eseguita la migrazione.
Impostare la variabile di ambiente MIG_ENABLE_DIAG su un percorso di un file XML.	`USMTDiag.xml`	Il log di diagnostica contiene informazioni dettagliate sull'ambiente di sistema, informazioni sull'ambiente utente e informazioni sulle unità di migrazione (migunits) raccolte e sul relativo contenuto.

Nota

I file di log non possono essere archiviati in StorePath. Se i file di log vengono archiviati in StorePath, i file di log vengono sovrascritti quando viene eseguito USMT.

Log di ScanState e LoadState

I log ScanState e LoadState sono file di testo creati quando vengono eseguiti gli strumenti ScanState e LoadState . Questi log possono essere usati per monitorare la migrazione. Il contenuto del log dipende dalle opzioni della riga di comando usate e dal livello di dettaglio specificato. Per altre informazioni sui livelli di dettaglio, vedere Opzioni di monitoraggio nella sintassi ScanState.

Log di avanzamento

È possibile creare un log di stato usando l'opzione /progress . Gli strumenti esterni, ad esempio Microsoft System Center Operations Manager, possono analizzare il log di stato per aggiornare i sistemi di monitoraggio. I primi tre campi in ogni riga sono fissi come segue:

Dattero: Data, nel formato del giornoshortNameOfTheMonthyear. Ad esempio: 08 giu 2023.
Ora locale: Ora, nel formato hrs:minutes:seconds (usando un orologio di 24 ore). Ad esempio: 13:49:13.
Tempo di migrazione: Durata dell'esecuzione di USMT nel formato hrs:minutes:seconds. Ad esempio: 00:00:20.

I campi rimanenti sono coppie chiave/valore, come indicato nella tabella seguente.

Chiave	Valore
programma	`ScanState.exe` o `LoadState.exe`.
productVersion	Numero di versione del prodotto completo di USMT.
computerName	Nome del computer di origine o di destinazione in cui è stato eseguito USMT.
commandLine	Comando completo usato per eseguire USMT.
FASE	Segnala che è in fase di avvio una nuova fase della migrazione. Questa chiave può essere uno dei valori seguenti: Inizializzazione Scansione Collezionismo Risparmio Stima Applicazione
detectedUser	Per lo strumento ScanState , questa chiave è gli utenti rilevati da USMT nel computer di origine di cui è possibile eseguire la migrazione. Per lo strumento LoadState , questa chiave è gli utenti rilevati da USMT nell'archivio di cui è possibile eseguire la migrazione.
includedInMigration	Definisce se il profilo utente/componente è incluso per la migrazione. I valori validi sono Sì o No.
forUser	Specifica uno dei valori seguenti: Stato utente di cui viene eseguita la migrazione. Questo computer, ovvero file e impostazioni non associati a un utente.
detectedComponent	Specifica un componente rilevato da USMT. Per ScanState, questa chiave è un componente o un'applicazione installata nel computer di origine. Per LoadState, questa chiave è un componente o un'applicazione rilevata nell'archivio.
totalSizeInMBToTransfer	Dimensioni totali dei file e delle impostazioni di cui eseguire la migrazione in megabyte (MB).
totalPercentageCompleted	Percentuale totale della migrazione completata da ScanState o LoadState.
collectingUser	Specifica l'utente per cui ScanState raccoglie file e impostazioni.
totalMinutesRemaining	Stima del tempo, in minuti, per il completamento della migrazione.
errore	Tipo di errore non irreversibile che si è verificato. Questa chiave può essere uno dei valori seguenti: UnableToCopy: impossibile copiare l'archivio perché il disco in cui si trova l'archivio è pieno. UnableToOpen: impossibile aprire il file per la migrazione perché in un'altra applicazione o servizio il file è aperto in modalità non condivisa. UnableToCopyCatalog: impossibile copiare perché l'archivio è danneggiato. UnableToAccessDevice: non è possibile accedere al dispositivo. UnableToApply: impossibile applicare l'impostazione al computer di destinazione.
objectName	Nome del file o dell'impostazione che ha causato l'errore non irreversibile.
azione	Azione eseguita da USMT per l'errore non irreversibile. I valori sono: Ignora: l'errore non irreversibile è stato ignorato e la migrazione è continuata perché è stata specificata l'opzione /c nella riga di comando. Interruzione: la migrazione è stata interrotta perché l'opzione /c non è stata specificata.
errorCode	Valore errorCode o restituito.
numberOfIgnoredErrors	Numero totale di errori non irreversibili ignorati da USMT.
Messaggio*	Messaggio corrispondente a errorCode.

Registro dei file di elenco

Il log Dei file di elenco (Listfiles.txt) fornisce un elenco dei file di cui è stata eseguita la migrazione. Questo elenco può essere usato per risolvere i problemi XML o può essere conservato come record dei file raccolti nell'archivio di migrazione. Il log dei file di elenco è disponibile solo per ScanState.exe.

Log di diagnostica

È possibile ottenere il log di diagnostica impostando la variabile di ambiente MIG_ENABLE_DIAG su un percorso di un file XML.

Il log di diagnostica contiene:

Informazioni dettagliate sull'ambiente di sistema.
Informazioni dettagliate sull'ambiente utente.
Informazioni sulle unità di migrazione (migunits) raccolte e sul relativo contenuto.

Uso del log di diagnostica

Il log di diagnostica è essenzialmente un report di tutte le unità di migrazione (migunits) incluse nella migrazione. Una migunit è una raccolta di dati. Nei file XML il componente identifica la migunit a cui è associata la migunit. L'archivio di migrazione è costituito da tutti i migunits nella migrazione. Il log di diagnostica può essere usato per verificare quali migunits sono stati inclusi nella migrazione e possono essere usati per la risoluzione dei problemi durante la creazione di file XML di migrazione.

Gli esempi seguenti descrivono scenari comuni in cui è possibile usare il log di diagnostica.

Perché non viene eseguita la migrazione di questo file quando è stata creata una regola di "inclusione"?

Si supponga di avere la struttura di directory seguente e di voler includere la directory dei dati nella migrazione insieme al file New Text Document.txt nella nuova cartella. La directory di C:\data contiene:

12/21/2023  01:08 PM    <DIR>          .
12/21/2023  01:08 PM    <DIR>          ..
12/21/2023  01:08 PM    <DIR>          New Folder
12/21/2023  01:19 PM                13 test (1).txt
12/21/2023  01:19 PM                13 test.txt
               2 File(s)             26 bytes

La directory di C:\data\New Folder contiene:

12/21/2023  01:08 PM    <DIR>          .
12/21/2023  01:08 PM    <DIR>          ..
12/21/2023  01:08 PM                 0 New Text Document.txt
               1 File(s)              0 bytes

Per eseguire la migrazione di questi file, viene creato il codice XML di migrazione seguente:

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://www.microsoft.com/migration/1.0/TestSuite_BUGFIX">

<component context="System"  type="Application">
  <displayName>DATA1</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <pattern type="File">c:\data\ [*]</pattern>
        </objectSet>
      </include>

    </rules>
  </role>
</component>
</migration>

Tuttavia, durante il test della migrazione, il file New Text Document.txt viene notato che non è stato incluso nella migrazione. Per risolvere questo errore, la migrazione può essere ripetuta con la variabile di ambiente MIG_ENABLE_DIAG impostata in modo che venga generato il log di diagnostica. La ricerca del componente DATA1 nel log di diagnostica mostra la sezione XML seguente:

<MigUnitList>
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
    <Patterns Type="Include">
      <Pattern Type="File" Path="C:\data [*]"/>
    </Patterns>
  </MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)">
    <Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test (1).txt]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test.txt]" SimObj="false" Success="true"/>
  </MigUnit>
</Perform>

L'analisi di questa sezione XML mostra la migunit creata durante l'elaborazione della regola di migrazione. La <sezione Esegui> descrive in dettaglio i file effettivi pianificati per la raccolta e il risultato dell'operazione di raccolta. Il file New Text Document.txt non viene visualizzato in questa sezione, che conferma che la regola di migrazione non è stata creata correttamente.

Un'analisi dell'articolo di riferimento sulla libreria di elementi XML rivela che il <tag del modello> deve essere modificato come segue:

<pattern type="File">c:\data\* [*]</pattern>

Quando la migrazione viene eseguita di nuovo con il tag modificato, il log di diagnostica visualizza le informazioni seguenti:

<MigUnitList>
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
    <Patterns Type="Include">
      <Pattern Type="File" Path="C:\data\* [*]"/>
    </Patterns>
  </MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)">
    <Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test (1).txt]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test.txt]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder [New Text Document.txt]" SimObj="false" Success="true"/>
  </MigUnit>
</Perform>

Questo log di diagnostica conferma che il valore del modello> modificato< consente la migrazione del file.

Perché viene eseguita la migrazione di questo file quando è stata creata una regola di esclusione escludendola?

In questo scenario esiste la struttura di directory seguente e tutti i file nella directory Dati devono essere migrati, ad eccezione dei file di testo. La C:\Data cartella contiene:

Directory of C:\Data

12/21/2023  01:08 PM    <DIR>          .
12/21/2023  01:08 PM    <DIR>          ..
12/21/2023  01:08 PM    <DIR>          New Folder
12/21/2023  01:19 PM                13 test (1).txt
12/21/2023  01:19 PM                13 test.txt
               2 File(s)             26 bytes

Contiene C:\Data\New Folder\ :

12/21/2023  01:08 PM    <DIR>          .
12/21/2023  01:08 PM    <DIR>          ..
12/21/2023  01:08 PM                 0 New Text Document.txt
               1 File(s)              0 bytes

Viene creato il codice XML di migrazione seguente:

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://www.microsoft.com/migration/1.0/TestSuite_BUGFIX">

<component context="System"  type="Application">
  <displayName>DATA1</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <pattern type="File">c:\data\* [*]</pattern>
        </objectSet>
      </include>
    </rules>
    <rules>
      <exclude>
        <objectSet>
          <pattern type="File">c:\* [*.txt]</pattern>
        </objectSet>
      </exclude>

    </rules>
  </role>
</component>

Tuttavia, al momento del test della migrazione, tutti i file di testo vengono notati che sono ancora inclusi nella migrazione. Per risolvere questo problema, la migrazione può essere eseguita con la variabile di ambiente MIG_ENABLE_DIAG impostata in modo da generare il log di diagnostica. La ricerca del componente DATA1 nel log di diagnostica mostra la sezione XML seguente:

<MigUnitList>
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
    <Patterns Type="Include">
      <Pattern Type="File" Path="C:\data\* [*]"/>
    </Patterns>
    <Patterns Type="Exclude">
      <Pattern Type="File" Path="C:\* [*.txt]"/>
    </Patterns>
  </MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)">
    <Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test (1).txt]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test.docx]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test.txt]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder [New Text Document.txt]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder [test.docx]" SimObj="false" Success="true"/>
  </MigUnit>
</Perform>

Quando il log di diagnostica viene esaminato, la migrazione dei file viene ancora confermata e si tratta di un problema con la regola XML di migrazione creata. Un aggiornamento viene creato nello script XML di migrazione come indicato di seguito:

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://www.microsoft.com/migration/1.0/TestSuite_BUGFIX">

<component context="System"  type="Application">
  <displayName>DATA1</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <pattern type="File">c:\data\* [*]</pattern>
        </objectSet>
      </include>
    </rules>
    <rules>
      <exclude>
        <objectSet>
          <pattern type="File">c:\data\* [*.txt]</pattern>
        </objectSet>
      </exclude>

    </rules>
  </role>
</component>


</migration>

Lo script XML di migrazione modificato esclude la migrazione dei file, come confermato nel log di diagnostica:

<MigUnitList>
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
    <Patterns Type="Include">
      <Pattern Type="File" Path="C:\data\* [*]"/>
    </Patterns>
    <Patterns Type="Exclude">
      <Pattern Type="File" Path="C:\data\* [*.txt]"/>
    </Patterns>
  </MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
  <MigUnit Name="\<System\>\DATA1 (CMXEAgent)">
    <Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data [test.docx]" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder" SimObj="false" Success="true"/>
    <Operation Name="Store" Type="File" Path="C:\data\New Folder [test.docx]" SimObj="false" Success="true"/>
  </MigUnit>
</Perform>

Condividi tramite

File di log USMT

Opzioni della riga di comando log

Log di ScanState e LoadState

Log di avanzamento

Registro dei file di elenco

Log di diagnostica

Uso del log di diagnostica

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

File di log USMT

Opzioni della riga di comando log

Log di ScanState e LoadState

Log di avanzamento

Registro dei file di elenco

Log di diagnostica

Uso del log di diagnostica

Articoli correlati

Commenti e suggerimenti

Risorse aggiuntive