Condividi tramite

Informazioni di riferimento su ResetConfig XML

  • Articolo

Questo riferimento descrive tutti gli elementi XML usati per creare il file ResetConfig.xml, usato per configurare le funzionalità di reimpostazione del pulsante push-button dell'ambiente di ripristino di Windows.

ResetConfig XML

Ecco un ResetConfig.xml vuoto che è possibile usare come punto di partenza:

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <SystemDisk>
   <MinSize></MinSize>
   <DiskpartScriptPath> </DiskpartScriptPath>
   <OSPartition></OSPartition>
   <RestoreFromIndex></RestoreFromIndex>
   <WindowsREPartition></WindowsREPartition>
   <WindowsREPath></WindowsREPath>
   <Compact></Compact>
 </SystemDisk>
</Reset>

Reset

L'elemento Reset XML può contenere gli elementi: <Run> e <SystemDisk>.

Esegui

L'elemento <Run> XML viene usato per aggiungere script personalizzati alle funzionalità di reimpostazione del pulsante push.

È possibile specificare fino a quattro Run elementi in un singolo file di ResetConfig.xml. Ogni Run elemento deve contenere un valore diverso [ExtPoint] per il relativo Phase attributo.

La tabella seguente descrive gli elementi validi che possono essere aggiunti all'elemento Run :

Elemento Descrizione

Run Phase="[ExtPoint]""

Ogni Run elemento definisce il punto di estendibilità da usare, lo script eseguito in quel punto di estendibilità e la durata stimata in minuti.

L'attributo Phase è obbligatorio. Accetta solo i valori seguenti per [ExtPoint]:

  • BasicReset_BeforeImageApply. Esegue il programma specificato al punto di estendibilità A.

  • BasicReset_AfterImageApply. Esegue il programma specificato al punto di estendibilità B

  • FactoryReset_AfterDiskFormat. Esegue il programma specificato al punto di estendibilità C

  • FactoryReset_AfterImageApply. Esegue il programma specificato al punto di estendibilità D

È possibile specificare fino a quattro Run sezioni in un singolo file di ResetConfig.xml. Tuttavia, ogni Run sezione deve contenere un valore diverso per l'attributo phase.

Path

Specifica il percorso dello script per una sezione specifica Run .

Il percorso deve essere il percorso relativo dello script dalla cartella che contiene ResetConfig.xml (in genere si tratta di C:\Recovery\OEM).

Duration

Specifica il tempo stimato, in minuti, che si prevede che lo script personalizzato venga eseguito. Questa stima viene usata per visualizzare le informazioni sullo stato di avanzamento nella GUI.

La durata deve essere un intero e deve essere compreso tra 1 e 5.

Param

Specifica i parametri della riga di comando da usare quando si esegue lo script personalizzato o il file eseguibile. Il valore viene considerato come stringa e può contenere più parametri.

Param non supporta elementi vuoti. Se lo script non richiede parametri, non includere questo elemento. Per esempi, vedere Uso di ResetConfig.xml più avanti in questo argomento.

SystemDisk

L'elemento SystemDisk personalizza la funzionalità di ripristino bare metal. Per altre informazioni, vedere Creare supporti per eseguire Push-Button Reimposta funzionalità.

È possibile specificare una <SystemDisk> sezione. Ecco gli elementi obbligatori e facoltativi:

Elemento Descrizione
MinSize

Obbligatorio. Specifica le dimensioni minime necessarie per il disco rigido primario, in megabyte.

Il ripristino bare metal non procederà se il disco di sistema non soddisfa questo requisito di dimensione.

DiskpartScriptPath

Obbligatorio. Percorso dello script Diskpart relativo a C:\Recovery\OEM. Lo script presuppone che tutte le partizioni esistenti siano state eliminate e che il disco di sistema sia attivo in Diskpart.

Ad esempio, se gli script di ripristino si trovano in C:\Recovery\OEM\Scripts\RecreatePartitions.dps, usare il valore \Scripts\RecreatePartitions.dps.

OSPartition

Obbligatorio. Partizione a cui deve essere ripristinato il sistema operativo. La partizione ESP o attiva deve trovarsi nello stesso disco del sistema operativo.

WindowsREPartition

Obbligatorio. Specifica la partizione in cui è installata l'immagine di avvio re di Windows.

WindowsREPath

Obbligatorio. Specifica il percorso della cartella in cui viene copiata l'immagine di avvio Winre.wim, rispetto alla radice della partizione specificata nell'elemento WindowsREPartition .

RestoreFromIndex

Facoltativa. Indice dell'immagine all'interno di install.wim da applicare durante il ripristino bare metal. Questo elemento è facoltativo ed è necessario solo nei supporti di ripristino creati dal produttore

Compact

Facoltativa. Specifica se l'immagine di ripristino deve essere applicata con la compressione per file abilitata. Questo elemento è facoltativo ed è necessario solo nei supporti di ripristino creati dal produttore.

Compact accetta i valori seguenti:

  • True: i file applicati dall'immagine vengono compressi singolarmente.
  • False (valore predefinito): la compressione non viene usata.

RecoveryImagePartition

Questa impostazione è deprecata in Windows 10.

RecoveryImagePath

Questa impostazione è deprecata in Windows 10.

RecoveryImageIndex

Questa impostazione è deprecata in Windows 10.

WIMBoot

Questa impostazione è deprecata in Windows 10.

Uso di ResetConfig.xml

Se si usa un editor di testo per creare i file di .xml, è necessario salvare il documento con un'estensione .xml nome file e usare la codifica UTF-8. Non usare ANSI o qualsiasi altra codifica.

Questi file devono essere inseriti nella cartella C:\Recovery\OEM in modo che possano essere rilevati automaticamente dalle funzionalità di reimpostazione del pulsante push.

Esempio

Si tratta di un esempio di codice per il file di ResetConfig.xml.

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path>Fabrikam\CopyFiles.cmd</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path>Fabrikam\FixPartitions.exe</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <SystemDisk>
   <MinSize>75000</MinSize>
   <DiskpartScriptPath>Fabrikam\CreatePartition.txt </DiskpartScriptPath>
   <OSPartition>4</OSPartition>
   <RestoreFromIndex>2</RestoreFromIndex>
   <WindowsREPartition>1</WindowsREPartition>
   <WindowsREPath>Recovery\WindowsRE</WindowsREPath>
   <Compact>False</Compact>
 </SystemDisk>
</Reset>

Panoramica della reimpostazione pulsante

Creare supporti per eseguire Push-Button reimpostazione delle funzionalità